Complete Game Systems Guide
Updated: January 31, 2026 - Corrected with actual codebase data
Your character is defined by 8 attributes that determine combat effectiveness, survivability, and playstyle. Each attribute provides specific per-point bonuses detailed below.
Note: All percentage values are shown per point invested. Total points available: 160
Role: Tank / Melee DPS
Description: Physical might and raw power. Increases raw damage output, physical defense, and health. Warriors and melee builds scale heavily with Strength. Each point grants diminishing returns on damage beyond 50 points.
Per-Point Bonuses:
Role: Mage / Caster
Description: Mental acuity and spellcasting power. Powers magical damage, mana regeneration, and ability cooldown reduction. Casters scale directly with Intellect. High Intellect reduces spell cast times by 0.2% per point. Countered heavily by Resistance.
Per-Point Bonuses:
Role: Tank / Survivability
Description: Physical endurance and life force. Maximizes health pool and provides passive health regeneration. Vital for tanks and sustained damage builds. Very effective against burst damage, but weak to percentage-based damage abilities.
Per-Point Bonuses:
Role: Rogue / Precision Fighter
Description: Hand-eye coordination and finesse. Dominates critical chance, attack speed, and accuracy. Rogues and archers scale with Dexterity. Provides attack speed bonus (0.4% per point). Critical hits bypass 40% of block chance.
Per-Point Bonuses:
Role: Defensive Specialist
Description: Stamina reserves and physical resistance. Builds stamina for abilities and provides armor scaling. High Endurance enables higher block effectiveness and reduces crowd control duration. Synergizes with blocking playstyles.
Per-Point Bonuses:
Role: Healer / Support / Magic Tank
Description: Mental fortitude and magical resilience. Primary counter to magical damage. Scales resistance and provides magic immunity scaling. Each point provides 0.4% Cooldown Reduction Resistance (slows enemy cooldown reduction). Essential for magic-heavy environments.
Per-Point Bonuses:
Role: Mobile DPS / Dodge Tank
Description: Speed, reflexes, and positioning. Increases movement speed, dodge chance, and evasion. Synergizes with high-risk playstyles. Each point grants 0.3% movement speed. Dodge provides invincibility frames (0.5s per dodge).
Per-Point Bonuses:
Role: Strategic Fighter / Commander
Description: Expertise in ability execution and resource management. Tactics grants a scaling bonus to all other stats based on total invested points (0.5% per point). High Tactics reduces ability costs, cooldowns, and provides armor penetration. Counters enemy Defense and Block. Essential for versatile builds.
Per-Point Bonuses:
Special Mechanic: Tactics provides a 0.5% multiplicative bonus to ALL non-resource stats per point invested. This means with 40 Tactics, you get +20% to all combat stats (excluding Health, Mana, Stamina).
Choose your faction allegiance through your race selection. Each faction represents a different philosophy and playstyle.
Description: Versatile and adaptable, humans excel in any role
Attribute Bonuses: +1 Strength, +1 Intellect, +1 Wisdom, +2 Tactics
Traits:
Description: Savage warriors of the frozen north who fight for honor
Attribute Bonuses: +3 Strength, +2 Vitality, +2 Endurance
Traits:
Description: Sturdy and resilient, dwarves are master craftsmen and ancient warriors
Attribute Bonuses: +2 Strength, +3 Vitality, +3 Endurance
Traits:
Description: Ancient and wise, elves possess innate magical abilities
Attribute Bonuses: +3 Intellect, +2 Wisdom, +2 Dexterity
Traits:
Description: Brutal and fearless, orcs live for battle and glory
Attribute Bonuses: +4 Strength, +2 Vitality, +1 Endurance
Traits:
Description: Neither living nor dead, undead persist through sheer will
Attribute Bonuses: +2 Vitality, +3 Endurance, +2 Wisdom
Traits:
| Class | Archetype | Primary Attributes | Starting Bonuses | Abilities |
|---|---|---|---|---|
| ⚔️ Warrior | Tank | Strength, Vitality, Endurance | +3 STR, +2 VIT, +1 END | Shield Bash, Battle Cry, Charge, Last Stand |
| 🐺 Worg | DPS | Strength, Agility, Vitality | +2 STR, +2 AGI, +2 VIT | Savage Bite, Howl, Pack Hunt, Feral Rage |
| 🔥 Mage | DPS | Intellect, Wisdom, Tactics | +3 INT, +2 WIS, +1 TAC | Fireball, Ice Storm, Arcane Blast, Meteor |
| 🏹 Ranger | DPS | Dexterity, Agility, Wisdom | +2 DEX, +2 AGI, +2 WIS | Aimed Shot, Multi-Shot, Traps, Beast Companion |
Pre-configured heroes for quick start, each optimized for their role with level 5 stats and Tier 2 equipment.
Title: The Mountain Guardian
Race/Class: Dwarf Warrior
Role: Tank - High defense, blocks damage, protects team
Attributes: 12 STR, 14 VIT, 13 END, 4 INT, 5 WIS, 6 DEX, 5 AGI, 8 TAC
Professions: Mining, Blacksmithing, Engineering
Title: The Storm Weaver
Race/Class: Elf Mage
Role: Ranged Magic DPS - High burst damage, area effects
Attributes: 4 STR, 7 VIT, 5 END, 15 INT, 12 WIS, 6 DEX, 6 AGI, 8 TAC
Professions: Herbalism, Alchemy, Jewelcrafting
Title: The Shadow Blade
Race/Class: Human Rogue
Role: Agile Melee DPS - High crits, evasion, burst damage
Attributes: 8 STR, 8 VIT, 6 END, 6 INT, 5 WIS, 15 DEX, 14 AGI, 11 TAC
Professions: Skinning, Tailoring, Engineering
Title: The Sacred Flame
Race/Class: Human Cleric
Role: Support/Healer - Sustain team, buff allies, light offense
Attributes: 6 STR, 10 VIT, 8 END, 10 INT, 15 WIS, 6 DEX, 7 AGI, 10 TAC
Professions: Herbalism, Alchemy, Cooking
Stat Caps (Diminishing Returns): The game uses a sophisticated diminishing returns system to prevent stat stacking
Every character starts with these base values before any attribute bonuses:
| Stat | Base Value | Description |
|---|---|---|
| Health | 250 | Hit points |
| Mana | 100 | Energy for abilities |
| Stamina | 100 | Fuel for physical actions |
| All Other Stats | 0 | Built entirely from attributes |
Combat Power is a composite score that evaluates overall character strength. It's calculated using:
// Effective Health Pool (EHP)
EHP = Health × (1 + Defense/100) × (1 + Resistance/100)
// Damage Per Second (DPS) Factor
DPS = (Damage + 10) × (1 + (CritChance/100) × (CritDmg/100)) × (1 + AttackSpeed/100)
// Utility Factor
Utility = (CDR × 2) + (ManaRegen × 10) + (MoveSpeed × 2)
// Final Combat Power
Combat Power = floor(EHP × 0.4 + DPS × 2.5 + Utility × 5)
Builds are ranked from F to S+ based on Combat Power and synergy:
Synergy Bonus: Characters get up to +20 points for investing heavily in complementary stat combinations:
Characters are classified into tiers based on their overall build quality (Rank 1-300):
| Tier | Rank Range | Description | Examples |
|---|---|---|---|
| Legendary | 1-10 | Mythical power achieved through perfect synergy | Primordial God-King, Eternal Void Walker |
| Warlord | 11-50 | A dominant force on the battlefield | Solar Walker Warlord, Chaos Weaver Warlord |
| Epic | 51-100 | A hero of renown and great skill | Epic Void Slayer, Epic Storm Sage |
| Hero | 101-200 | A capable adventurer with potential | Fire Blade, Wind Walker |
| Normal | 201-300 | A standard combatant | Novice Guard, Novice Shield |
Max Level: 100
Starting Attributes: Base 5 in all stats + Race bonuses + Class bonuses
Attribute Points: Total of 160 points to distribute across all 8 attributes
Attribute Points: Gained through leveling (check statCalculator for exact formulas)
Each character can have an AI-generated personality that influences their chat responses and behavior:
Base Damage = (Attacker Stat × 2) + Weapon Damage
Variance = Base × (0.9 to 1.1)
Critical = Variance × 1.5 (if crit)
Defense Mitigation = Critical - (Defender Defense × 0.5)
Final Damage = Max(Defense Mitigation, 1)
Each weapon type has individual mastery levels:
4 skill slots per weapon type:
Skill Points: Earned 1 per level (starting with 1 at creation)
Tiers: Skills organized in 10 tiers
Requirements: Must unlock lower tiers before accessing higher tiers
Selections: Stored by tier level in character data
| Status | Effect | Duration |
|---|---|---|
| 🔥 Burning | DoT: 5% max HP per turn | 3 turns |
| ❄️ Frozen | Cannot act, take 150% damage | 2 turns |
| ⚡ Stunned | Skip turn | 1 turn |
| 🛡️ Shield | Absorb damage | 3 turns or until broken |
| 💪 Strength Up | +30% physical damage | 5 turns |
| Tier | Quality | Example Materials | Item Level |
|---|---|---|---|
| T0 | Starter | Wood Plank, Stone, Basic Cloth | 1-5 |
| T1 | Common | Iron Ore, Oak Wood, Wool | 5-15 |
| T2 | Uncommon | Steel, Ash Wood, Linen | 15-25 |
| T3 | Rare | Mithril, Yew Wood, Silk | 25-40 |
| T4 | Epic | Adamantite, Ironwood, Shadowsilk | 40-55 |
| T5 | Legendary | Orichalcum, Ancient Oak, Moonweave | 55-70 |
| T6 | Mythic | Starsteel, Worldtree Wood, Voidsilk | 70-85 |
| T7 | Divine | Celestial Ore, Phoenix Wood, Aetherweave | 85-95 |
| T8 | Godly | Godmetal, Infinity Wood, Reality Fabric | 95-100 |
Resources: Ore, Stone, Gems, Crystals
Stat Gains: +STR (primary), +VIT (secondary)
Feeds: Miner (weapons/armor), Engineer (guns)
T8 Resources: Godmetal, Worldcore Gem
Resources: Wood, Bark, Resin
Stat Gains: +STR, +VIT (balanced)
Feeds: Forester (bows/leather), Engineer
T8 Resources: Worldtree Wood, Phoenix Bark
Resources: Herbs, Flowers, Roots, Berries
Stat Gains: +INT (primary), +VIT (secondary)
Feeds: Mystic (potions), Chef (food buffs)
T8 Resources: Celestial Lotus, Void Blossom
Resources: Fish, Pearls, Shells
Stat Gains: +DEX (primary), +VIT (secondary)
Feeds: Chef (food buffs)
T8 Resources: Leviathan Meat, Abyssal Pearl
Resources: Leather, Hide, Bone, Fat
Stat Gains: +DEX, +STR, +VIT
Feeds: Forester (leather armor)
T8 Resources: Dragon Scale, Phoenix Feather
Crafts metal weapons and armor
Skill Trees: Weaponsmithing, Armorsmithing, Alloy Mastery
Crafts bows, crossbows, and leather armor
Skill Trees: Bowcraft, Leatherworking, Woodworking
Crafts staves, enchantments, and potions
Skill Trees: Enchanting, Alchemy, Spellweaving
Crafts food buffs and consumables
Skill Trees: Cooking, Brewing, Butchery
Crafts guns and mechanical devices
Skill Trees: Weaponry, Automata, Siege Engineering
| Rarity | Spawn % | Max Harvests | Yield | XP | Stat Gains |
|---|---|---|---|---|---|
| Common | 70% | 3 | 1.0x | 1.0x | 1.0x |
| Rare | 20% | 5 | 1.5x | 1.5x | 1.25x |
| Epic | 8% | 8 | 2.0x | 2.0x | 1.5x |
| Legendary | 2% | 12 | 3.0x | 3.0x | 2.0x |
Level 1-50: Easy (100 × level XP per level)
Level 51-90: Medium (300 × level XP per level)
Level 91-100: Hard (1000 × level XP per level)
Decay System: 18-hour grace period, decays to level 50 minimum over 21 days
📊 AFK Session Summary (2 Hours)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Resources Gained:
• 156x Iron Ore
• 89x Oak Wood
• 67x Moonleaf
• 12x Sapphire (Rare)
• 3x Mithril Ore (Legendary!)
📈 Profession XP:
• Mining: +480 XP (Level 35 → 36)
• Logging: +360 XP
• Herbalism: +520 XP (Level 42 → 43)
💪 Stat Gains:
• Strength: +2.4
• Dexterity: +0.8
• Intellect: +1.6
• Vitality: +1.2
🌟 Notable Events:
• Legendary Mithril Ore (3x) from Ancient Vein
• Critical gather! 12x Sapphire from Rare Gem Deposit
| Level Range | Title | Harvest Speed | Bonus Resources | Stat Gains | Special |
|---|---|---|---|---|---|
| 1-20 | Novice → Apprentice | +10-20% | +1-2 | +0.01-0.02 | - |
| 20-50 | Journeyman → Artisan | +20-50% | +2-5 | +0.03-0.06 | 10-25% rare chance |
| 50-100 | Master → Legendary | +50-65% | +5-10 | +0.06-0.11 | 35% crit, 25% gear drop |
Primary: OpenAI GPT-4
Secondary: Anthropic Claude (optional)
Image Generation: DALL-E / Stable Diffusion
Vision: GPT-4 Vision API
Characters have adjustable chat temperature (0-100):
Background AI workers handle:
Crossmint enables gasless NFT minting with email-based wallets:
{
"name": "Warrior Hero #1234",
"description": "Level 45 Human Warrior",
"image": "https://...",
"attributes": [
{ "trait_type": "Level", "value": 45 },
{ "trait_type": "Class", "value": "Warrior" },
{ "trait_type": "Race", "value": "Human" },
{ "trait_type": "Strength", "value": 85 },
{ "trait_type": "Vitality", "value": 72 }
]
}
GbuX Token: Premium in-game currency
npm run checknpm run buildnpm run db:push# Railway Auto-Provides:
PORT=8080
DATABASE_URL=postgresql://...
# You Must Add:
NODE_ENV=production
SESSION_SECRET=your-random-64-char-string
# Optional (if using features):
OPENAI_API_KEY=sk-...
CROSSMINT_API_KEY=...
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
Already Configured: Your project includes vercel.json with optimal settings
VITE_API_URL=https://your-backend.railway.app
VITE_ASSET_CDN_URL=https://molochdagod.github.io/grudge-studio-auth/assets
Current Setup: GitHub Pages hosts static assets (sprites, images)
Migration Available: Scripts provided for Puter Cloud or Google Cloud Storage
| Issue | Cause | Solution |
|---|---|---|
| ❌ CORS errors | Backend not in CORS allowlist | Add frontend URL to server CORS config |
| ❌ Database connection failed | Wrong DATABASE_URL or SSL issue | Verify connection string, enable SSL if required |
| ❌ Build failed | Missing dependencies or env vars | Check logs, ensure all deps installed |
| ❌ Session not persisting | Wrong SESSION_SECRET or store config | Use PostgreSQL session store (connect-pg-simple) |
| ❌ 502 Bad Gateway | Backend not listening on correct port | Use process.env.PORT (Railway/Render provide this) |
GET /api/health returns 200Warlord-Crafting-Suite/
├── client/ # React frontend (Vite)
│ ├── src/
│ │ ├── pages/ # 30+ route pages
│ │ ├── components/ # UI components
│ │ ├── lib/ # Utilities & API client
│ │ ├── contexts/ # React contexts
│ │ └── hooks/ # Custom hooks
│ └── public/ # Static assets
│
├── server/ # Express backend
│ ├── index.ts # Server entry
│ ├── routes/ # API routes
│ ├── services/ # Business logic
│ └── lib/ # Server utilities
│
├── shared/ # Shared code
│ ├── schema.ts # Database schema
│ ├── definitions/ # Game data
│ ├── gameDefinitions/ # Game rules
│ └── utils/ # Shared utilities
│
└── docs/ # Documentation
| Table | Purpose | Key Fields |
|---|---|---|
| users | Authentication | id, username, password, walletAddress |
| accounts | Cross-character data | userId, gold, premiumCurrency, avatarUrl |
| characters | Player characters | name, raceId, classId, level, attributes, inventory |
| parties | Party composition | userId, characterIds (max 3) |
| resource_nodes | Island nodes | userId, nodeId, lastGathered |
| player_resources | Resource inventory | userId, resources (JSONB) |
| dungeon_runs | Active dungeons | userId, dungeonId, partyState, status |
| combat_logs | Combat history | dungeonRunId, participants, actions, result |
Custom Grudge UUID Format:
SLOT-TIER-ITEMID-TIMESTAMP-COUNTER
Example: helm-t5-0042-121530092026-000abc
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Run migrations
npm run db:push
# Start dev servers
npm run dev
# Frontend: http://localhost:5000
# Backend: http://localhost:3000
| Feature | Status | Completion |
|---|---|---|
| Character System | ✅ Complete | 100% |
| Inventory Management | ✅ Complete | 100% |
| Crafting System | ✅ Complete | 100% |
| Skill Trees | ✅ Complete | 100% |
| Authentication | ✅ Complete | 100% |
| Sprite Generation | ✅ Complete | 100% |
| Admin Dashboard | ✅ Complete | 95% |
| API Client | ✅ Complete | 100% |
| Island System | ✅ Complete | 90% |
| Profession System | 🚧 In Progress | 85% |
| Grudge Builder | 🚧 In Progress | 30% |
| Multiplayer | 📅 Planned | 0% |
Status: Production Ready
Last Updated: January 2026