1. Introduction

Circle RPG is a browser-based 3D multiplayer RPG built on BNB Smart Chain. Players explore an open world, fight monsters in real-time combat, complete quests, and earn $RPG tokens through gameplay. The game runs entirely in the browser with no downloads required.

The project combines proven game engine technology (Babylon.js 8.28) with real-time multiplayer networking (Colyseus 0.15) and blockchain token integration on BSC. The game features a persistent world with NPC vendors, trainers, dungeons, and a full progression system up to level 20.

2. Technology Stack

The client runs on Webpack dev server (port 8080) while the Colyseus game server runs on port 3000 with WebSocket transport. State synchronization happens at 100ms intervals (10 updates/second) with database persistence every 10 seconds.

3. Game Mechanics

Circle RPG is a top-down 3D MMORPG with real-time combat, NPC interaction, inventory management, and quest progression. The game supports up to 64 concurrent players per server room.

Core Loop

• Explore the world: towns, dungeons, training grounds
• Fight monsters and bosses in real-time
• Loot equipment and consumables
• Complete quests for XP, gold, and items
• Level up and allocate stat points
• Learn new abilities from trainers
• Buy and sell gear at NPC vendors
• Earn $RPG tokens through gameplay

Progression

The level cap is 20. Each level requires progressively more experience, from 1,000 XP for level 2 up to 1,857,000 XP for level 20. Each level grants +50 max health, +50 max mana, and 5 stat points to distribute across Strength, Endurance, Agility, Intelligence, and Wisdom.

4. Character System

Player Stats

Character Customization

Players choose from 6 character archetypes: Knight, Barbarian, Engineer, Mage, Rogue, and Paladin. Each has unique head models with 24 material/texture variants. Base stats are identical, allowing full build freedom through stat point allocation.

Level Progression

5. Combat & Abilities

Combat is real-time with ability cooldowns, cast times, and stat-based damage scaling. Players can auto-attack or manually cast abilities from the hotbar (keys 1-9).

Ability List

Damage Calculation

Each ability scales with its affinity stat. Physical abilities scale with Strength, fire spells with Intelligence, and heals with Wisdom. Damage ranges are rolled randomly between min and max values per ability. Armor Class reduces incoming physical damage.

6. Equipment & Items

Equipment Slots (10)

Head, Amulet, Chest, Pants, Shoes, Weapon, Off-Hand, Ring 1, Ring 2, Back.

Item Rarity

• Normal - Base stats
• Rare - Enhanced stats
• Legendary - Unique modifiers and stat requirements

Available Items

Inventory

Players have 23 inventory slots and a 9-slot hotbar. Items can be equipped, consumed, dropped, sold, or traded. Consumables stack, equipment does not.

7. World & Quests

Locations

NPCs

Additional ambient NPCs patrol Lighthaven: Farmer Jorin, Bartender Morin, Caretaker Ren, Madame Seraphina, and various citizens.

Quest System

Quests are given by NPCs and tracked with status progression: Not Accepted → Accepted → Objective Update → Ready to Complete → Completed. Current quest types include Kill Amount (defeat X enemies) and Talk To (interact with NPC).

Dangerous Errands (Repeatable): Defeat 5 Bandits in the south forest for Priestess Alice. Reward: 500 XP + 50 gold.

8. Multiplayer Architecture

Circle RPG uses Colyseus for server-authoritative real-time multiplayer. All game logic runs server-side to prevent cheating.

Server Specs

State Synchronization

The server maintains authoritative state for all entities (players, NPCs, enemies, loot). Player-specific data (inventory, abilities, quests, gold) is filtered so each client only receives their own private data. Public data (position, health, level, equipment) is synced to all clients.

AI System

Enemies use a state machine with 4 states: Idle, Patrol, Chase, and Attack. Enemies detect players within 6 units and chase for up to 4 seconds. They attack when within 2 units. Defeated enemies respawn after 20 seconds.

9. $RPG Tokenomics

Token Details

Tax Breakdown

• 1% Marketing - Community growth, partnerships, influencer campaigns, exchange listings
• 2% In-Game Rewards - Directly funds the Play-to-Earn reward pool distributed to players through gameplay

The 3% tax applies on every buy and sell transaction. This ensures a continuously funded reward pool for active players while sustaining marketing efforts to grow the community.

10. Economy & Rewards

Earning $RPG

Players earn $RPG tokens by playing the game. Rewards are distributed from the in-game reward pool funded by the 2% transaction tax.

In-Game Gold Economy

Gold is the in-game currency separate from $RPG. It is used for:

• Buying items from NPC vendors (potions: 150g, equipment: 2,000g)
• Selling loot drops to vendors
• Quest completion rewards (e.g. 50 gold per quest)

Loot Drop System

Defeated enemies drop items based on weighted loot tables. Drop probabilities from bandits:

11. Roadmap

1. 简介

