v0.4.0 — Agentic edge, projects, scripts & docs

v0.4.0 — Agentic edge, projects, scripts & docs

Live editor: https://forge.grudge-studio.com/editor
Docs: https://molochdagod.github.io/Grudge-Studio-Forge/
Changelog: CHANGELOG.md

Highlights

• Cloudflare edge agent stack: free-ai + Fast catalog + D1 jobs on forge.grudge-studio.com
• Puter / local project save-load with hydrated scene payloads
• Editor Ctrl+C/V hierarchy, improved F frame, long-range viewport
• Smart gameplay scripts (WASD, third-person, NetworkManager, remotes)
• GitHub Pages docs: deployment mechanisms + best practices

Added

• Agent edge: /api/free-ai/*, /api/catalog/*, /api/agent/* (Worker + optional D1 forge-agent)
• Fast assets catalog for SPA + agents (list_fast_assets / spawn_fast_asset)
• Asset URL policy (builtin: + R2 CDN only in scenes)
• Fleet Groq / Together secrets on free-ai Worker
• Scripts tab smart templates (multiplayer / camera / R2 character)
• forge-gameplay-scripts AI skill
• Docs site (just-the-docs) via Actions Pages workflow

Changed

• Production deploy path documented: GHA prebuilt → Vercel → CF Worker
• Default agent model prefers fleet Groq
• Fog/camera defaults for island-scale maps

Fixed

• Scene open/load empty data (index rows hydrated from FS / localStorage)
• Together serverless model IDs

Deploy mechanisms

Path	Mechanism
SPA	GHA Deploy Forge SPA → Vercel prebuilt → grudge-gameforge-web
Agent API	grudge-forge-free-ai routes on forge domain
Assets	R2 assets.grudge-studio.com
Docs	GHA pages.yml → GitHub Pages
Desktop	GHA release.yml on v* tags (NSIS when build succeeds)

curl -sS https://forge.grudge-studio.com/__edge/health
curl -sS https://forge.grudge-studio.com/api/catalog/status
curl -sS https://forge.grudge-studio.com/api/free-ai/status

v0.3.1 — Asset Expansion (96+ Models, Locomotion, Weapons)

Grudge GameForge v0.3.1 — Asset Expansion

96+ Builtin Models

Massive asset expansion — the editor now ships with 96+ ready-to-use GLB models.

New in this patch:

Grudge 6-Race Locomotion (28 clips total)

• Base pack (12): idle, walk, run, jump, strafe L/R, strafe-walking L/R, turn L/R, turn-90 L/R
• Magic pack (16): casting-stance versions of all movement clips + sprint, jump-landing transitions

Modern-Era Characters (2)

• Bandit (7.3MB) — neutral post-apocalyptic enemy
• NCR Ranger (15.5MB) — armored military unit for shooter templates

Stylized Asset Packs (18)

• Nature: tree pack, tropical pack, autumn trees (animated), single tree, icicles
• Buildings: woodcutter hut, tavern
• Props: crystal gems (handpainted), medieval props, survival items, toon weapon pack
• VFX: stylized fire, stylized fire tornado
• Creatures: wolf, shark
• Maps: pirate island (low poly)
• Materials: sand procedural
• Animations: combat demo (female vs two boys)

Survival Camp Demo Scene

• New template using survivor, skeletons, tent, campfire, crow, freeze VFX
• 4 skeleton enemies (sword + axe variants) with deathmatch AI
• Playable first-to-10 with 5s respawn

Weapon System

• weaponCatalog.ts: 31 weapons with bone attachment + animation pack mapping
• weapon-equip template: LMB melee combat with 3-phase attack timing
• weapon-pickup-swap template: trigger-zone weapon swapping

---

Created by Racalvin The Pirate King at Grudge Studio.

v0.3.0 — Landing Page, AI Integration, GitHub Sync, Visual Scripting

Grudge GameForge v0.3.0

Landing Page

• forge.grudge-studio.com landing page with dark cinematic design
• Feature grid, AI providers, asset conversion matrix, CTAs
• wouter routing: / = landing, /editor = editor (lazy-loaded)

Inline AI Assistant

• AI prompt bar embedded in every bottom-panel tab (Console, Assets, Scripts, Prefabs, Nodes, Layers)
• Tab-specific context injection (console logs, scene entities, layer distribution)
• Spinning 3D gem icon that glows while streaming

Visual Scripting AI

• Prompt-to-graph generator: natural language to fully wired node graphs
• Supports geometry, colors, lights, positions, counts
• Zero latency (pattern matching, no LLM call needed)

Cross-Tab Drag and Drop

• Hierarchy to Scripts: auto-creates and attaches a script
• AssetBrowser to Nodes: creates Mesh node
• Hierarchy to Nodes: creates Transform node

GitHub Project Sync

• Push/pull projects to GitHub repos via Git tree API
• Standardized folder structure (forge.project.json, scenes/, scripts/, prefabs/)
• Auto-generated commit messages, PAT-based auth

Project Conventions

• UUID v4 for new entity IDs
• PascalCase/camelCase/kebab-case naming enforcers
• Project audit with 0-100 organization score

Game-System Script Templates (7 new)

• Health System, Resource Node, Quest Tracker, Inventory Pickup
• Day/Night Cycle, Projectile Launcher
• Inspired by uMMORPG patterns

Dungeon Interior Prefab

• 822-mesh dungeon GLB with layered parent-child hierarchy
• Structure / Props / Lighting / Spawn Points / Collision layers

Stats

• 365 tests pass, 6 packages typecheck clean
• 2,316 lines added across 18 files

---

Created by Racalvin The Pirate King at Grudge Studio.

v0.2.0 — Offline AI, Asset Pipeline, Dungeon Prefab

Grudge GameForge v0.2.0

Ollama Offline AI

• New local AI provider — connects directly to localhost:11434
• 4 models: Qwen 2.5 Coder 7B, Llama 3.2, DeepSeek Coder v2, Code Llama
• 1-click setup scripts (Windows + Mac/Linux) — installs Ollama, pulls models, starts editor

Browser Asset Conversion

• FBX/OBJ/STL to GLB via assimpjs WASM in-browser (no desktop app needed)
• ZIP extract + auto-convert contained 3D files
• PNG/JPG/WebP/JSON direct upload to R2

Dungeon Interior Prefab

• 822-mesh dungeon scene (forge-scene.glb) as builtin template
• Layered parent-child hierarchy: Structure / Props / Lighting / Spawns / Collision
• Dark ambient environment with 6 torch lights

AI System Upgrades

• MAX_TOKENS_CAP: 8192 to 15360 (server)
• MAX_TURNS: 8 to 15 (client) with cooldown at turns 14-15
• 13 AI models across 3 providers (Anthropic + Puter + Ollama)

Animation Library

• 22-clip catalog (locomotion, combat, emote, utility)
• Mixamo URL patterns for runtime resolution

Deployment Stack

• Vercel (SPA) + Railway (API) + Cloudflare (R2/DNS/Workers AI)
• Offline/online/hybrid deployment modes
• Cross-platform dev script fix, BakeProgressToasts test fix

---

Created by Racalvin The Pirate King at Grudge Studio.