Grudge Dev Tool — Quickstart

Desktop admin shell: Assets → Forge (forge.grudge-studio.com) → Preview playtests → Agent AI.
Full map: Admin architecture.

1. Install

Download the latest Grudge Dev Tool Setup-*.exe from Releases and run it. It installs under %LOCALAPPDATA%\Programs\ by default and adds:

A Start-menu shortcut Grudge Dev Tool
An optional desktop shortcut
An entry in the system tray

Do not look for Grudge Studio Forge-Setup-*.exe — that was the old product name.

2. First launch

The window may start hidden — only the tray icon appears. Left-click the icon to open the window; right-click for the context menu.

On open, Forge auto-ensures the GRUDACHAIN Ollama container (Docker) or native ollama serve so local agentic AI is available.

Sign in at id.grudge-studio.com (Grudge ID). That is product login — not Puter as the account.
Allowlisted admins (grudachain, molochdadev) run a full agentic ensure: prefer Ollama, pull a default model if the container has none.
Status bar shows gold ADMIN + OLLAMA · AGENTIC when ready.
Player files / *.puter.site deploys: Puter Space. Never bag or roster.

Canonical admins: grudachain, molochdadev (plus allowlisted emails baked into the build).

4. Settings

Open Settings in the sidebar:

Set Fleet client URL to https://client.grudge-studio.com (ONE TRUTH). Prefer the ONE TRUTH button over legacy hosts.
Confirm Ollama / GRUDACHAIN — Status online, Backend docker-grudachain or native. Use Start GRUDACHAIN + Agentic if offline.
Optional: paste a BlenderKit API key for the Asset Library and enrich stage.
Check the Toolchain table (sharp, gltf-transform, Blender, ffmpeg).

GRUDACHAIN Ollama (local agentic AI)

Item	Value
Container	`GRUDACHAIN`
Image	`ollama/ollama:latest`
Host port	`11434`
Volume	`grudachain-ollama`
API	`http://localhost:11434`

Requires Docker Desktop (preferred) or native Ollama at %LOCALAPPDATA%\Programs\Ollama\ollama.exe.

5. Daily admin loop

Local Files — folder on disk. Click previews. Double-click GLB/glTF → ThreeFlow (save, multi-mesh, F to frame). Images / audio / video → Elite. Show in list (above tris/verts) scrolls the left pane. AI card copies markdown for agents; System open is the OS default app. Assets — browse R2; >query search; Open in ThreeFlow / Forge live are explicit (CDN URL). Mesh paint/weld stays in Forge. Mixamo-25 in Skeleton.
Forge — production editor (R3F + Rapier). Same host as DNS. Use Play test when ready.
Preview — load open / client / water / GRUDOX / Multiverse with optional sceneId / glb.
Coder — cloud IDE embed, or Local server for full PTY.
Skeleton / Store / BlenderKit / UUID / Legion — retarget, catalogs, ingest, IDs, fleet AI (not Coder hub).
Docs — same Markdown as GitHub Pages (docs/).

Bake for shipping: grudge-convert → R2 → D1/ObjectStore seed — not “save only in Forge”.

docker ps --filter name=GRUDACHAIN
curl http://127.0.0.1:11434/api/version

5. Studio Hub & Agent AI

Studio Hub — fleet health probes and launch pad.
Agent AI — make/deploy presets (CDN packs, heroes, fleet doctor, seed NPCs). Uses Ollama when agentic is ready, with cloud fallbacks.

6. Browse

Open Browser. Type a prefix (e.g. asset-packs/classic64/) and click List. Click assets for the always-on-top Asset Viewer.

7. Search

Open Search. Free-text query + optional category and pack filter.

8. Upload

Open Upload. Drag files in. Set the target prefix, click Start upload. Each file passes through the ingestion pipeline before the PUT.

9. Forge 3D & Skeleton

Forge 3D — scene editor, paint tools, convert → GLB → R2.
Skeleton Studio — Mixamo-25 author extract / T-pose / place, then bind Warlords roles (left) to clips (right) and save a Toon Bip001 play pack (grudge-convert → R2).

10. Request URL / UUID

Request URL — signed GET + public CDN URL.
UUID — generate or parse Grudge UUIDs locally (no network).

11. Preview (admin-only)

Open Preview to load any HTTP/HTTPS URL or local .html file inside a sandboxed Electron <webview>. Guest WebContents: nodeIntegration=false, contextIsolation=true, sandbox=true.

12. Admin gating

Admin-only surfaces (Upload · Request URL · Forge 3D · Coder · Games · Preview · Settings · Agent AI) are hidden for non-admin sessions. Gold ADMIN pill appears in the sidebar and status bar.

For dev support: localStorage["grudge:admin-override"] = "1" in DevTools (dev builds only). Backend still enforces real permissions.

Quitting

The window’s red-X only hides it. Use the tray menu → Quit to fully exit (native Ollama child stops; Docker GRUDACHAIN is left running as a shared service).