Upload 134 files

.dockerignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.env
+.venv/
+venv/
+.git/
+.gitignore
+*.log

.gitattributes

@@ -33,3 +33,111 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+image/background/background.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/arena.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/command_centre.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/communication_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/convention_centre.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/forrest.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/gas_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/greenhouse.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/hangar.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/hospital.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/launchpad.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/living_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/repair_shop.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/robot_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/solar_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D_interia/weapon_shop.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/arena.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/arena.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/command_centre.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/command_centre.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/communication_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/communication_station.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/convention_centre.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/convention_centre.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/forrest.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/forrest.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/gas_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/gas_station.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/greenhouse.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/greenhouse.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/hangar.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/hangar.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/hospital.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/hospital.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/launchpad.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/launchpad.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/living_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/living_area.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/repair_shop.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/repair_shop.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/robot_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/robot_station.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/solar_station.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/solar_station.png filter=lfs diff=lfs merge=lfs -text
+image/building_2D/weapon_shop.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building_2D/weapon_shop.png filter=lfs diff=lfs merge=lfs -text
+image/building/car_park.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/command_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/docker.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/fuel_storage_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/gathering_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/green_house_experimental.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/laboratory.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/launching_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/living_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/meeting_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/mine.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/mining_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/planting_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/recreation_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/satellite.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/sleep_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/stand_alone_mining_unit.jpeg filter=lfs diff=lfs merge=lfs -text
+image/building/stargate.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/cleaner_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/cleaner.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/cleaner.png filter=lfs diff=lfs merge=lfs -text
+image/character/communicator_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/communicator.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/communicator.png filter=lfs diff=lfs merge=lfs -text
+image/character/courier_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/courier.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/courier.png filter=lfs diff=lfs merge=lfs -text
+image/character/farmer_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/farmer.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/farmer.png filter=lfs diff=lfs merge=lfs -text
+image/character/humanoid_robot_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/humanoid_robot.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/humanoid_robot.png filter=lfs diff=lfs merge=lfs -text
+image/character/Main_female_character_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/Main_female_character.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/Main_female_character.png filter=lfs diff=lfs merge=lfs -text
+image/character/Main_male_character_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/Main_male_character.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/Main_male_character.png filter=lfs diff=lfs merge=lfs -text
+image/character/mechanic_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/mechanic.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/mechanic.png filter=lfs diff=lfs merge=lfs -text
+image/character/medic_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/medic.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/medic.png filter=lfs diff=lfs merge=lfs -text
+image/character/navigator_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/navigator.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/navigator.png filter=lfs diff=lfs merge=lfs -text
+image/character/pilot_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/pilot.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/pilot.png filter=lfs diff=lfs merge=lfs -text
+image/character/wheel_robot_full.png filter=lfs diff=lfs merge=lfs -text
+image/character/wheel_robot.jpeg filter=lfs diff=lfs merge=lfs -text
+image/character/wheel_robot.png filter=lfs diff=lfs merge=lfs -text
+image/interia/isolated_automation_area.jpeg filter=lfs diff=lfs merge=lfs -text
+image/interia/laboratory_place.jpeg filter=lfs diff=lfs merge=lfs -text
+image/interia/sleeping_place.jpeg filter=lfs diff=lfs merge=lfs -text
+image/mission/huge_automated_cargo_truck.jpeg filter=lfs diff=lfs merge=lfs -text
+image/mission/huge_mobile_truck.jpeg filter=lfs diff=lfs merge=lfs -text
+image/mission/huge_robot.jpeg filter=lfs diff=lfs merge=lfs -text
+image/mission/huge_rocket.jpeg filter=lfs diff=lfs merge=lfs -text
+image/mission/space_station.jpeg filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+.env
+.venv/
+venv/
+.DS_Store
+*.log
+deepseek_key.txt
+memory/

Dockerfile

@@ -0,0 +1,17 @@
+# Hugging Face Spaces (Docker SDK) - Lunar Village RPG
+FROM python:3.11-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PORT=7860
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 7860
+
+CMD ["python", "app.py"]

README.md

