Description:
bansoko 1.2.1
Bansoko is a reimagined, space-themed 🚀 clone of MS-DOS Soko-Ban from 1984 created in Python using Pyxel.
You can download :package: for both Windows and Linux from:
📖 Introduction
Welcome to Bansoko!
You are a scavenger. You collect cargo that people have left in abandoned ships in deep space.
It's a dangerous job, that's why we're using robots.
Your goal is to use a remotely controlled robot to push all crates to cargo bays.
Remember, you can only push them (you cannot pull)
Fortunately, in case of a mistake, you can undo as many steps as you need.
Good luck!
🎮 Installation
Windows
Install Python (version 3.8 or higher) and make sure that python is added to PATH.
Install Bansoko by running:
pip install -U bansoko
Run the game:
bansoko
Linux
Install python3 (version 3.8 or higher), python3-pip and required SDL2 libraries (libsdl2-2.0-0 and libsdl2-image-2.0-0).
On Ubuntu, this can be done by running:
sudo apt install python3 python3-pip libsdl2-2.0-0 libsdl2-image-2.0-0
Install Bansoko by running:
pip3 install -U bansoko
Run the game:
bansoko
💻 Development setup
1. Install prerequisites
Windows
Install 32-bit Python (version 3.8 or higher) and make sure that python is added to PATH.
Additionally, install pipenv for managing virtual environments and project dependencies:
pip install pipenv
Linux
Install python3 (version 3.8 or higher), python3-pip, pipenv and required SDL2 libraries (libsdl2-2.0-0 and libsdl2-image-2.0-0).
On Ubuntu, this can be done by running:
sudo apt install python3 python3-pip pipenv libsdl2-2.0-0 libsdl2-image-2.0-0
2. Set up the project
Clone the repository:
git clone https://github.com/kfurtak1024/bansoko
Navigate to the directory Bansoko was cloned to.
Create virtual environment to isolate development:
pipenv shell
Install all dependencies needed for development:
pipenv install --dev
3. Run the game
Run Bansoko from virtual environment created in the previous step:
Windows
python -m bansoko
Linux
python3 -m bansoko
🧰 Modding
Bansoko is heavily modifiable thanks to included resource builder. More information on how to 'mod' it can be found on Bansoko modding page.
🤝 How to contribute
Submitting an issue
Use the issue tracker to submit bug reports and feature/enhancement requests.
When submitting a report, please select the appropriate template.
Submitting a 'mod'
If you have created a modification for Bansoko which you would like to publish then please contact me via contact@krzysztoffurtak.dev
⚖️ License
This project is licensed under the MIT License - see the LICENSE.md file for details.
Copyright © 2020-2024 Krzysztof Furtak
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Customer Reviews
There are no reviews.
