← Back to Hub

Items & System Guide

How items, tiers, artifacts, tomes, and the crafting system fit together in Grudge Warlords. Every item below lives under the same UUID in ObjectStore and is served to every Grudge Studio game.

One Source of Truth

Every item and icon in Grudge Warlords lives in ObjectStore - the shared backend used by all Grudge Studio games. This page is a per-game view; it does not store item data. When ObjectStore updates, this page picks the changes up automatically.

Canonical The ItemBrowser on ObjectStore is the source of truth for item names, categories, and icons. The master-* JSONs served here are derived from api/v1/weapons.json, armor.json, materials.json, and consumables.json - the same files ItemBrowser reads. Missing or placeholder icons are filled through the Icon Generator (Puter AI) and land back in the same canonical set.

ObjectStore

/api/v1/master-*.json
Items, recipes, materials, artifacts.

Data Hub (this site)

Prefetches at build, revalidates at runtime.

Game Clients

grudgewarlords.com, client.grudge-studio.com, and every other Grudge game.

Tier System (T1 - T8)

Tiers scale craftable items. Every base weapon expands into all 8 tiers with scaling stats. "Legendary" now means T8 only - the old T5 label was renamed to Heroic.

T1 Common

Starter gear. Craftable with basic materials.

T2 Uncommon

Slight stat upgrade. Early progression.

T3 Rare

Notable stat jump. Mid-game.

T4 Epic

Strong items with special properties.

T5 Heroic

End-game crafts and rare drops.was "Legendary"

T6 Mythic

Faction-specific high-end gear.

T7 Ancient

Ancient relics with unique abilities.

T8 Legendary

Apex of the crafting track.was "Legendary Artifact"

Naming Rules (reserved words)

Certain words now have exactly one meaning in the data. Do not reuse them as lore names, flavor descriptors, or category slugs.

WordMeansRule
LegendaryT8 tier label on tiered items.Never used as a category or weapon-type name.
HeroicT5 tier label on tiered items.Replaces the old "T5 Legendary" label; the word "Legendary" is reserved for T8.
ArtifactWeapon category for end-game, world-found items.Not a tier label. Never appears in the tier string.
ArcaneA spell school AND an artifact sub-type (artifact-arcane).No longer names a weapon class. The old arcaneStaves slot is now artifact.

Item Categories

Weapons (tier-expanded, craftable)

Swords 1hMiner

Balanced 1h blades. Sign each with a bespoke slug icon.

Axes 1hMiner

Chopping damage with bleed and stun patterns.

Daggers 1hMiner

High crit, low armor. Rogue-adjacent combos.

Maces 1hMiner

Stun, armor-break, crush effects.

Hammers 2hMiner

Slow heavy AoE. Ground control.

Greatswords 2hMiner

Wide arcs, moderate speed, sustained damage.

Greataxes 2hMiner

High burst + bleed, slower recovery.

Spears 2hMiner

Range, thrust, gap-closing charge.

Shields offhandMiner

Block-focused. Pairs with 1h main-hand.

Bows 2hForester

Wooden-ranged damage. Scaled with sinew and hardwood.

Crossbows 2hEngineer

Heavy bolt damage, mechanical feel.

Guns 2hEngineer

Powder firearms. Single-target high crit.

Fire Staves 2hMystic

Burn stacks, fire AoE.

Frost Staves 2hMystic

Chill, slow, deep freeze.

Holy Staves 2hMystic

Heals, cleanses, divine shields.

Lightning Staves 2hMystic

Chain lightning, stun, burst.

Nature Staves 2hMystic

HoT, reflect, entangle.

Wands 1hMystic

One-hand caster mainhand. Pairs with tome or off-hand relic.

Scythes 2hForester

Reaping arcs with bleed and cleave. Worge-favoured 2h melee.

Off-Hand Relics offhandMystic

Caster off-hand. Bonus to spell crit, mana, and school mastery.

Off-hand utility

Tomes offhandno tier

Tomes are tier-less off-hand items. Equipping a tome while wielding a 1h main-hand (sword, axe, dagger, mace, pistol) grants that main-hand new spell-cast options drawn from the tome's school.

type: "offhand-tome" · skillGrants: [...] · No stat block.

Artifacts (end-game, world-found)

Artifact worldhidden

Artifacts are end-game items with fixed stats and no craft recipe. They are discovered in the world: boss drops, raid vaults, world reveals, or quest completions. Player-facing UIs filter out artifacts with discovery.hiddenUntilFound: true until the player has found them.

First sub-type: artifact-arcane (the old arcaneStaves slot). Future sub-types reserved: storm, blood, frost, ember, nature, holy, void.

Consumables & Materials

Food Chef

Red / Green / Blue food colors. Buffs scale with level.

Potions Mystic

Restores, resistances, and short-duration buffs.

Materials gather

Ore, ingots, logs, cloth, leather, essence, gem, herb. Each tier has its own material tree.

Artifact Discovery Rules

Rule Undiscovered artifacts must not leak into player-facing UIs. The discovery block on each artifact includes hiddenUntilFound, source, and revealCondition. Client code checks a player's discovered-artifact set before rendering an artifact anywhere a player can see. Admin tools bypass this filter.

API Endpoints (from ObjectStore)

GET/api/v1/master-items.jsonAll tier-expanded items with GRUDGE UUIDs
GET/api/v1/master-recipes.jsonCraft recipes with material links
GET/api/v1/master-materials.jsonCrafting materials
GET/api/v1/master-artifacts.jsonArtifact catalog with discovery blocks
GET/api/v1/master-registry.jsonCombined UUID->entity index
GET/api/v1/master-attributes.json8 attributes + 37 derived stats

Base URL: https://assets.grudge-studio.com. This site revalidates these files at runtime; edits in ObjectStore appear here without redeploy.

Item Record Shape

FieldUsed byNotes
uuidEveryonePrimary key. Prefix: ITEM-.
baseUuidTier expansionsPoints to the T1 row for a tier-expanded weapon.
slugIcon resolverUsed to look up /icons/weapons/<slug>.png first, then pack fallback.
categoryUIs, filtersswords, axes, ..., offhand-tome, artifact.
typeRender logicweapon | armor | food | potion | offhand-tome | artifact.
tier / tierLabelUIsNull for artifacts and tomes. See tier table above.
sourceCrafting UIscraft | world-drop | boss | quest | raid | world.
discoveryArtifacts only{ hiddenUntilFound, source, revealCondition }.
skillGrantsTomes onlyList of spells added to the 1h main-hand when equipped.
foldsInLegacyStarter itemsOld Unity / Steam item IDs absorbed into this starter (documentation only).