📖 API Documentation

Returns all weapon definitions organized by category. Each weapon includes stats, abilities, lore, and crafting requirements.

Response Structure

{
  "version": "1.0.0",
  "generated": "2026-02-12T00:00:00Z",
  "categories": {
    "swords": {
      "craftedBy": "Miner",
      "category": "1h",
      "items": [
        {
          "id": "sword-bloodfeud",
          "name": "Bloodfeud Blade",
          "type": "Sword",
          "lore": "Forged in endless clan blood feuds",
          "stats": {
            "damageBase": 50,
            "damagePerTier": 12,
            "speedBase": 100,
            "critBase": 3
          },
          "basicAbility": "Vengeful Slash",
          "abilities": ["Blood Rush", "Iron Grudge", "Clan Charge"],
          "signatureAbility": "Crimson Reprisal",
          "passives": ["Bloodlust", "Swift Vengeance", "Deep Cuts"]
        }
      ]
    },
    "axes": { ... },
    "daggers": { ... },
    "spears": { ... },
    "maces": { ... },
    "hammers1h": { ... },
    "hammers2h": { ... },
    "greatswords": { ... },
    "greataxes": { ... },
    "bows": { ... },
    "crossbows": { ... },
    "guns": { ... },
    "fireStaves": { ... },
    "frostStaves": { ... },
    "holyStaves": { ... },
    "lightningStaves": { ... },
    "arcaneStaves": { ... },
    "tomes": { ... }
  }
}

Weapon Categories

Category	Type	Crafted By	Count
Swords	1-Hand	Miner	6
Axes	1-Hand	Miner	6
Daggers	1-Hand	Miner	6
Spears	2-Hand	Miner	6
Maces	1-Hand	Miner	6
Hammers (1H)	1-Hand	Miner	6
Hammers (2H)	2-Hand	Miner	6
Greatswords	2-Hand	Miner	6
Greataxes	2-Hand	Miner	6
Bows	Ranged 2H	Forester	6
Crossbows	Ranged 2H	Engineer	6
Guns	Ranged 2H	Engineer	6
Fire Staves	Ranged 2H	Mystic	6
Frost Staves	Ranged 2H	Mystic	6
Holy Staves	Ranged 2H	Mystic	6
Lightning Staves	Ranged 2H	Mystic	6
Arcane Staves	Ranged 2H	Mystic	6
Tomes	Off-hand	Mystic	12

Returns 150 armor items (6 sets × 8 slots × 3 material types + gems) with stats, procs, and set bonuses.

Returns all crafting materials including ores, wood, cloth, leather, gems, and magical essences.

Material Categories

Category	Gathered By	Tiers
Ore	Miner	T1-T8
Ingots	Refined	T1-T8
Wood	Forester	T1-T8
Planks	Refined	T1-T8
Cloth	Mystic	T1-T8
Leather	Forester	T1-T8
Essence	Mystic	T1-T8
Gems	Miner	T1-T8
Infusions	Various	T1-T5

Returns armor sets organized by profession and type.

Armor Sets

Profession	Type	Sets
Miner	Metal Plate	Guardian, Berserker
Forester	Leather	Stalker, Brawler
Mystic	Cloth	Scholar, Archmage
Engineer	Mech	Mechanist, Inventor

Each set contains 6 pieces: Head, Chest, Legs, Hands, Feet, Shoulders.

Returns all consumable items including foods, potions, and engineer utilities.

Consumable Types

Type	Profession	Count	Effect
Red Foods	Chef	30	Attack/Damage buffs
Green Foods	Chef	30	Regen/Healing buffs
Blue Foods	Chef	30	Mana/Magic buffs
Potions	Chef/Mystic	30	Combat effects
Engineer Items	Engineer	12	Utility/Explosives

Returns weapon combat skills with tooltips, cooldowns, and damage formulas.

{
  "skills": [
    {
      "id": "vengeful-slash",
      "name": "Vengeful Slash",
      "weaponType": "Sword",
      "slot": "basic",
      "tooltip": "A fierce slash that builds Grudge Mark stacks...",
      "cooldown": 0,
      "manaCost": 0,
      "damage": "100% weapon damage",
      "effect": "Applies Grudge Mark (5% damage amp, max 3)"
    }
  ]
}

Returns 473 weapon skills across 24 weapon types sourced from the Warlord Crafting Suite. Each skill includes an icon path, cooldown, mana cost, effects, and slot assignment.

Response Structure