Circle RPG 是一款基于 BNB 智能链的浏览器 3D 多人在线 RPG 游戏。玩家可以探索开放世界，进行实时战斗，完成任务，并通过游戏赚取 $RPG 代币。游戏完全在浏览器中运行，无需下载。

项目结合了成熟的游戏引擎技术（Babylon.js 8.28）、实时多人网络（Colyseus 0.15）和 BSC 区块链代币集成。游戏拥有持久世界，包含 NPC 商人、训练师、地下城，以及完整的 20 级成长系统。

2. 技术架构

客户端运行在 Webpack 开发服务器（端口 8080），Colyseus 游戏服务器运行在端口 3000，使用 WebSocket 传输。状态同步间隔为 100 毫秒（每秒 10 次更新），数据库每 10 秒持久化一次。

3. 游戏机制

Circle RPG 是一款俯视角 3D MMORPG，具有实时战斗、NPC 交互、背包管理和任务进度。每个服务器房间支持最多 64 名玩家同时在线。

核心循环

• 探索世界：城镇、地下城、训练场
• 实时战斗怪物和 Boss
• 拾取装备和消耗品
• 完成任务获取经验、金币和物品
• 升级并分配属性点
• 向训练师学习新技能
• 在 NPC 商店买卖装备
• 通过游戏赚取 $RPG 代币

成长系统

等级上限为 20 级。每级所需经验递增，从 2 级的 1,000 XP 到 20 级的 1,857,000 XP。每次升级获得 +50 最大生命值、+50 最大法力值，以及 5 个属性点分配到力量、耐力、敏捷、智力和智慧。

4. 角色系统

玩家属性

角色自定义

玩家可从 6 种角色原型中选择：骑士、野蛮人、工程师、法师、盗贼和圣骑士。每种都有独特的头部模型和 24 种材质变体。基础属性相同，通过属性点分配实现完全自由的构建。

等级经验表

5. 战斗与技能

战斗为实时制，包含技能冷却、施法时间和基于属性的伤害缩放。玩家可以自动攻击或从快捷栏（按键 1-9）手动释放技能。

技能列表

伤害计算

每个技能根据其亲和属性进行缩放。物理技能按力量缩放，火焰法术按智力缩放，治疗按智慧缩放。伤害在每个技能的最小值和最大值之间随机取值。护甲等级减少受到的物理伤害。

6. 装备与物品

装备栏位（10个）

头部、项链、胸甲、裤子、鞋子、武器、副手、戒指1、戒指2、披风。

物品稀有度

• 普通 - 基础属性
• 稀有 - 增强属性
• 传说 - 独特修饰符和属性需求

可用物品

背包

玩家有 23 个背包格和 9 个快捷栏。物品可以装备、使用、丢弃、出售或交易。消耗品可堆叠，装备不可堆叠。

7. 世界与任务

地点

NPC

其他氛围 NPC 在光辉港巡逻：农夫乔林、酒保莫林、看管者仁、夫人瑟拉菲娜，以及各种市民。

任务系统

任务由 NPC 发布，状态依次为：未接受 → 已接受 → 目标更新 → 可交付 → 已完成。当前任务类型包括击杀数量（击败 X 个敌人）和对话（与 NPC 交互）。

危险差事（可重复）：为女祭司爱丽丝在南部森林击败 5 个强盗。奖励：500 XP + 50 金币。

8. 多人架构

Circle RPG 使用 Colyseus 实现服务器权威的实时多人游戏。所有游戏逻辑在服务端运行以防止作弊。

服务器参数

状态同步

服务器维护所有实体（玩家、NPC、敌人、掉落物）的权威状态。玩家特有数据（背包、技能、任务、金币）经过过滤，每个客户端只接收自己的私有数据。公共数据（位置、血量、等级、装备）同步给所有客户端。

AI 系统

敌人使用状态机，包含 4 种状态：空闲、巡逻、追击和攻击。敌人在 6 单位内检测玩家并追击最多 4 秒。在 2 单位内时进行攻击。被击败的敌人在 20 秒后重生。

9. $RPG 代币经济

代币详情

税率分配

• 1% 营销 - 社区增长、合作伙伴、KOL 推广、交易所上架
• 2% 游戏内奖励 - 直接资助 Play-to-Earn 奖励池，通过游戏分配给玩家

3% 税率适用于每笔买卖交易。这确保了活跃玩家的奖励池持续获得资金，同时维持营销努力以扩大社区。

10. 经济与奖励

赚取 $RPG

玩家通过游戏赚取 $RPG 代币。奖励从 2% 交易税资助的游戏内奖励池中分配。

游戏内金币经济

金币是与 $RPG 分开的游戏内货币，用于：

• 从 NPC 商人购买物品（药水：150金，装备：2,000金）
• 向商人出售掉落物品
• 任务完成奖励（如每个任务 50 金）

掉落系统

被击败的敌人根据加权掉落表掉落物品。强盗的掉落概率：

11. 路线图