Numerology Wars

wars.tribewarez.com

An MMO real-time strategy game where players control fleets in a galaxy shaped by numerology. Birth dates determine powers and abilities -- life path, destiny, and soul numbers affect ship stats, combat bonuses, and faction alignment.

Gameplay

Core Mechanics

• Fleet control -- build and command ships across a space map
• Combat -- real-time PvP and PvE battles
• Resource gathering -- mine and refine materials
• Numerology powers -- stats derived from life path, destiny, and soul numbers
• Master numbers -- 11, 22, and 33 grant special abilities

Hub Areas

Area	Purpose
Market	Buy and sell resources
Equipment Shop	Purchase ship upgrades and gear
Refinery	Process raw materials
Hangar	Manage and equip ships
Combat Zone	Enter PvP and PvE arenas

Progression

• Missions -- quest chains with XP and resource rewards
• Achievements -- tracked goals that unlock bonuses
• Leveling -- XP-based progression unlocking new ships and abilities

Architecture

Component	Stack	Role
client	Next.js 14, React 18, TypeScript, Tailwind	Game frontend with space map and hub UI
server	Express, Socket.IO, TypeScript	Game logic, real-time multiplayer, auth
database	PostgreSQL	Users, players, ships, missions, achievements

Real-Time Multiplayer

The server uses Socket.IO for real-time game state synchronization:

• Player movement and fleet positioning
• Combat events and damage calculations
• Resource updates and market transactions
• Chat and player interactions

Game Engine

Server-side modules:

Module	File	Purpose
Game Engine	gameEngine.ts	Core game loop and state management
Numerology Engine	numerologyEngine.ts	Life path / destiny / soul calculations
Mission System	missionSystem.ts	Quest tracking and rewards
Achievement System	achievementSystem.ts	Goal tracking and unlock logic

Client State

The frontend uses Zustand for client-side game state (gameStore.ts), synchronized with the server via Socket.IO events.

Tech Stack

Layer	Technology
Frontend	Next.js 14, React 18, TypeScript
State	Zustand
UI	Tailwind CSS
Multiplayer	Socket.IO (client + server)
Backend	Express, TypeScript
Database	PostgreSQL
Auth	JWT, bcrypt

Relation to PoT-O & RPC Proposals

Numerology Wars can optionally integrate PoT-O-derived tokens and DeFi primitives:

• Accept PTtC/NMTC for cosmetic or progression-related purchases, treating them as tokens minted and distributed according to PoT-O (TW-RPC-001) and staking/vault RFCs (TW-RPC-003/004).
• Surface staking- or vault-based benefits (for example, boosts for stakers or treasury-funded tournaments) using on-chain state from the tribewarez-staking and tribewarez-vault programs.
• Reference the PoT-O RFC Series and Implementation Mapping to ensure on-chain program IDs and economics match the core standards.

Docker

The project includes a full docker-compose.yml:

Service	Purpose
postgres	PostgreSQL database
backend	Express + Socket.IO server
frontend	Next.js client
nginx	Reverse proxy

A manage.sh script provides shortcuts for development, production, migrations, logs, and cleanup.

Database Schema

Key tables:

• users -- accounts, credentials, sessions
• players -- game profiles, numerology data, stats
• ships -- fleet inventory, equipment, upgrades
• missions -- quest definitions and player progress
• achievements -- goal definitions and completion state