From 145af4706804c3ac00ebc9caa1e19af226ee84a2 Mon Sep 17 00:00:00 2001 From: daddy Date: Thu, 17 Sep 2026 18:41:48 +0000 Subject: [PATCH] chore: rename repo references and build presets to modbison --- AGENTS.md | 39 ++++++++++++++++++++++++++++ CLAUDE.md | 18 +++++++++++++ README.md | 4 +-- backend/app/services/game_servers.py | 2 +- export_presets.cfg | 4 +-- scripts/build.sh | 6 ++--- 6 files changed, 65 insertions(+), 8 deletions(-) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..de10caa --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,39 @@ +# ModBison (Project & Agent Guidelines) + +> **CRITICAL REBRANDING NOTICE** +> - **Game Name**: **ModBison** (formerly `agp-game`). +> - "ModBison" represents a play on game modification and the 1960s British "mod" subculture, adhering to the user's "bison" project naming convention (e.g. host machine `cloudbison`, Windows client machine `pinkbison`, social platform `WiseBison`). +> - **In-Game Currency**: **Buffalo Chips** (formerly `Credits` / `CR`). +> - Named playfully after bison poop. Displayed throughout all UI menus, wallet, marketplace, and creator payout screens as "Buffalo Chips". +> - **Git Repository**: +> - Local clone path: `/home/daddy/modbison` (symlinked as `/home/daddy/agp-game-dev` for backwards compatibility). +> - Gitea repository name: `modbison` +> - Clone URL: `http://localhost:3000/daddy/modbison.git` +> - Web UI: `https://git.cloudbison.duckdns.org/daddy/modbison` +> - **Binaries & Exports**: +> - Windows: `modbison.exe` (legacy alias `agp-game.exe` maintained for backwards compatibility) +> - Linux: `modbison.x86_64` + +--- + +## Architecture Overview + +1. **Client**: Godot 4.6.2 (GDScript). + - Headless engine binary located at `~/godot/godot`. + - Export presets defined in `export_presets.cfg`. + - Main scenes in `res://scenes/` (`main_menu.tscn`, `world_3d.tscn`, `wallet_ui.tscn`, `marketplace_ui.tscn`, `selling_payout_ui.tscn`, etc.). + - Scripts in `res://scripts/`. + +2. **Backend**: FastAPI + SQLAlchemy (asyncpg) + Alembic in `backend/`. + - Python environment: `/home/daddy/agp/venv` (or project `.venv`). + - Runtime game server supervisor allocates headless Godot instances per active world session under `/tmp/modbison-game-servers`. + +3. **Orchestration & Playtesting (`/home/daddy/agp`)**: + - PM Dashboard: `http://localhost:7070` (`agp-dashboard.service`). + - Checkpoint system: `pm/checkpoint_ops.py` controls playtest instances (`PC1` through `PC4`). + - Current active checkpoint: **PC4** (backend on `http://192.168.58.138:28004`, postgres on `25544`). + - Building Windows package: `PYTHONPATH=. /home/daddy/agp/venv/bin/python3 -c "import pm.checkpoint_ops as ops; ops.build_exe('PC4')"` + +4. **Testing Protocols**: + - Headless smoke tests: `AGP_API_BASE_URL=http://127.0.0.1:28004 ~/godot/godot --headless --path . --script res://scripts/smoke_test_.gd` + - Backend pytest: `PYTHONPATH=. /home/daddy/agp/venv/bin/pytest backend/tests` diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..8c64e93 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,18 @@ +# ModBison Guidelines for Claude Code + +See [AGENTS.md](AGENTS.md) for full project conventions. + +### Quick Reference: +- **Game Name**: ModBison (formerly agp-game) +- **Currency**: Buffalo Chips (formerly Credits / CR) +- **Repo URL**: `http://localhost:3000/daddy/modbison.git` (`https://git.cloudbison.duckdns.org/daddy/modbison`) +- **Working Tree**: `/home/daddy/modbison` (or `/home/daddy/agp-game-dev`) +- **Windows Executable**: `modbison.exe` +- **Linux Executable**: `modbison.x86_64` + +### Commands: +- **Run tests**: + - Backend: `PYTHONPATH=. /home/daddy/agp/venv/bin/pytest backend/tests` + - Godot UI smoke tests: `AGP_API_BASE_URL=http://127.0.0.1:28004 ~/godot/godot --headless --path . --script res://scripts/smoke_test_.gd` +- **Rebuild PC4 Windows package**: + - `PYTHONPATH=. /home/daddy/agp/venv/bin/python3 -c "import pm.checkpoint_ops as ops; ops.build_exe('PC4')"` diff --git a/README.md b/README.md index fff20d6..30a5147 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,3 @@ -# agp-game +# ModBison -Agentic Game Platform - Godot game built by autonomous agents \ No newline at end of file +ModBison (formerly agp-game) - Godot 4 multiplayer game with customizable avatars, world building, social features, and virtual economy (Buffalo Chips). \ No newline at end of file diff --git a/backend/app/services/game_servers.py b/backend/app/services/game_servers.py index c49c87f..d47bf95 100644 --- a/backend/app/services/game_servers.py +++ b/backend/app/services/game_servers.py @@ -84,7 +84,7 @@ class GameServerSupervisor: self._servers: dict[str, _WorldServer] = {} self._lock = asyncio.Lock() self._reaper: asyncio.Task | None = None - self._runtime_dir = Path(tempfile.gettempdir()) / "agp-game-servers" + self._runtime_dir = Path(tempfile.gettempdir()) / "modbison-game-servers" self._runtime_dir.mkdir(parents=True, exist_ok=True) # ── lifecycle ──────────────────────────────────────────────────────── diff --git a/export_presets.cfg b/export_presets.cfg index dae8dbc..571e2ae 100644 --- a/export_presets.cfg +++ b/export_presets.cfg @@ -9,7 +9,7 @@ custom_features="" export_filter="all_resources" include_filter="*.json" exclude_filter="" -export_path="export/linux/agp-game.x86_64" +export_path="export/linux/modbison.x86_64" encryption_include_filters="" encryption_exclude_filters="" encrypt_pck=false @@ -40,7 +40,7 @@ custom_features="" export_filter="all_resources" include_filter="*.json" exclude_filter="" -export_path="export/windows/agp-game.exe" +export_path="export/windows/modbison.exe" encryption_include_filters="" encryption_exclude_filters="" encrypt_pck=false diff --git a/scripts/build.sh b/scripts/build.sh index cac6e37..dfd85e2 100755 --- a/scripts/build.sh +++ b/scripts/build.sh @@ -12,7 +12,7 @@ # - godot on PATH (or set GODOT_BIN below) # # Usage: scripts/build.sh -# Output: export/linux/agp-game.x86_64, export/windows/agp-game.exe +# Output: export/linux/modbison.x86_64, export/windows/modbison.exe set -euo pipefail cd "$(dirname "$0")/.." @@ -32,10 +32,10 @@ echo "Godot version: $("$GODOT_BIN" --version)" mkdir -p export/linux export/windows echo "=== Exporting Linux/X11 ===" -"$GODOT_BIN" --headless --path . --export-release "Linux" export/linux/agp-game.x86_64 +"$GODOT_BIN" --headless --path . --export-release "Linux" export/linux/modbison.x86_64 echo "=== Exporting Windows Desktop ===" -"$GODOT_BIN" --headless --path . --export-release "Windows Desktop" export/windows/agp-game.exe +"$GODOT_BIN" --headless --path . --export-release "Windows Desktop" export/windows/modbison.exe echo "" echo "Build artifacts:"