Sign in

README.md

At 65bd8a6

65bd8a6History

Preview

Text · 2.4 KiB

Hollow Snake

A customizable Halloween Snake game. Source and assets are versioned with Uno Kits; no Git repository is required.

Play

Run npm start, then open http://127.0.0.1:4173. Python 3 is required for the local server. No package installation or build step is needed. Any static host can serve this directory.

Use arrows, WASD, swipes, or the on-screen arrows. Space or P pauses the game. Collect bright pink potions. Avoid the walls, your tail, ghosts, pumpkins, and candles. Each potion gives 10 points. Speed increases every five potions.

The Settings button opens controls for difficulty, obstacle types, snake color, and mist. Difficulty and obstacle changes apply to the next run. Color and mist apply immediately. Music starts off. The music switch enables the bundled looping track; volume is adjustable. Leaving the tab pauses play and audio. Returning keeps play paused and resumes enabled audio when allowed. Personal bests are stored per difficulty and obstacle selection in browser storage. The game remains playable when browser storage is unavailable.

Customize

  • engine.js: grid size, obstacle coordinates, collision rules, speed, and scoring.
  • app.js: controls, rendering, audio, and local preferences.
  • style.css: colors, castle atmosphere, layout, and reduced-motion support.
  • index.html: interface and instructions.

Canvas art uses vector paths and renders at the screen pixel density. It resizes with the board. The interface uses the system font with no external font requests. The core game and bundled audio work without third-party services.

Verify

Run npm test with Node.js 18 or newer. Tests cover collision rules, input buffering, food placement, growth, pause, and victory.

Uno Kits

Repository: https://uno.fun/kits/01a11d16-d108-768a-a391-8ee5c9e216b0/hollow-snake Branch: main.

For updates, read the current branch ref and start a fresh upload session. Stage changed files, then commit using the current ref as the expected head. Keep request idempotency keys on uncertain retries. Confirm staging completion before committing. Poll the commit job until completion, then verify the new branch ref.

The repository includes all source files, tests, and the bundled CC0 music. Uno stores and versions these files. Run a local server or use a static host to play.

Credits

See CREDITS.md for the bundled music source and CC0 license.

Files