125 lines
5.2 KiB
Markdown
125 lines
5.2 KiB
Markdown
# DMGTRIS
|
|
DMGTRIS is a block stacking game for the original game boy written in assembly.
|
|
|
|
The game is heavily inspired by the TGM series of games and has the following features:
|
|
- TLS (ghost piece) until 1G speeds.
|
|
- IRS (initial rotation system).
|
|
- IHS (initial hold system) as well as holds.
|
|
- Faithful implementations of concepts such are lock delay, piece spawn delay and DAS.
|
|
- Several RNG options available. You can choose between pure RNG, 4 history with 4 retries, 4 history with 6 retries, 4 history with infinite retries, a 35bag with 4 history and 6 retries with drought prevention, NES style RNG, or pure RNG.
|
|
- A choice between sonic drop (pressing up grounds the piece but does not lock it), hard drop (pressing up locks the piece), or neither (pressing up does nothing at all.)
|
|
- A choice between traditional ARS for rotation, or TGM3 era ARS with extra kicks.
|
|
- Scoring is a hybrid between TGM1 and TGM2.
|
|
- A speed curve reminiscent of TGM, starting slightly faster and skipping the awkward speed reset. The game continues infinitely... But so does the speed increase.
|
|
- A rock solid 60FPS with a traditional 20x10 grid.
|
|
- Game boy color mode.
|
|
|
|
## Playing
|
|
Try the game online [here](https://villadelfia.org/dmgtris/). Controls are arrow keys, Z, X, Space, and Enter. The online version has no sound though, so the better thing would be to run it in an emulator locally.
|
|
|
|
You can build the game yourself, or use the binary [here](https://git.villadelfia.org/villadelfia/dmgtris/raw/branch/master/bin/DMGTRIS.GBC) or [here](https://github.com/Villadelfia/DMGTRIS/raw/master/bin/DMGTRIS.GBC).
|
|
|
|
The game should run in any accurate emulator. For Windows or Linux using Wine [bgb](https://bgb.bircd.org/) is generally regarded as the best option. For macOS [SameBoy](https://sameboy.github.io/) comes recommended.
|
|
|
|
Please do not try running it on older emulators such as VBA, since this game uses the semi-randomness of the initial game boy memory as one source of RNG entropy.
|
|
|
|
|
|
## Options
|
|
### Buttons
|
|
Switch between whether A or B rotates clockwise and vice versa.
|
|
|
|
### RNG Mode
|
|
Choose between a few randomizer options:
|
|
- TGM1: 4 history, 4 rerolls.
|
|
- TGM2: 4 history, 6 rerolls.
|
|
- TGM3: The TGM3 RNG system.
|
|
- HELL: Pure Random.
|
|
- NES: Reroll once if you get the same piece as the previous one.
|
|
|
|
### Rot Mode
|
|
Select the rotation rules:
|
|
- ARS1: Classic ARS from TGM1 and TGM2.
|
|
- ARS2: ARS from TGM3.
|
|
|
|
### Drop Mode
|
|
Select whether up performs a sonic drop, a hard drop, or nothing at all.
|
|
|
|
### Speed Curve
|
|
Select between several speed curves including the DMGTRIS default speed curve, TGM1, TGM3, as well as DEATH and SHIRASE mode. In addition there's a "CHILL" curve for when you just want to enjoy some tetris. It doesn't speed up very fast at all.
|
|
|
|
Note that all modes use the same scoring and they are all infinite.
|
|
|
|
### Always 20G
|
|
Whether you want instant-drop gravity to be active at any level.
|
|
|
|
### Start Level
|
|
Choose any of the speed breakpoints to start the game at.
|
|
|
|
|
|
## Scoring
|
|
After each piece is dropped, a check is made:
|
|
|
|
### No line clear
|
|
Combo is reset to 1 and no points are awarded.
|
|
|
|
### Lines were cleared
|
|
Lines = Lines cleared.
|
|
|
|
Level = The level before the lines were cleared.
|
|
|
|
Soft = Amount of frames the down button was held during this piece + 10 if the piece was sonic or hard dropped.
|
|
|
|
Combo = Old combo + (2 x Lines) - 2
|
|
|
|
Bravo = 1 if the field isn't empty, 4 if it is.
|
|
|
|
ScoreIncrement = ((Level + Lines) >> 4 + 1 + Soft) x Combo x Lines x Bravo.
|
|
|
|
ScoreIncrement points are then awarded.
|
|
|
|
|
|
## Controls
|
|
### Menu
|
|
- A/B/Start — Start the game
|
|
- Up/Down — Change which option is selected
|
|
- Left/Right — Change the value of the option
|
|
|
|
### Gameplay
|
|
- A — Rotate 1
|
|
- B — Rotate 2
|
|
- Select — Hold
|
|
- Start — Pause
|
|
- Up — Sonic/Hard drop
|
|
- Down — Soft drop/Lock
|
|
- Left/Right — Move
|
|
|
|
### Game Over
|
|
- A — Restart immediately
|
|
- B — Go back to title
|
|
|
|
|
|
## Building and Development
|
|
The game can be built using gnu make and the RGBDS toolchain.
|
|
|
|
A few guidelines are in effect:
|
|
- If you add a bank, please add a section to `bankid.asm` and follow the existing format.
|
|
- If your code breaks existing save data, please update `SAVE_MAGIC_X` in `globals.asm`. This only needs to be done if existing save data would be completely incompatible.
|
|
- If you wish to save integer ID's they can be added to SRAM in `InitializeSRAM` and `RestoreSRAM`. However if you're saving a memory address, you should use `PartiallyInitializeSRAM` rather than `InitializeSRAM` so that it gets invalidated on every build.
|
|
|
|
|
|
## License
|
|
Copyright (C) 2023 - Randy Thiemann <randy.thiemann@gmail.com>
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|