Skip to content

Repository files navigation

NekoDash 🐾

A kawaii mobile puzzle game where every swipe is a purr-fectly planned slide.

NekoDash is a single-player, mobile-first, kawaii-themed 2.5D top-down puzzle game built with Godot 4.3. Navigate a cute cat through grid-based environments using "sliding movement": once you swipe, you slide until you hit a wall!

Your goal? Cover every single tile on the floor. It's like Pokémon's ice cave puzzles, but with the added challenge of 100% coverage and a mathematically optimal move counter to beat.

trailer.mp4

🎮 Gameplay Mechanics

  • Sliding Movement: Swipe to slide. You can't stop mid-grid. Plan your path using obstacles!
  • 100% Coverage: The level only ends when every walkable tile has been visited.
  • Star Rating System: Compare your moves against the BFS-computed minimum.
  • Special Tiles:
    • 💀 Kill Tiles: Reset the level on contact.
    • 🛑 Stop Tiles: Interrupt your slide mid-grid.
    • ➡️ One-Way Tiles: Restrict entry from specific directions.

Mechanics

🖼️ Screenshots

Screen Desktop Mobile
Main Menu
Level Selection
Gameplay
Level Complete
Skin Selection

🧩 Example Levels

The game features a gradual difficulty curve, starting with simple tutorials and progressing to complex grids with special tiles.

Tutorial Levels (Introduction) Special Tiles (Advanced)
Tutorial 1 Special 1
Tutorial 2 Special 2
Tutorial 3 Special 3

🌍 Four Themed Worlds

NekoDash features 36 levels across four distinct environments:

  • Bedroom: Soft, cozy wooden floors.
  • Kitchen: Minty clean tiles with appliances.
  • Living Room: Golden-hour light oak.
  • HKU Special: Outdoor campus theme inspired by the HKU Main Building.

🛠️ Technical Stack

  • Engine: Godot 4.3 (GDScript)
  • Art: Figma
  • Level Design: LLM-Assisted + Headless BFS Solver (GDScript/Python)
  • UI: Responsive Control nodes with Custom Theme
  • Audio: Centralized SFXLibrary with per-world BGM tracks

✨ Key Features

Original 2.5D Kawaii Art

Every asset in NekoDash is original work designed in Figma. The game features a consistent 2.5D orthographic-lite perspective with soft pastel colors, dark plum outlines, and rounded shapes.

BFS-Validated Level Generation

Designing 36 solvable and fun puzzles is tough! NekoDash uses a two-stage automated pipeline:

  1. LLM Proposers: Generate candidate layouts under strict constraints.
  2. Headless BFS Solver: Validates solvability and computes the optimal 3-star thresholds. Every level you play is mathematically guaranteed to be solvable and balanced.

Full Cross-Platform Support

Play on Android with intuitive touch swipes or on Desktop with WASD/Arrow keys. The UI is fully responsive and scales across all screen sizes.

🚀 Installation

Android

  1. Download the nekodash.apk from the latest release.
  2. Transfer the .apk file to your device.
  3. Enable "Install from Unknown Sources" in settings.
  4. Install and play!

Desktop (Windows)

  1. Download the NekoDash_Windows.zip from the latest release.
  2. Extract the ZIP folder.
  3. Ensure nekodash.exe and nekodash.pck are in the same folder.
  4. Run nekodash.exe.

Building from Source

  1. Install Godot 4.3 (Standard Build).
  2. Clone this repo: git clone https://github.com/gracetyy/nekodash.git.
  3. Import project.godot into Godot.
  4. Press F5 to run!

🐱 Easter Egg: Developer Mode

Want to unlock all levels and skins without any limitation?

  1. Go to the Option Menu.
  2. Rapidly tap the Cat Head above the purple ribbon 10 times.
  3. View the developer options at the end of the menu!

📜 Credits

Frameworks & Tools

Fonts

Music

Sound Effects

UI Assets


Developed with ❤︎⁠ as a solo project for COMP3329: Computer Game Design and Programming

About

Kawaii Cat 2.5D Top-Down Puzzle Game as a Solo Project for COMP3329

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages