NumSnake - connect the numbers
==============================

A grid, a handful of numbered dots, and one line: start at 1 and draw a
single continuous path through 2, 3, 4 ... in order. The clock runs from
the first move, and the best results are kept in a highscore list.

Two modes:

  Connect   the line only has to pass through the numbers in order;
            cells may be left empty. The default, and a quick game.

  Fill      the line must pass through the numbers in order AND cover
            every cell of the grid exactly once. Much harder.

Every puzzle is generated on the spot and always has a solution. Grids go
from 2x2 to 16x16 with as many numbers as you like; the same seed always
gives the same puzzle, so a friend can play yours.


Playing
-------

Drag with the left mouse button from cell to cell, or use the cursor
keys. Step back by moving onto the previous cell or with Backspace. The
toolbar starts a new game, pauses the clock or restarts the same puzzle.


Settings
--------

Grid width and height, the number of numbers, the mode, the seed and your
name for the highscore list. Set them in the Preferences window (Save
writes them into the icon), as tool types, or on the Shell:

  NumSnake 8 8 10 connect 42
  NumSnake WIDTH=8 HEIGHT=8 NUMBERS=10 MODE=fill NAME=Anna

A value that is not valid is refused with a message saying what is
allowed; from the icon it is replaced by its default and you are told
which one.


Requirements
------------

MorphOS 3.x. The highscore list uses sqlite.library and the
toolbar pictures use Reggae, both part of MorphOS; without them the game
still runs.


Installation
------------

Unpack the archive anywhere and double-click NumSnake. Keep the Icons
drawer next to the program. Docs/Readme.md has the full manual.


Changes in 1.1
--------------

* The program icon is a real MorphOS icon with tool types; Preferences ->
  Save no longer replaces it with a blank one.
* Shell arguments and tool types are checked; NumSnake 8 8 10 connect 42
  works as documented.
* The highscore window has a chooser for every grid size, count of numbers
  and mode you have played, smallest first; it opens on the current one.
* About MUI... opens the MUI About window.
* Fixed a possible hang on the very first start, while the highscore file
  was created and the network stack was still busy (seen under emulation).
* No more crash when the program exits.


Development assisted by GenAI.

Freely distributable. (C) 2026 Markus Lunk.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxrwxrwx  1000/1000        0       0 ****** -lhd- 0000 Sep 25 21:31 NumSnake/
drwxrwxrwx  1000/1000        0       0 ****** -lhd- 0000 Sep 25 21:31 NumSnake/Docs/
-rw-r--r--  1000/1000     2185    5114  42.7% -lh5- 2b3a Sep 25 21:31 NumSnake/Docs/Readme.md
-rw-r--r--  1000/1000      706    1678  42.1% -lh5- ce21 Sep 25 21:31 NumSnake/Docs.info
drwxrwxrwx  1000/1000        0       0 ****** -lhd- 0000 Sep 25 21:31 NumSnake/Icons/
-rw-r--r--  1000/1000     9874    9874 100.0% -lh0- c5f0 Sep 25 21:31 NumSnake/Icons/NumSnake.png
-rw-r--r--  1000/1000     2204    2204 100.0% -lh0- 3dce Sep 25 21:31 NumSnake/Icons/new.png
-rw-r--r--  1000/1000     1736    1736 100.0% -lh0- c986 Sep 25 21:31 NumSnake/Icons/pause.png
-rw-r--r--  1000/1000     1794    1794 100.0% -lh0- 902d Sep 25 21:31 NumSnake/Icons/play.png
-rw-r--r--  1000/1000     1971    1971 100.0% -lh0- c15f Sep 25 21:31 NumSnake/Icons/record.png
-rw-r--r--  1000/1000     2104    2104 100.0% -lh0- 80df Sep 25 21:31 NumSnake/Icons/restart.png
-rw-r--r--  1000/1000      706    1678  42.1% -lh5- ce21 Sep 25 21:31 NumSnake/Icons.info
-rwxr-xr-x  1000/1000    45745   95044  48.1% -lh5- 7aba Sep 25 21:31 NumSnake/NumSnake
-rw-r--r--  1000/1000     9969    9969 100.0% -lh0- 7373 Sep 25 21:31 NumSnake/NumSnake.info
-rw-r--r--  1000/1000     1377    2745  50.2% -lh5- 6c5e Sep 25 21:31 NumSnake/NumSnake.readme
-rw-r--r--  1000/1000      706    1678  42.1% -lh5- ce21 Sep 25 21:31 NumSnake.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        16 files   81077  137589  58.9%            Sep 26 00:26