https://github.com/profrandom92/comptext-town
https://github.com/profrandom92/comptext-town
Last synced: 26 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/profrandom92/comptext-town
- Owner: ProfRandom92
- Created: 2026-05-13T11:05:23.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-13T14:02:21.000Z (about 1 month ago)
- Last Synced: 2026-05-13T14:16:46.765Z (about 1 month ago)
- Language: TypeScript
- Size: 3.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🌧️ CompText Town
A village that remembers.
Cozy pixel-art atmosphere meets semantic memory systems.
---
# ✨ What is CompText Town?
**CompText Town** is a cozy browser-based atmospheric pixel-art experience inspired by:
- Pokémon
- Stardew Valley
- Eastward
- Studio Ghibli
- modern indie pixel-art storytelling
At first glance, it looks like a small rainy pottery village.
Underneath, it quietly functions as an experimental showcase for:
- semantic memory systems
- compressed NPC memories
- replayable emotional moments
- token reduction concepts
- persistent AI-driven village state
The project explores a simple question:
> **What if a game world could remember emotionally instead of mechanically?**
---
# 🎮 Current Features
## Cozy Pixel-Art Village
- Rainy handcrafted pottery town
- Warm lantern lighting
- Kiln glow and fog
- Animated puddles and reflections
- Day/night atmosphere
- Workshop interiors with ceramic clutter
- Ambient smoke and weather systems
## Pottery Gameplay Loop
1. Gather clay
2. Craft pottery
3. Fire ceramics in the kiln
4. Deliver pottery to villagers
5. Build emotional relationships
## Persistent Villager Memory
NPCs can:
- remember gifts
- remember weather moments
- reference old conversations
- react differently over time
- maintain relationship warmth
- replay emotional memory fragments
## Hidden CompText Systems
Optional overlays show:
- token reduction
- semantic retention
- compressed memory state
- replay events
- relationship warmth
- memory snapshots
- semantic drift
## Cinematic Trailer Pipeline
Includes:
- Remotion trailer architecture
- cinematic memory reveal scenes
- replay visualizations
- logo reveal system
- export-ready compositions
---
# 🏗️ Tech Stack
- Phaser.js
- TypeScript
- Vite
- React
- Remotion
---
# 📂 Project Structure
```text
src/
├── assets/ palettes, placeholder textures
├── comptext/ semantic memory + replay systems
├── debug/ hidden observability overlays
├── npc/ villagers + emotional memory
├── scenes/ Phaser scenes
├── systems/ weather, inventory, interaction
├── trailer/ Remotion cinematic pipeline
├── ui/ dialogue + HUD
└── world/ village layout + tile logic
```
---
# 🚀 Development
```bash
git clone https://github.com/ProfRandom92/CompText-Town.git
cd CompText-Town
npm install
npm run dev
```
Open:
```text
http://localhost:5173
```
---
# 🎬 Trailer Pipeline
```bash
npm run trailer:studio
npm run trailer:render
```
Composition ID:
```text
CompTextTownTrailer
```
---
# 🛣️ Roadmap
## Phase 1 — Vertical Slice ✅
- [x] Phaser architecture
- [x] Rainy village
- [x] Pottery gameplay loop
- [x] NPC interactions
- [x] Inventory system
- [x] Save/load persistence
- [x] CompText overlays
- [x] Replay systems
- [x] Remotion trailer pipeline
## Phase 2 — Art Direction & Polish 🚧
- [ ] Replace placeholder sprites
- [ ] Handcrafted tilesets
- [ ] Improved character animation
- [ ] Better lighting composition
- [ ] Premium indie atmosphere pass
- [ ] Stronger cinematic framing
- [ ] Audio implementation
- [ ] Better UI consistency
## Phase 3 — Living Memory Village 🌙
- [ ] Emotional memory echoes
- [ ] Dynamic villager routines
- [ ] Weather-dependent memories
- [ ] Relationship evolution
- [ ] Semantic memory clustering
- [ ] In-world replay journal
- [ ] Memory artifacts & lantern drift
## Phase 4 — Showcase Release ✨
- [ ] Fully polished trailer
- [ ] Web deployment
- [ ] Steam-style landing page
- [ ] Accessibility improvements
- [ ] Soundtrack integration
- [ ] Public playable demo
---
# 💡 Philosophy
CompText Town explores:
```text
cozy handcrafted world
+
persistent emotional memory
+
hidden semantic AI systems
```
Instead of turning AI into dashboards and metrics,
the project asks:
> Can semantic memory feel warm, nostalgic and human?
---
🌧️🔥
CompText Town
A village that remembers.