https://github.com/amari-calipso/papers-please-tasbot

A "Papers, Please" TASbot that offers a programmable interface with the game
https://github.com/amari-calipso/papers-please-tasbot

cython game-bot games image-processing numpy papers-please papersplease python python3 tas tool-assisted-speedrun

Last synced: 3 days ago
JSON representation

A "Papers, Please" TASbot that offers a programmable interface with the game

• Host: GitHub
• URL: https://github.com/amari-calipso/papers-please-tasbot
• Owner: amari-calipso
• License: mit
• Created: 2024-04-06T14:24:47.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-12-08T20:15:28.000Z (14 days ago)
• Last Synced: 2024-12-08T21:29:42.526Z (14 days ago)
• Topics: cython, game-bot, games, image-processing, numpy, papers-please, papersplease, python, python3, tas, tool-assisted-speedrun
• Language: Python
• Homepage:
• Size: 20 MB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# "Papers, Please" TASbot

A "Papers, Please" TASbot that offers a programmable interface with the game.

Huge thanks to HowToCantaloupe for helping throughout the development process, giving ideas, as well as offering information about the how the game is actually built, and, in general, providing a lot of knowledge about the game!

# Usage

Requires Python 3.11+ and the dependencies listed in `requirements.txt`. Run `main.py` to start the bot.

Run `build.py` to build an optimized version of the text recognition system, written in Cython. 

To build releases, pass the `--release` argument to `build.py`.

Note that using `build.py` requires the dependencies listed in `build_requirements.txt`

NOTE: For the bot to properly work:

- The game language must be English;

- The date format must be 1982-1-23;

- The game must be windowed;

- The window must be default resolution;

- The window must not be too close to the sides of the screen (~30-40px at most);

- If not running on Windows:

    - Every run should be started from the main menu screen, with every part of the window clearly visible;

    - The window cannot be moved from the position it was when the run was started.

This bot is currently only tested for Papers Please v1.1.67-S. it will NOT work for the latest version of the game.