dodoxandClaude Sonnet 5
bf15c709ea
Every building needs a planet-hazard material bundle on top of its normal BuildingCosts (SEA for low pressure, HSE for high pressure, MGC for low gravity, BL for high gravity, INS for cold, TSH for heat - area-scaled where applicable), confirmed against live in-game build panels on Nike. FIO's own BuildRequirements field is an unreliable superset across hazard types, not a direct per-building list - don't use it directly. - puga/planet.py::environment_extras(): the real threshold table. - tools/buildcost.py: full construction material list for one building, optionally on a given planet. - Wired into whatif.py/buy.py (via simulate(planet=...)) and scan.py's own bcost(), so their capex numbers stop silently omitting this. - docs/mechanics.md: the rule, plus a separate forum-sourced note on the CX order-cancellation penalty. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
PuGa
A recursively self-improving harness for Claude and humans for the game Prosperous Universe. You ask questions in plain language; Claude answers by running the tools in this repo against live market data and your own company data, instead of guessing - and when it catches itself doing the same ad-hoc work by hand more than once, it builds a tool for it instead, so the harness keeps getting sharper the more it's used.
what should I build next?
is a second smelter still worth it, or is the AL market full?
simulate adding a CHP to Deimos before I spend anything
how long until Nike runs out of RAT?
where do I post 40 BHP so it actually clears today?
Name origin: Plutonium–gallium alloy (Pu–Ga) is a specialized metallic blend of plutonium and gallium primarily used to stabilize the desirable delta (δ) phase of plutonium at room temperature.
What it can do
- Find what to build. Every recipe, but with market depth: how many buildings the market absorbs, what you'd really get for the output, and whether the margin has held for months or is a spike.
- Simulate before you spend. A replica of the PRUNplanner simulator, verified against the real thing. Marginal payback of one more building, and a warning if it overloads your housing.
- Watch your position. Cash, permits, buildings, storage and ships synced from FIO. Runway per material, cash-aware shopping lists, multi-base chains with real freight.
- Trade. Where to post an ask, how to split it, how long it takes to clear, where idle cash can sit meanwhile.
- Talk to PRUNplanner. Reads your plans, writes new ones, picks up edits you make in the web UI. Only touches plans it created.
Every number is an estimate from public and personal game data. Prices move; re-run before acting.
Quick start
git clone <repo-url> PuGa && cd PuGa
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
cp .env.example .env # FIO and PRUNplanner keys, see docs/usage.md
claude # open Claude Code here and ask
Every tool is also a command: puga scan, puga simulate plan.yaml, puga sell BHP 40. Tool list, setup and layout: docs/usage.md. Verified game mechanics and the market model: docs/.
Your own empire (profile, state, plans, notes) lives in the gitignored empire/ folder, so the repo stays public.
Not affiliated with Prosperous Universe, FIO or PRUNplanner.