Economy

​

Overview

​

Currency

• Dropped by all mobs
• Used to purchase from shops
• Stackable in inventory

​

Inventory

​

Configuration

// From packages/shared/src/constants/GameConstants.ts
export const INVENTORY_CONSTANTS = {
  MAX_INVENTORY_SLOTS: 28,
  MAX_BANK_SLOTS: 100,
  MAX_STACK_SIZE: 1000,
  DEFAULT_ITEM_VALUE: 1,
} as const;

​

Capacity

• 28 slots in active inventory (RuneScape-style)
• 100 slots in bank storage
• 1000 max stack for stackable items
• Items must be managed carefully
• Stackable items (coins, arrows) share a slot

​

Item Properties

​

Banking

​

Features

• Unlimited storage slots
• Accessible at bank locations in starter towns
• Each bank is independent (no shared storage)

​

Operations

• Deposit: Move items from inventory to bank
• Withdraw: Move items from bank to inventory
• Organize: Drag to rearrange

​

Shops

​

General Store

​

Shop Mechanics

• Stock replenishes over time
• Prices are fixed
• Sell items back for reduced value

​

Loot Drops

​

Mob Drops

​

Drop Tables

// From packages/shared/src/data/npcs.ts (lines 107-149)
export function calculateNPCDrops(
  npcId: string,
): Array<{ itemId: string; quantity: number }> {
  const npc = getNPCById(npcId);
  if (!npc) return [];

  const drops: Array<{ itemId: string; quantity: number }> = [];

  // Add default drop if enabled
  if (npc.drops.defaultDrop.enabled) {
    drops.push({
      itemId: npc.drops.defaultDrop.itemId,
      quantity: npc.drops.defaultDrop.quantity,
    });
  }

  // Roll for drop tiers: always, common, uncommon, rare, veryRare
  npc.drops.always.forEach(processDrop);
  npc.drops.common.forEach(processDrop);
  npc.drops.uncommon.forEach(processDrop);
  npc.drops.rare.forEach(processDrop);
  npc.drops.veryRare.forEach(processDrop);

  return drops;
}

​

Economy Flow

​

Item Tiers

​

Weapons

​

Armor

​

Bows

​

Player Trading

​

Trade System

​

Initiating a Trade

1. Right-click another player
2. Select “Trade with [Player Name]”
3. If not adjacent, your character walks to them automatically
4. Trade request appears as pink clickable chat message

​

Trade Flow

• Add items by left-clicking inventory items (adds 1)
• Right-click for context menu: Offer-1, Offer-5, Offer-10, Offer-X, Offer-All
• Remove items by clicking them in your trade offer
• Both players must accept to proceed

• Final review of both offers
• Wealth transfer indicator shows value difference
• Both players must accept again to complete
• Trade executes atomically (no item duplication possible)

​

Anti-Scam Features

​

Security

• Server-authoritative state management
• Atomic database transactions
• Inventory locks during swap
• Proximity validation (must be adjacent)
• Rate limiting on requests
• Tradeable flag enforcement

​

Future Features