OriginStory — Game Database

Items

ID	Name	Type	Description	Properties	Model	Cooldown (s)	Sell Price	Max Stack	LClick Ability	RClick Ability

NPCs

ID	Name	Type	Model	Scale	Dialogue

Enemy Types

ID	Name	Type	HP	Starting Level	Props

Abilities

ID	Name	Description	Icon	Type	Cooldown (s)	Cost	Size	Properties

Loot Tables

ID	Enemy Type	Item ID	Item	Drop Chance	Min Qty	Max Qty

Shop Items

Admin Tools

Browse procedural 3D models. Click a weapon/item model to view and edit mapped items.

GLTF Asset Status

Shows whether GLB model files are present on the server. Drop .glb files into /assets/models/ to replace procedural geometry.

Control which database pages are visible to non-admin users.

Constrain camera distance and/or pitch for all connected clients. Changes are broadcast live via WebSocket.

Constrain distance

Min

Max

units

Constrain pitch

Min

Max

rad

Terminology glossary and system architecture map. Shows how Claude and the codebase understand game concepts.

Terminology Glossary

Canonical Term	Also Known As	DB Table	Code Location
Enemy	mob, monster, creature	`enemies`	`js/engine/enemy.js`
NPC	shop, shopkeeper, vendor, quest giver	`npcs`	`js/engine/world.js`
Item	gear, equipment, loot, drop	`items`	`js/ui/inventory.js`
Ability	skill, spell, attack, action	`abilities`	`js/engine/combat.js`
Zone	area, map, level, world	`api/world.php`	`js/engine/world.js`
Loot Table	drop table, drop rates	`loot_tables`	`js/engine/enemy.js`
Inventory	bag, backpack, slots	`inventory`	`js/ui/inventory.js`
Equipment	gear, loadout, paper doll	`equipment`	`js/ui/inventory.js`
Player	character, hero, avatar	`characters`	`js/player/player.js`
Shop Item	vendor item, buyable, purchasable	`shop_items`	`js/ui/hud.js`
Quest	mission, task, objective	`quests`, `npc_quests`	`js/ui/dialogue.js`

System Architecture Map

┌─────────────────────────────────────────────────────────────────┐
│                        CLIENT (Browser)                         │
│                                                                 │
│  index.html ──► js/main.js (game loop, state machine)          │
│                    │                                            │
│       ┌────────────┼────────────┬──────────┬──────────┐        │
│       ▼            ▼            ▼          ▼          ▼        │
│  js/engine/    js/player/    js/ui/     js/net/    js/engine/  │
│  renderer.js   player.js    hud.js     api.js     combat.js   │
│  world.js      camera.js    inventory  autosave   enemy.js    │
│  physics.js                 chat.js               loader.js   │
│  input.js                   menu.js                           │
│                                                                 │
│  WebSocket ◄──► js/net/multiplayer.js                          │
└─────────┬───────────────────────────────┬───────────────────────┘
          │ REST API                      │ WebSocket (port 8081)
          ▼                               ▼
┌─────────────────────┐    ┌──────────────────────────────┐
│   PHP 8.4 Backend   │    │    Node.js WS Server         │
│                     │    │    server/ws-server.js        │
│  api/auth.php       │    │                              │
│  api/player.php     │    │  - Player position sync      │
│  api/inventory.php  │    │  - Server-side enemy AI      │
│  api/world.php      │    │  - PvE/PvP combat            │
│  api/database.php   │    │  - Chat relay                │
│  api/config.php     │    │  - Admin broadcasts          │
└────────┬────────────┘    └──────────────┬───────────────┘
         │                                │
         ▼                                ▼
┌─────────────────────────────────────────────────────────┐
│                    MySQL 8.4 Database                    │
│                                                         │
│  users ──► characters ──► inventory                     │
│                              │                          │
│  items ◄─────────────────────┘                          │
│    │                                                    │
│    ├──► abilities (left/right click links)              │
│    └──► shop_items (price = item_id + amount)           │
│                                                         │
│  enemies ──► loot_tables ──► items                      │
│  npcs ──► shop_items                                    │
│  npcs ──► npc_quests ──► quests ──► quest_progress      │
└─────────────────────────────────────────────────────────┘

Data Flow Patterns

Flow	Path
Login	Discord OAuth → `api/auth.php` → PHP session → client
Zone Load	`api/world.php` → terrain + objects + NPCs + enemies + abilities
Combat (SP)	click → `combat.js` → `enemy.takeDamage()` → loot roll → inventory
Combat (MP)	click → WS `enemy:attack` → server validates → `enemy:hit` broadcast
Equip	dblclick/drag → `api/inventory.php?action=equip` → DB move → reload
Shop Buy	click → `api/inventory.php?action=buy` → DB transaction → reload
Auto-save	every 30s → `api/player.php` PUT → position/health/zone
Enemy Leash	player moves > 3x aggro range → enemy returns to spawn + regens

Item ↔ Ability Linking

items.left_click_ability_id  ──► abilities.id (M1 action)
items.right_click_ability_id ──► abilities.id (M2 action, fallback to M1)

Final damage = ability.properties.damage + item.properties.damage
Final cooldown = ability.cooldown / item.properties.speed
Final range = ability.size + item.properties.range

Compose procedural 3D models from primitive shapes. Load existing models for reference or build from scratch.

Load Template

Parts

No parts. Click + Add to begin.

Properties

Save Model

Export