@@ -1,10 +1,98 @@
----
-title: MoonVillage
-emoji: 🐨
-colorFrom: purple
-colorTo: green
-sdk: static
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Lunar Village
+emoji: 🌕
+colorFrom: indigo
+colorTo: yellow
+sdk: docker
+app_port: 7860
+pinned: false
+license: mit
+---
+
+# 🌕 Lunar Village — Moon Colony RPG
+
+A **SmallVill-style** online RPG set on the Moon. Walk around a lunar colony,
+chat with AI-driven crew members (powered by **DeepSeek**), gather resources,
+and complete the colony's mega-projects: a **huge robot**, a **mobile truck**,
+an **automated cargo hauler**, a **heavy rocket**, and an **orbital space station**.
+
+Playable on desktop and **mobile** (touch joystick + tap-to-interact).
+
+**Created by Andy Kong**
+
+---
+
+## 🎮 How to play
+
+- **Move:** on-screen joystick (mobile) or `WASD` / arrow keys (desktop).
+- **Interact:** walk up to a crew member and tap the 💬 button (or press `E` / `Space`) to talk.
+- **Gather:** walk up to a building like the Mine or Greenhouse and tap the ⛏️ button to collect resources.
+- **Build:** open the 🏗️ **Missions** panel to spend resources and construct the mega-projects.
+
+## 🔐 DeepSeek API key (important)
+
+The game talks to DeepSeek through a **server-side proxy** (`/api/chat`) so your
+API key is never exposed to players. The key is read from an environment
+variable and should be stored as a **Space Secret**, never committed to code.
+
+On Hugging Face:
+1. Open your Space → **Settings** → **Variables and secrets**.
+2. Add a **secret** named `DEEPSEEK_API_KEY` with your key value.
+3. (Optional) add `DEEPSEEK_MODEL` (default `deepseek-chat`) and
+   `DEEPSEEK_BASE_URL` (default `https://api.deepseek.com`).
+
+> ⚠️ If you shared your key anywhere public (chat, screenshots, commits),
+> regenerate it in the DeepSeek console before deploying.
+
+If no key is set, the game still runs using built-in offline personality
+replies, so you can test the whole experience without any credentials.
+
+## 🚀 Deploy to Hugging Face Spaces
+
+1. Create a new **Space** → SDK: **Docker**.
+2. Upload this whole folder (including `app.py`, `Dockerfile`, `requirements.txt`,
+   `static/`, and `image/`).
+3. Add the `DEEPSEEK_API_KEY` secret (see above).
+4. The Space builds the Docker image and serves the game on port `7860`.
+
+## 🖥️ Run locally
+
+```bash
+pip install -r requirements.txt
+# optional: enable AI
+set DEEPSEEK_API_KEY=your_key_here      # Windows (cmd)
+# $env:DEEPSEEK_API_KEY="your_key_here" # Windows (PowerShell)
+# export DEEPSEEK_API_KEY=your_key_here # macOS/Linux
+python app.py
+```
+
+Then open http://localhost:7860
+
+## 📁 Project structure
+
+```
+Kiro_RPG/
+├─ app.py               # FastAPI backend + DeepSeek proxy
+├─ requirements.txt
+├─ Dockerfile           # Hugging Face Docker Space
+├─ image/               # game art (buildings, characters, missions)
+└─ static/
+   ├─ index.html
+   ├─ css/style.css
+   └─ js/
+      ├─ config.js       # world / buildings / characters / missions data
+      ├─ ai.js           # AI chat client
+      ├─ ui.js           # HUD, dialog, missions
+      ├─ game.js         # canvas engine, player, NPCs
+      └─ boot.js         # title screen
+```
+
+## 🧩 Tech
+
+- **Backend:** FastAPI + httpx (async DeepSeek proxy)
+- **Frontend:** vanilla HTML5 Canvas + JS (no build step, loads fast on mobile)
+- **AI:** DeepSeek Chat (OpenAI-compatible API)
+
+---
+
+Created by **Andy Kong**.

app.py

