kodiak/README.md

# 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