{
  "version": "1.0.0",
  "totalSkills": 473,
  "weaponTypes": [
    {
      "weaponType": "Sword",
      "skillCount": 18,
      "skills": [
        {
          "id": "sword_vengeful_slash",
          "name": "Vengeful Slash",
          "slot": "Attack",
          "cooldown": 0,
          "manaCost": 0,
          "description": "A fierce slash dealing 100% weapon damage...",
          "effect": "Applies Grudge Mark (5% damage amp, max 3)",
          "icon": "/icons/wcs/weapons/Sword_01.png"
        }
      ]
    }
  ]
}

Slot Types

Slot	Description	Color
Attack	Primary damage abilities	Green
Core	Core rotation skills	Blue
Defense	Defensive/utility skills	Yellow
Special	Situational abilities	Purple
Ultimate	High-impact ultimate abilities	Red

Weapon Types (24)

Sword, Axe (1H), Greatsword, Greataxe, Bow, Crossbow, Gun, Fire Staff, Frost Staff, Holy Staff, Lightning Staff, Nature Staff, Dagger, Arcane Staff, Spear, Hammer, Scythe, Tool, Fire Tome, Frost Tome, Holy Tome, Shadow Tome, Nature Tome, Arcane Tome

Returns all 5 professions with their skill trees, recipes, and specializations.

Professions

Profession	Role	Skill Nodes	Crafts
⛏️ Miner	Weaponsmith & Armorsmith	42	Metal weapons, plate armor
🌲 Forester	Bowyer & Leatherworker	28	Bows, leather armor
🔮 Mystic	Enchanter & Clothier	37	Staves, cloth armor, enchants
🍲 Chef	Cook & Alchemist	28	Foods, potions
🔧 Engineer	Mechanist & Siege Master	28	Guns, crossbows, mech armor

4 classes — Warrior, Mage Priest, Worge, Ranger — with starting attributes, abilities, and weapon restrictions.

6 races — Human, Orc, Elf, Undead, Barbarian, Dwarf — with attribute bonuses and faction alignment.

8 attributes with stat formulas — STR, INT, VIT, DEX, END, WIS, AGI, TAC.

38 enemies across 8 tiers with abilities, drops, and 3D asset paths.

12 bosses with multi-phase mechanics, drops, and Gouldstone chances.

3 factions — Crusade, Legion, Fabled — with lore, race mappings, and faction-specific bonuses.

147 VFX sprite sheets sourced from GRUDA-Wars. Includes frame dimensions, frame counts, categories, blend modes, and source image URLs.

Response Structure

{
  "version": "1.0.0",
  "totalEffects": 147,
  "categories": ["fire", "ice", "lightning", "nature", "dark", ...],
  "effects": [
    {
      "key": "fireSpin",
      "name": "Fire Spin",
      "category": "fire",
      "frameWidth": 100,
      "frameHeight": 100,
      "cols": 8,
      "rows": 8,
      "totalFrames": 64,
      "blendMode": "screen",
      "src": "/effects/fire_spin.png"
    }
  ]
}

209 abilities mapping class skills, weapon abilities, and enemy attacks to their VFX effect chains with follow-up effects.

Ability Sources

Source	Description
Class Abilities	Warrior, Mage, Ranger, Worge class skills
Weapon Abilities	Skills tied to specific weapon types
Enemy Abilities	Boss and mob attack effects

Canonical 9,724 ICON-* image catalog — skills, weapons, armor, sigils, UI. Each entry: grudgeUuid, iconPath, cdnUrl, category.

Category manifest for browsers — counts, labels, sample thumbnails, shard paths. Pair with icon-search-index.json for client-side search.

Live REST search on ObjectStore worker — paginated results with CDN URLs. Also: /icons/categories, /icons/by-path?path=, /icons/:grudgeUuid.

Full sprite database — 500+ icon paths organized by category (weapons, armor, skills, items).

246 sprite path mappings for weapons and armor icons — maps item IDs to their sprite sheet locations.

5,485 2D sprites organized into 13 categories — characters, enemies, bosses, monsters, effects, icons, backgrounds, and more. Sources include RPG-MODULAR, betta-warlords, grudge-angeler, and grudawars.

19 RTS faction units across 3 factions with stats, animations, and sprite paths.

Node upgrade system — unit tiers, costs, spawn rates, vision radius.

2 tile-based RTS maps with nodes, terrain objects, roads, and collision data.

Procedural terrain — 5 biome presets (plains, mountains, islands, desert, arena).

Materials, 7 skybox presets, 10 particle effects, 5 spell effects.

Animation system v2.0 — 18 common anims, transition rules, blend config. Resolve binary clips via D1 /assets/category/animation.

5 RTS camera presets, 4 chase camera presets, FPS, mouse controller config.

