Skip to content

OneHoopyFrood/RoboKitty3D

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

110 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Robot Finds Kitten 3D

A 3D Godot 4 port of the classic zen simulation robotfindskitten (circa 1997).

In this game, you are robot (#). Your job is to find kitten. This task is complicated by the existence of various things which are not kitten. Robot must touch items to determine if they are kitten or not. The game ends when robotfindskitten.

RoboKitty3D reimagines the original 2D ASCII experience as a 3D world filled with glowing, bobbing symbols — each one a quirky Non-Kitten Item (NKI) with its own description. Wander the board, bump into things, and find kitten.


Screenshots

📷 Screenshots coming soon!


Getting Started

Prerequisites

Running for Development

  1. Clone this repository
  2. Open Godot and choose Import → select the project folder
  3. Press Play (F5) or click the Play button in the toolbar

No compilation step is needed — GDScript is interpreted by the engine.


Controls

Action Key
Move forward / back W / S
Turn left / right (90°) A / D
Look around freely Hold Ctrl + move mouse
Run Hold Shift while moving
First-person view F1
Interact / inspect Walk into a symbol

Note: A and D rotate the player in 90° increments (like the original game), rather than strafing. Hold Ctrl to look around without changing your facing direction.

Tip: Tapping into a symbol triggers its blurb and a bump animation. Holding a direction while walking into a symbol brakes smoothly instead.


Project Structure

RoboKitty3D/
├── World/
│   ├── World.tscn              # Root scene; spawns all NKI symbols procedurally
│   ├── world.gd                # Board generation logic
│   ├── BaseInteractionNode/    # Base class for all interactable objects
│   ├── Symbol/                 # NKI implementation (random ASCII char + blurb)
│   └── Cube/                   # Stub interactable cube object
├── Player/
│   ├── Player.tscn             # Player scene (CharacterBody3D)
│   └── Player.gd               # Input, grid movement, collision, animations
├── UI/                         # (In progress) Dialogue and HUD scenes
├── Assets/
│   ├── NKIs.txt                # Source text for all non-kitten item blurbs
│   ├── music/                  # Background music tracks (.ogg)
│   └── sfx/                    # Sound effects (.ogg)
└── project.godot

About the Original

robotfindskitten was created by Leonard Richardson in 1997 and has been ported to dozens of platforms. It is described as a "Zen simulation" — there is no score, no fail state, just exploration and discovery.

This project is an unofficial fan port. All NKI text is derived from the original game's community-contributed item list.


Contributing

Pull requests are welcome! Check TODO.md for planned features and known gaps before starting work.

About

An implementation of Robot finds kitten in 3D using Godot

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors