🎨 Sprite Database

Browser / Vanilla JS

const BASE = 'https://molochdagod.github.io/ObjectStore';

// Fetch all swords
const weapons = await fetch(`${BASE}/api/v1/weapons.json`).then(r => r.json());
const swords = weapons.categories.swords.items;

// Get icon URL by slug
const iconUrl = `${BASE}/icons/weapons_full/Sword_01.png`;

// Resolve sprite from sprites.json
const sprites = await fetch(`${BASE}/api/v1/sprites.json`).then(r => r.json());
const armorIcons = sprites.categories.armor_full.sprites;

NPM / Node.js

import { initGrudgeStudio } from '@grudgstudio/core';

const api = await initGrudgeStudio({
  objectStoreUrl: 'https://molochdagod.github.io/ObjectStore'
});

// Search by name or slug
const results = await api.search('bloodfeud');

// Create tracked item with UUID
const item = api.createItem({
  type: 'weapon', name: 'Bloodfeud Blade', tier: 5
});
console.log(item.uuid); // ITEM-2026...-...-...
console.log(item.slug); // swords/bloodfeud-blade/t5

Unity C#

using GrudgeStudio;

var api = new GrudgeStudioAPI(
  "https://molochdagod.github.io/ObjectStore"
);

// Load weapon by slug
var sword = await api.GetWeapon("swords/bloodfeud-blade");
Debug.Log(sword.name); // Bloodfeud Blade

// Load sprite texture
var tex = await api.LoadIcon("weapons_full/Sword_01.png");
renderer.sprite = Sprite.Create(tex, ...);

GDevelop / HTML5 Game

// In GDevelop JavaScript event
const BASE = 'https://molochdagod.github.io/ObjectStore';

// Load enemy data for spawning
const enemies = await fetch(`${BASE}/api/v1/enemies.json`)
  .then(r => r.json());

// Get boss by slug
const boss = enemies.categories.dragons
  .items.find(e => e.id === 'fire-dragon');

// Use sprite path directly in Sprite object
const spriteSrc = `${BASE}/icons/weapons_full/Axe_03.png`;

✅ Always use slugs as keys

Reference items by category/item-id slug, never by display name. Slugs are stable across data updates; names may change.

✅ Cache API responses

JSON files are static and change only on repo pushes. Cache with localStorage or IndexedDB. Use If-None-Match headers to avoid re-downloading.

✅ Use GRUDGE UUIDs for persistent entities

Player inventory, crafted items, and hero instances must use UUIDs. Slugs identify definitions; UUIDs identify instances.

✅ Tier-aware icon loading

Weapon icons cycle through weapons_full/{Type}_{NN}.png. Use the iconBase and iconMax fields from each weapon category to resolve the correct icon file.

✅ Sprites are pixelated — use CSS

Always apply image-rendering: pixelated to all sprite <img> elements. In Unity, set Filter Mode to Point (no filter).

❌ Don't hardcode icon paths

Icon paths may change when new sprites are added. Always resolve paths from sprites.json or use the SDK's icon resolver methods.

❌ Don't fetch all endpoints on page load

Lazy-load data by category. Weapons alone is ~800+ items × 8 tiers. Use the SDK's search() to find specific items instead of loading entire catalogs.

📎 Cross-project slug registry

ObjectStore slugs are the single source of truth for item definitions across all 35+ Grudge Studio repos. When adding items to GRUDA-Wars, GDevelop games, or the Warlord Crafting Suite, always reference ObjectStore slugs.