kodiak/README.md

73 lines
2.0 KiB
Markdown

# kodiak
*Kodiak* is an implementation of [Klondike Solitaire](https://en.wikipedia.org/wiki/Klondike_(solitaire)) for the[Uxn/Varvara ecosystem](https://100r.co/site/uxn.html) virtual machine.
![screenshot of initial solitaire deal](start.png)
## details
Currently *Kodiak* is very limited:
- Can't move cards from the foundation
- Must manually move every card
- No undo functionality
- No scoring or timing
- No music or animations
- No splash screen
- No buttons to restart or quit
Future releases may relax some or all of these constraints.
![screenshot of solitarire mid-game](game1.png)
## building and running
Building the Kodiak ROM requires a Uxn assembler:
```
$ uxnasm kodiak.tal kodiak.rom
Assembled kodiak.rom in 10923 bytes(16.73% used), 253 labels, 0 macros.
```
Running the Kodiak ROM requires an emulator. For example:
```
$ uxnemu kodiak.rom
```
## infrequently-asked questions
**Is dragging cards buggy?**
You don't need to hold down the mouse button when dragging a card.
Just click once to pick up and click again to release.
**Is this harder than other solitaire games?**
Probably, yes. In addition to not having an "undo" feature, Kodiak
does not check to see if a solitaire deal is winnable or not, meaning
that some games would probably be impossible to win no matter how you
played them.
**Can I make the game bigger?**
Many emulators support a zoom option. For example, `uxnemu` and
`uxn11` both use the F1 key to toggle zoom levels.
The game size is intentionally small to support older platforms with
lower screen resolution, such as the Nintendo DS.
**I won the game and the cards didn't bounce!**
That isn't a question. (Also, sorry!)
**Will you add support for my preferred solitaire variant?**
Probably not, but maybe.
I am considering adding support for [Sawayama Solitaire](https://zachtronics.fandom.com/wiki/Sawayama_Solitaire). Depending on how that goes I may add support for other variants as well.
![another screenshot of solitaire](game2.png)
Kodiak was built by [d_m](http://plastic-idolatry.com/erik), 2023-2024