trampinheavy@web:~$ less projects/shcuffle/readme.md
>_ shcuffle
//stub
from the readme
Each run begins by having the player draw seven cards. You may mulligan by choosing any number of those cards to return to the deck. You will draw that many cards and then the run will begin.
To play, you will select a card of yours to play and choose how to play it using the keyboard. You can move the cursor using h, j, k, and l as left, down, up, and right respectively. On a related note, this project was written entirely in neovim (btw)!
You can add a card from your hand to your mana pool once per turn. You can also play cards to the field or as spells. You tap mana equal to the cost of the card you want to play to play a card, but your mana is untapped (reset) every turn. That means that if you have 5 mana and play a 3 of Spades, you couldn't play any other card with a cost higher than 2. However, on your next turn the 3 mana you spent will be untapped and you will be able to use all 5 mana again - 6 if you play another card to your mana pool.
Cards on the field can attack other cards, including players. You can only target tapped cards and players to attack. When one card attacks another card on the battlefield, they both damage each other equal to their face value. A card's health is also equal to its face value. That means that combat can leave your cards weaker and exposed to attack. Attacking a player does not damage the attacking card.
Cards played as spells have a one time effect and are discarded, but only cost half of their face value(rounded up). For example, an 8 of Hearts would cost 4 to play as a spell and heal a card or player for 8 before being discarded. The effect of a spell is determined by it's value and suit. The value is how much of the spell's effect it does (eg an 8 of Hearts heals for 8). The effect is suit-based:
Spades: Damage chosen target equal to the value of the spell
Hearts: Heal chosen target equal to the value of the spell
Clubs: Buff chosen target equal to the value of the spell until next turn
Diamonds: Reduce the cost of the next spell you play this turn by the spell's valueWhile spell effects are generally powerful, they come at the cost of a card you could have played to the field and used multiple times.
A run ends when the player or their oppenent accrue 21 or more damage.
getting started
Begin by cloning this repository:
git clone https://codeberg.org/trampinheavy/Shcuffle.gitIn the repo directory, it is recommended that you initialize a virtual environment(venv)
uv venv --python 3.14 .venv source .venv/bin/activate python curses_ui.py