← Back to ObjectStore

📖 API Documentation

Complete reference for the Grudge Studio ObjectStore API - access game data for Grudge Warlords including weapons, materials, armor, consumables, and more.

Overview

The ObjectStore API provides read-only access to all static game data for Grudge Warlords. This includes:

119 Weapons across 17 categories with 8 tiers each
150 Equipment items (armor sets, gems, accessories)
112 Materials for crafting (ore, wood, cloth, leather, gems, essences)
132 Consumables including foods, potions, and engineer items
473 Weapon Skills across 24 weapon types with icons, cooldowns, and effects
147 VFX Effect Sprites with frame data and blend modes
209 Battle Abilities with effect chains and follow-ups
5 Professions with complete skill trees and 363+ recipes
19 Faction Units for the RTS game mode
27 API Endpoints total

💡 Perfect for AI Agents

This API requires no authentication and returns JSON data. Ideal for building game companions, crafting calculators, or AI-powered assistants.

Base URL

https://molochdagod.github.io/ObjectStore

All endpoints are relative to this base URL. For example:

GET https://molochdagod.github.io/ObjectStore/api/v1/weapons.json

Authentication

No Auth Required

The ObjectStore API is completely public. No API keys, tokens, or authentication headers are needed. Simply make HTTP GET requests to any endpoint.

⚠️ Player Data

This API only serves static game definitions. For player-specific data (inventory, characters, progress), you'll need authenticated access to our Supabase database. See Database Schema for details.

Weapons Endpoint

GET /api/v1/weapons.json

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

Equipment Endpoint

GET /api/v1/equipment.json

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

Materials Endpoint

GET /api/v1/materials.json

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

Armor Endpoint

GET /api/v1/armor.json

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.

Consumables Endpoint

GET /api/v1/consumables.json

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

Skills Endpoint

GET /api/v1/skills.json

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)"
    }
  ]
}

Weapon Skills Endpoint

GET /api/v1/weaponSkills.json

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

Professions Endpoint

GET /api/v1/professions.json

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

Classes & Races Endpoints

GET /api/v1/classes.json

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

GET /api/v1/races.json

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

GET /api/v1/attributes.json

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

Enemies & Bosses

GET /api/v1/enemies.json

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

GET /api/v1/bosses.json

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

Factions

GET /api/v1/factions.json

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

VFX Effect Sprites

GET /api/v1/effectSprites.json

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"
    }
  ]
}

💡 Live Preview

See all effects animated in real-time at VFX Effects Browser

Battle Ability Effects

GET /api/v1/abilityEffects.json

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

Sprite Database

GET /api/v1/sprites.json

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

GET /api/v1/spriteMaps.json

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

Faction Units (RTS)

GET /api/v1/factionUnits.json

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

GET /api/v1/nodeUpgrades.json

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

Maps & Terrain

GET /api/v1/tileMaps.json

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

GET /api/v1/terrain.json

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

GET /api/v1/rendering.json

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

Animations

GET /api/v1/animations.json

Animation system v2.0 — 18 common anims, transition rules, blend config.

GET /api/v1/controllers.json

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

AI Systems

GET /api/v1/ai.json

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

GET /api/v1/ecs.json

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

Tier System

All equipment in Grudge Warlords uses an 8-tier system:

Tier	Name	Level Req	Material Example
T1	Common	1	Copper, Pine
T2	Uncommon	10	Iron, Oak
T3	Rare	20	Steel, Maple
T4	Epic	30	Mithril, Ash
T5	Legendary	40	Adamantine, Ironwood
T6	Mythic	50	Orichalcum, Ebony
T7	Ancient	60	Starmetal, Wyrmwood
T8	Divine	70	Divine Ore, Worldtree

Stats scale with tier using base + (perTier × (tier - 1))

JavaScript SDK

Download the SDK for easy integration:

import { GrudgeSDK } from 'https://molochdagod.github.io/ObjectStore/sdk/grudge-sdk.js';

const sdk = new GrudgeSDK();

// Get all weapons
const weapons = await sdk.getWeapons();

// Search across all data
const results = await sdk.search('iron');

// Calculate weapon stats at tier
const t5Stats = sdk.calculateStatsAtTier(weapon, 5);

// Get material icon URL
const iconUrl = sdk.getMaterialIconUrl('ore', 3);

Python Examples

import requests

BASE_URL = "https://molochdagod.github.io/ObjectStore/api/v1"

# Get all weapons
weapons = requests.get(f"{BASE_URL}/weapons.json").json()

# Find all swords
swords = weapons["categories"]["swords"]["items"]
print(f"Found {len(swords)} swords")

# Get materials
materials = requests.get(f"{BASE_URL}/materials.json").json()

# Find T5+ ores
high_tier_ores = [m for m in materials["materials"] 
                  if m["category"] == "ore" and m["tier"] >= 5]

AI Integration

The ObjectStore API is designed for AI agent consumption:

No Authentication - Direct HTTP access
JSON Format - Easy to parse
Stable Schema - Rarely changes
Complete Data - All game definitions in one place

💡 Recommended: Cache Responses

Game data updates infrequently. Cache API responses for 24 hours to reduce requests and improve performance.

Example: AI Crafting Assistant

// Fetch required data
const [weapons, materials] = await Promise.all([
  fetch(BASE_URL + '/weapons.json').then(r => r.json()),
  fetch(BASE_URL + '/materials.json').then(r => r.json())
]);

// Helper: Get materials needed for a weapon
function getCraftingRequirements(weaponId, tier) {
  const weapon = findWeapon(weapons, weaponId);
  const tierMaterials = materials.materials.filter(m => m.tier === tier);
  
  return {
    weapon: weapon.name,
    tier: tier,
    profession: weapon.craftedBy,
    primaryMaterial: tierMaterials.find(m => 
      m.gatheredBy === weapon.craftedBy
    )
  };
}