@@ -0,0 +1,338 @@
+"""
+Lunar Village - a SmallVill-style online RPG set on the Moon.
+FastAPI backend: serves the static game and proxies AI chat to DeepSeek.
+
+The DeepSeek API key is read from the DEEPSEEK_API_KEY environment variable
+(set it as a Secret in your Hugging Face Space). It is NEVER sent to the client.
+
+Created by Andy Kong.
+"""
+import os
+import re
+import json
+import logging
+from datetime import datetime, timezone
+from typing import List, Optional
+
+import httpx
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+from fastapi.responses import FileResponse, JSONResponse
+from pydantic import BaseModel, Field
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("lunar-village")
+
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+STATIC_DIR = os.path.join(BASE_DIR, "static")
+IMAGE_DIR = os.path.join(BASE_DIR, "image")
+MEMORY_DIR = os.path.join(BASE_DIR, "memory")
+os.makedirs(MEMORY_DIR, exist_ok=True)
+
+DATA_DIR = os.path.join(BASE_DIR, "data")
+os.makedirs(DATA_DIR, exist_ok=True)
+INVENTORY_PATH = os.path.join(DATA_DIR, "inventory.json")
+
+
+def load_inventory() -> dict:
+    if os.path.isfile(INVENTORY_PATH):
+        try:
+            with open(INVENTORY_PATH, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except Exception:  # noqa: BLE001
+            pass
+    return {"resources": {}, "updated": None}
+
+
+def save_inventory(resources: dict) -> dict:
+    data = {
+        "resources": {k: float(v) for k, v in resources.items()},
+        "updated": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+    }
+    with open(INVENTORY_PATH, "w", encoding="utf-8") as f:
+        json.dump(data, f, ensure_ascii=False, indent=2)
+    return data
+
+MAX_MEMORY_ENTRIES = 60          # keep the most recent N per character
+MEMORY_IN_PROMPT = 10            # how many recent memories to feed the AI
+
+
+def _safe_id(cid: str) -> str:
+    return re.sub(r"[^a-zA-Z0-9_-]", "", cid or "")[:64]
+
+
+def _mem_path(cid: str) -> str:
+    return os.path.join(MEMORY_DIR, f"{_safe_id(cid)}.json")
+
+
+def load_memory(cid: str) -> dict:
+    path = _mem_path(cid)
+    if os.path.isfile(path):
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except Exception:  # noqa: BLE001
+            pass
+    return {"id": _safe_id(cid), "name": "", "entries": []}
+
+
+def save_memory(cid: str, data: dict) -> None:
+    try:
+        with open(_mem_path(cid), "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("Could not save memory for %s: %s", cid, exc)
+
+
+def append_memory(cid: str, text: str, name: str = "") -> dict:
+    data = load_memory(cid)
+    if name and not data.get("name"):
+        data["name"] = name
+    data.setdefault("entries", []).append({
+        "t": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+        "text": text.strip(),
+    })
+    data["entries"] = data["entries"][-MAX_MEMORY_ENTRIES:]
+    save_memory(cid, data)
+    return data
+
+
+def memory_prompt(cid: str) -> str:
+    data = load_memory(cid)
+    entries = data.get("entries", [])[-MEMORY_IN_PROMPT:]
+    if not entries:
+        return ""
+    lines = "\n".join(f"- {e['text']}" for e in entries)
+    return (
+        "\n\nYour memories so far (oldest first, act consistently with them, "
+        "and follow any standing orders from the Commander):\n" + lines
+    )
+
+DEEPSEEK_API_KEY = os.environ.get("DEEPSEEK_API_KEY", "").strip()
+# Also try loading from a local key file (not uploaded to Hugging Face)
+_KEY_FILE = os.path.join(BASE_DIR, "deepseek_key.txt")
+if not DEEPSEEK_API_KEY and os.path.isfile(_KEY_FILE):
+    with open(_KEY_FILE, "r", encoding="utf-8") as _f:
+        DEEPSEEK_API_KEY = _f.read().strip()
+
+DEEPSEEK_BASE_URL = os.environ.get("DEEPSEEK_BASE_URL", "https://api.deepseek.com").rstrip("/")
+DEEPSEEK_MODEL = os.environ.get("DEEPSEEK_MODEL", "deepseek-chat")
+
+# Allow a user-provided key at runtime (set via /api/set-key)
+_USER_KEY = {"key": ""}
+
+app = FastAPI(title="Lunar Village", version="1.0.0")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+class ChatMessage(BaseModel):
+    role: str
+    content: str
+
+
+class ChatRequest(BaseModel):
+    system: str = Field(default="", description="System / persona prompt for the NPC.")
+    messages: List[ChatMessage] = Field(default_factory=list)
+    temperature: float = 1.0
+    max_tokens: int = 220
+    character_id: Optional[str] = None       # if set, that character's memory is injected
+    character_name: Optional[str] = None
+
+
+class MemoryEntryRequest(BaseModel):
+    text: str
+    name: Optional[str] = None
+
+
+class CharacterSeed(BaseModel):
+    id: str
+    name: Optional[str] = None
+    persona: Optional[str] = None
+
+
+class MemoryInitRequest(BaseModel):
+    characters: List[CharacterSeed] = Field(default_factory=list)
+
+
+class InventoryRequest(BaseModel):
+    resources: dict = Field(default_factory=dict)
+
+
+class ChatResponse(BaseModel):
+    reply: str
+    fallback: bool = False
+
+
+# A small offline personality-flavoured fallback so the game is still playable
+# without an API key (e.g. local testing or if DeepSeek is unreachable).
+FALLBACK_LINES = {
+    "farmer": "The greenhouse crops are holding up, but I need more water reclaimed from the ice mine.",
+    "mechanic": "Give me spare parts and I'll keep the rovers running. That huge truck won't build itself.",
+    "medic": "Radiation exposure is the real enemy up here. Stay inside during solar flares.",
+    "pilot": "The launch window is tight. We need fuel stabilised before the rocket can fly.",
+    "navigator": "I've been charting safe routes across the mare. Fewer craters, fewer breakdowns.",
+    "communicator": "Signal to Earth has a two-second delay. Patience, commander.",
+    "courier": "I move supplies between the domes. Tell me where you need them.",
+    "cleaner": "Moon dust gets everywhere. It clogs the airlocks if I don't keep at it.",
+    "humanoid_robot": "Directive acknowledged. Awaiting task assignment, commander.",
+    "wheel_robot": "Beep. Rolling out to the mining area for another load of ore.",
+    "default": "Welcome to the colony, commander. There's plenty of work to keep us all alive up here.",
+}
+
+
+def build_fallback(system: str, messages: List[ChatMessage]) -> str:
+    text = (system + " " + " ".join(m.content for m in messages)).lower()
+    for key, line in FALLBACK_LINES.items():
+        if key != "default" and key in text:
+            return line
+    return FALLBACK_LINES["default"]
+
+
+@app.get("/api/health")
+async def health():
+    active_key = _USER_KEY["key"] or DEEPSEEK_API_KEY
+    return {"ok": True, "ai_enabled": bool(active_key)}
+
+
+class SetKeyRequest(BaseModel):
+    key: str = ""
+
+
+@app.post("/api/set-key")
+async def set_key(req: SetKeyRequest):
+    """Allow a user to provide their own DeepSeek API key for this session."""
+    _USER_KEY["key"] = req.key.strip()
+    return {"ok": True, "ai_enabled": bool(_USER_KEY["key"] or DEEPSEEK_API_KEY)}
+
+
+@app.post("/api/memory/init")
+async def memory_init(req: MemoryInitRequest):
+    """Ensure a memory file exists for every character (called once on game start)."""
+    created = []
+    for c in req.characters:
+        cid = _safe_id(c.id)
+        if not cid:
+            continue
+        if not os.path.isfile(_mem_path(cid)):
+            seed = {"id": cid, "name": c.name or "", "entries": []}
+            if c.persona:
+                seed["entries"].append({
+                    "t": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+                    "text": f"I am {c.name or cid}, {c.persona}",
+                })
+            save_memory(cid, seed)
+            created.append(cid)
+    return {"ok": True, "created": created, "total": len(req.characters)}
+
+
+@app.get("/api/memory")
+async def memory_list():
+    ids = [f[:-5] for f in os.listdir(MEMORY_DIR) if f.endswith(".json")]
+    return {"characters": sorted(ids)}
+
+
+@app.get("/api/memory/{cid}")
+async def memory_get(cid: str):
+    return load_memory(cid)
+
+
+@app.post("/api/memory/{cid}")
+async def memory_post(cid: str, req: MemoryEntryRequest):
+    if not req.text.strip():
+        raise HTTPException(status_code=400, detail="empty memory text")
+    data = append_memory(cid, req.text, req.name or "")
+    return {"ok": True, "count": len(data.get("entries", []))}
+
+
+@app.get("/api/inventory")
+async def inventory_get():
+    """Return the colony's accumulated resources (persisted to data/inventory.json)."""
+    return load_inventory()
+
+
+@app.post("/api/inventory")
+async def inventory_post(req: InventoryRequest):
+    data = save_inventory(req.resources)
+    return {"ok": True, **data}
+
+
+@app.post("/api/chat", response_model=ChatResponse)
+async def chat(req: ChatRequest):
+    # Build the system prompt, injecting this character's memory if provided.
+    system = req.system
+    if req.character_id:
+        system += memory_prompt(req.character_id)
+
+    # Determine the active API key (user-provided takes priority)
+    active_key = _USER_KEY["key"] or DEEPSEEK_API_KEY
+
+    # No key configured -> graceful offline fallback so the game still works.
+    if not active_key:
+        return ChatResponse(reply=build_fallback(req.system, req.messages), fallback=True)
+
+    payload_messages = []
+    if system:
+        payload_messages.append({"role": "system", "content": system})
+    for m in req.messages:
+        payload_messages.append({"role": m.role, "content": m.content})
+
+    payload = {
+        "model": DEEPSEEK_MODEL,
+        "messages": payload_messages,
+        "temperature": req.temperature,
+        "max_tokens": req.max_tokens,
+        "stream": False,
+    }
+    headers = {
+        "Authorization": f"Bearer {active_key}",
+        "Content-Type": "application/json",
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            resp = await client.post(
+                f"{DEEPSEEK_BASE_URL}/chat/completions",
+                json=payload,
+                headers=headers,
+            )
+        if resp.status_code != 200:
+            logger.warning("DeepSeek error %s: %s", resp.status_code, resp.text[:300])
+            return ChatResponse(reply=build_fallback(req.system, req.messages), fallback=True)
+        data = resp.json()
+        reply = data["choices"][0]["message"]["content"].strip()
+        return ChatResponse(reply=reply, fallback=False)
+    except Exception as exc:  # noqa: BLE001
+        logger.exception("DeepSeek request failed: %s", exc)
+        return ChatResponse(reply=build_fallback(req.system, req.messages), fallback=True)
+
+
+# Serve game images and static assets.
+if os.path.isdir(IMAGE_DIR):
+    app.mount("/image", StaticFiles(directory=IMAGE_DIR), name="image")
+
+
+@app.get("/")
+async def index():
+    index_path = os.path.join(STATIC_DIR, "index.html")
+    if os.path.isfile(index_path):
+        # never cache the HTML so versioned asset URLs are always picked up
+        return FileResponse(index_path, headers={"Cache-Control": "no-cache, no-store, must-revalidate"})
+    return JSONResponse({"error": "index.html not found"}, status_code=404)
+
+
+if os.path.isdir(STATIC_DIR):
+    app.mount("/", StaticFiles(directory=STATIC_DIR, html=True), name="static")
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    port = int(os.environ.get("PORT", "7860"))
+    uvicorn.run("app:app", host="0.0.0.0", port=port, reload=False)

data/inventory.json

@@ -0,0 +1,11 @@
+{
+  "resources": {
+    "ore": 153.90000000000174,
+    "metal": 14.600000000000168,
+    "fuel": 177.35000000000232,
+    "food": 0.2,
+    "energy": 272.90000000000657,
+    "parts": 175.2999999999926
+  },
+  "updated": "2026-07-12T14:21:08+00:00"
+}