11 releases
new 0.1.10 | Mar 22, 2025 |
---|---|
0.1.9 | Mar 22, 2025 |
#129 in #game
110 downloads per month
240KB
4K
SLoC
Rustydoku
Rustydoku is a game based on Woodoku on the classic puzzle genre developed in Rust. It combines the gameplay of Woodoku with a modern design and fast performance for Rustaceans)
Table of Contents
Overview
Rustydoku is a modern puzzle game where your goal is to score as many points as possible by strategically placing figures on a 9x9 grid. Clear cells by creating specific combinations and enjoy the challenge as the board gradually fills up.
How to Play
Objective
-
Grid Setup:
When the game starts, a 9x9 grid is generated. At the beginning, the grid is mostly empty—but you’ll notice that in a chessboard-like pattern, 3x3 blocks of Ferris appear, and that's intentional! -
Scoring Combinations:
You have two options to clear space and earn points:-
Complete a 3x3 Block:
Fill an entire 3x3 block with Ferris. -
Complete a Full Row or Column:
Fill an entire row/column (9 cells) with Ferris.
Completing either combination will free up the occupied cells and award you 9 points.
-
-
Winning:
There is no defined “win” — the aim is to accumulate as many points as possible.
Controls
-
Start Game:
The game starts automatically when you runcargo run
. -
Move Pieces:
Use your mouse (or your finger on touch devices) to drag and place the pieces. -
Restart:
Click the restart button at the top-right corner of the screen. If you lose, you can also restart the game from the Game Over panel. -
Mute Audio:
Click the audio button at the top-right corner to toggle sound on or off. If you lose, you can also mute audio from the Game Over panel.
Installation
Running via GitHub
-
Clone the repository:
git clone https://github.com/brizzinck/rustydoku.git cd rustydoku
-
Build and run the project:
cargo run --release
-
Enjoy the game!
FAQ
- For Linux Users:
- What do if i can't run?
Ensure you have the latest Vulkan or OpenGL libraries installed. If you encounter performance issues, update your GPU drivers. Running the game from a terminal may provide useful logs if troubleshooting is needed.
- What do if i can't run?
Contributing
I welcome contributions to improve Rustydoku! If you’d like to contribute:
-
Create a new branch:
git checkout -b features/your-features
-
Commit your changes and submit a Pull Request.
License
Rustydoku is licensed under the MIT License. See the LICENSE file for more information.
Created with passion for Rustaceans
Dependencies
~28–69MB
~1M SLoC