AI behavior trees — 7 node types, entity states, blackboard, scoring.

ECS components — 8 component types, 2 systems, spatial hash config.

Unified item database with 3,425 items across 8 categories: weapons, armor, consumables, materials, accessories, relics, capes, and shields. Each item includes an icon URL, stats, tier, tooltip, and category metadata.

Response Structure

{
  "version": "1.0.0",
  "totalItems": 3425,
  "categories": ["weapons", "armor", "consumables", "materials", "accessories", "relics", "capes", "shields"],
  "items": [
    {
      "id": "sword-bloodfeud-t5",
      "name": "Bloodfeud Blade",
      "category": "weapons",
      "type": "Sword",
      "tier": 5,
      "icon": "/icons/weapons/Sword_01.png",
      "tooltip": "Forged in endless clan blood feuds",
      "stats": { "damage": 98, "speed": 100 }
    }
  ]
}

275 animated 2D characters with full animation manifests. Supports grid-based sprite sheets and frame-sequence formats. Sources include RPG-MODULAR, betta-warlords, grudge-angeler, and grudawars.

Response Structure

{
  "version": "2.0.0",
  "totalCharacters": 275,
  "characters": [
    {
      "id": "warrior_male",
      "name": "Warrior Male",
      "source": "RPG-MODULAR",
      "animations": {
        "idle":   { "src": "/sprites/Warrior/Idle.png",   "cols": 8, "rows": 1 },
        "walk":   { "src": "/sprites/Warrior/Walk.png",   "cols": 8, "rows": 1 },
        "attack": { "src": "/sprites/Warrior/Attack.png", "cols": 6, "rows": 1 }
      }
    }
  ]
}

grudgeDot game asset manifest — sprite objects, animations, and resource paths for use in grudgeDot events and scenes.

25 hero class → sprite mappings for grudgeDot Assistant. Maps class/race combinations to their corresponding sprite character IDs.

{
  "version": "1.0.0",
  "totalAliases": 25,
  "aliases": [
    { "heroClass": "warrior", "race": "human", "spriteId": "warrior_male", "src": "/sprites/Warrior/Idle.png" }
  ]
}

Voxel model asset registry — .vox and converted GLB/GLTF models for characters, props, and terrain elements.

ObjectStore master index (sprites, icons, paths) — not the Cloudflare D1 asset_registry table. For 3D model UUID → CDN URL, query GET https://api.grudge-studio.com/assets/uuid/:uuid.

167 battle and scene background image paths organized by zone/theme.

VFX effects registry — indexed list of all particle and spell effects across the codebase.

3D shader and FX registry — GLSL shaders (fire, lightning, magic, shockwave) with metadata for the 3DFX viewer.

3DFX Viewer · Live VFX Sandbox

Spell-type arsenal — 10 families (projectile, slash, aura, hand, aoe, wall, cloud, summon, portal, impact) with 50+ visual variants. Each variant has skillSlot and skillUses for wiring SKIL-* abilities and status effects.

Sandbox: grudge-vfx.puter.site

26 game-ready spell VFX definitions — shaders, particles, splines, geometry, and timing. Pairs with spell-arsenal.json variant ids.

Spell VFX Library

UI asset packs — buttons, frames, icons, and HUD elements for use in game interfaces.

RTS-specific 3D model registry — buildings, units, and terrain objects for the real-time strategy game mode. JSON only; resolve GLB URLs via 3D Storage.

Live D1 index of environment GLBs (maps, arenas). Each row includes r2_key → https://assets.grudge-studio.com/{r2_key}.

World definitions for multi-world game modes — island maps, spawn configurations, and biome data.

Grudge Studio configuration — service registry, feature flags, and app metadata used by the grudgeDot assistant and launcher.

Serverless search across all ObjectStore data. Searches weapons, armor, materials, consumables, enemies, bosses, skills, and sprites.

Parameters

Param	Required	Default	Description
q	Yes	—	Search query string
type	No	all	Filter by type: weapons, armor, materials, consumables, enemies, bosses, skills, sprites
limit	No	50	Max results (1-200)

Example

GET /api/search?q=iron&type=materials&limit=10

{
  "query": "iron",
  "type": "materials",
  "totalResults": 3,
  "results": [
    { "type": "material", "id": "iron-ore", "name": "Iron Ore", "category": "ore", "tier": 2 },
    { "type": "material", "id": "iron-ingot", "name": "Iron Ingot", "category": "ingot", "tier": 2 }
  ]
}

Returns aggregate statistics for all ObjectStore data — total counts by category, available endpoints, and browser pages.