Grudge Dev Tool

Desktop admin shell for Grudge Studio — Elite Three.js studio, Assets, Forge, Preview, Coder, Skeleton, Legion, and player Puter Space.

⬇ Download latest installer → Systems & APIs → Admin architecture → Production deployment →

Production tray (current package)

Windows x64 NSIS · v1.0.11 · electron-updater · Local Files 3D → ThreeFlow · Elite media · Forge embed · Preview · Agent AI.

Surface	Role
Home	Fleet health + admin systems (client, info.*, ENGINE, open, GRUDOX, Forge, Coder, puter-space)
Local Files	Disk browser. Click = preview. Double-click 3D → ThreeFlow. Media → Elite.
Elite	Images / audio / video / text / PDF pop-out. Not the 3D editor.
Assets	R2/ObjectStore · `>query` · Elite pop-out for media · explicit Open in ThreeFlow / Forge
ThreeFlow	Warlords scene editor (`threeflow.vercel.app?asset=` or local loopback)
Forge	Same source as https://forge.grudge-studio.com — R3F + Rapier + AI Worker
Preview	Play-mode clients (open · client · water · GRUDOX · Multiverse) after Forge
Coder	Embed coder.grudge-studio.com + optional local PTY
Skeleton	Mixamo-25 → T-pose → retarget → grudge-convert → CDN
Store / BlenderKit / UUID / Legion	Catalogs, ingest, IDs, fleet AI chat
Agent AI	Make & deploy · convert · upload · Forge handoff
Plugin host	`127.0.0.1:17380` — VS Code / standalone / viewer / agentic attach
Docs	Same `docs/` Markdown as this GitHub Pages site

⬇ Latest installer All releases Source

First connection (ONE TRUTH)

Install Grudge Dev Tool Setup from Releases (or auto-update). Product name is Grudge Dev Tool, not Forge.
Settings → ONE TRUTH → API base https://client.grudge-studio.com (rewrites → Railway + ObjectStore + id).
Sign in with Grudge ID (https://id.grudge-studio.com) — not Puter as product login. Admin allowlist (grudachain / molochdadev) starts GRUDACHAIN Ollama when configured.
Player account files → Puter Space (User-Pays FS + *.puter.site). Never bag / roster / wallet.
Local Files → 3D opens ThreeFlow; media opens Elite. Forge live is explicit (CDN URL). Then Preview playtest.
Optional: npm run secret:import for R2 / AI / Legion keys.

Do not point Settings at api.grudge-studio.com (deprecated). Login is id.* only.

Admin loop (daily)

Assets (CDN / ObjectStore)
    → Forge (forge.grudge-studio.com)
    → Preview (open / client / water / GRUDOX / Multiverse)
    → Agent AI / Upload (grudge-convert → R2 → D1 seed)

Details: Admin architecture · AI · D1 · R2 · Stream.

CLI

git clone https://github.com/Grudge-Warlords/grudge-dev-tool.git
cd grudge-dev-tool/cli
npm install && npm run build
npm install -g .

grudge-dev setup
grudge-dev doctor
grudge-dev login --admin-password <pw>
grudge-dev upload-pack --root "C:\packs\MyPack" --pack-id my-pack --dry-run

CLI quickstart → ONE TRUTH wiring →

doctor probes fleet manifest, auth, objectstore, icons via client.grudge-studio.com. Expect a high score when the fleet is healthy.

What it does

Desktop admin (Dev Tool tray)

ONE TRUTH connectivity + fleet probes on Home
Assets with Agent search and production Asset Viewer
Forge webview = live production editor (not a local fork)
Preview for loading deployed games/clients after scene work
Coder / Skeleton / Store / BlenderKit / UUID / Legion as Dev Tool modules
Secrets in Windows Credential Vault (keytar) — never commit .env production keys

CLI

Doctor / setup against production hosts
Asset pack upload with convert pipeline hooks
Admin login for automated ops

Docs (this site)

Built from the same docs/ folder the app catalogs
Workflow: .github/workflows/pages.yml on main
Base URL: https://grudge-warlords.github.io/grudge-dev-tool/

Host	Role
client.grudge-studio.com	ONE TRUTH API base
id.grudge-studio.com	Grudge ID
threeflow.vercel.app	Warlords scene editor (Elite `?asset=`)
forge.grudge-studio.com	Map/scene deploy editor
coder.grudge-studio.com	Vibe IDE
ai.grudge-studio.com	Legion AI (`/v1/context` 1.6.1+)
ai.grudge-studio.com/puter-space	Player account cloud (FS + site deploy — not bag)
open.grudge-studio.com	Open launcher
grudox.grudge-studio.com	GRUDOX / Carrier
grudge-multiverse.vercel.app	Multiverse Bermuda MP (SPA)
Multiverse Railway	Multiverse rooms `/api/mv`
water.grudge-studio.com	Home island
assets.grudge-studio.com	CDN
objectstore / info	Catalogs
grudge-studio.com	Portal / ENGINE

Full map: Systems & APIs · Databases · sharing · backups · API reference · Production deployment.