⚔️ Grudge Studio ObjectStore

Public API for Grudge Warlords game data — weapons, materials, armor, VFX effects, and battle abilities

📊 API Statistics

119
Weapons
150
Equipment
132
Consumables
112
Materials
473
Weapon Skills
147
VFX Effects
209
Battle Abilities
19
Faction Units
27
API Endpoints

🔗 API Endpoints

All endpoints return JSON. No authentication required.

GET /api/v1/weapons.json 119 weapons with full stats, lore, abilities, passives, sprite paths
GET /api/v1/equipment.json 150 armor items (6 sets × 8 slots × 3 materials + gems) with stats, procs, set bonuses
GET /api/v1/armor.json Armor slot definitions, tier colors (T1-T8)
GET /api/v1/materials.json 112 crafting materials (ore, wood, cloth, leather, gems, herbs)
GET /api/v1/consumables.json 132 consumables — Chef foods (red/green/blue), potions, engineer items
GET /api/v1/skills.json 47 weapon skills with cooldowns, mana costs, descriptions
GET /api/v1/professions.json 5 crafting + 6 gathering professions, skill trees, 363+ recipes
GET /api/v1/spriteMaps.json 246 sprite path mappings for weapons and armor icons
GET /api/v1/classes.json 4 classes — Warrior, Mage Priest, Worge, Ranger with abilities
GET /api/v1/races.json 6 races — Human, Orc, Elf, Undead, Barbarian, Dwarf
GET /api/v1/factions.json 3 factions — Crusade, Legion, Fabled with lore and race mappings
GET /api/v1/attributes.json 8 attributes with formulas — STR, INT, VIT, DEX, END, WIS, AGI, TAC
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
GET /api/v1/sprites.json Full sprite database — 500+ icon paths organized by category
GET /api/v1/weaponSkills.json 473 weapon skills across 24 types — icons, cooldowns, effects, slot loadouts

✨ VFX & Battle Effects (from GRUDA-Wars)

GET /api/v1/effectSprites.json 147 VFX sprite sheets — frame data, categories, blend modes, source URLs
GET /api/v1/abilityEffects.json 209 abilities — class, weapon, enemy with effect chains and follow-ups

🎮 Game Engine (from GDevelop)

GET /api/v1/factionUnits.json 19 RTS faction units across 3 factions with stats, animations, sprite paths
GET /api/v1/nodeUpgrades.json Node upgrade system — unit tiers, costs, spawn rates, vision radius
GET /api/v1/tileMaps.json 2 tile-based RTS maps with nodes, terrain objects, roads, collision data
GET /api/v1/animations.json Animation system — 18 common anims, transition rules, blend config
GET /api/v1/rendering.json Materials, 7 skybox presets, 10 particle effects, 5 spell effects
GET /api/v1/controllers.json 5 RTS camera presets, 4 chase camera presets, FPS, mouse controller config
GET /api/v1/terrain.json Procedural terrain — 5 biome presets (plains, mountains, islands, desert, arena)
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

📦 SDK Usage

JavaScript Works in browsers and Node.js

import { GrudgeSDK } from './sdk/grudge-sdk.js';

const sdk = new GrudgeSDK();

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

// Search for items
const results = await sdk.search('iron');

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

🤖 For AI Agents

Use this data in your AI agents without authentication:

// Fetch weapons directly
const response = await fetch('https://grudge-studio.github.io/ObjectStore/api/v1/weapons.json');
const weapons = await response.json();

// Example: Get all T8 swords
const t8Swords = weapons.categories.swords.items.map(w => ({
  id: `${w.id}-t8`,
  name: `${w.name} T8`,
  stats: { primary: w.primaryStat, secondary: w.secondaryStat }
}));

🗄️ Database Schema (Supabase)

For authorized access to player data:

// Schema: studio_core (shared across games)
- accounts       // User accounts, auth
- sessions       // Active sessions
- api_keys       // Studio API keys

// Schema: warlord_crafting (Grudge Warlords)
- characters     // Player characters
- inventory_items
- crafted_items
- islands
- battle_history

📚 Links