元素英雄 Docs

00世界观与纪元

衡洲不是被创造的，而是被炼出来的。读懂这段神话，就读懂了游戏里每一次召唤、每一块碎片、每一轮 BOSS 讨伐的来处。

太初 · 五行成环

太初无物，唯有一缕未分化的原初之气，古称元一。元一自混沌中睁眼，以自身为炉、以混沌为薪，将无序炼作五种本源：金之锐、木之生、土之载、水之流、火之燃。

五行并非并列，而是首尾相衔、彼此制衡 —— 金克木、木克土、土克水、水克火、火克金。这条咬合的环，即为衡环。衡环既成，混沌退散，大地自环心向外层层凝结，是为衡洲。炼尽自身的元一没有留下形体，只余五缕神性与一枚元一心核，镇在衡环正中。

五帝纪 · 秩序的巅峰

元一的五缕神性化为五帝，各执一行，共守衡环。他们是衡洲一切力量的上游，也是今日「元素英雄」的血脉之源。

黯龙纪 · 衡环碎裂

元一炼尽混沌时，留下了未能化尽的残渣 —— 那是不愿被秩序收编的、纯粹的无序。残渣蛰伏在衡环的阴影里不可计数的岁月，最终凝成一头巨龙：黯烬之龙 · 烛幽。

烛幽没有去砸碎衡环，而是咬住它。它将相克的链条一节节扯到极致 —— 令金克木至于尽、木克土至于绝，让五行自相残杀。这种权能被称为逆衡：不违背规则，而是把规则推向毁灭。

衡环在自噬中崩断。元一心核当空炸裂，五行之力化作漫天结晶坠向大地 —— 那便是今日你背包里的碎片（Shards）与精粹（Essence）。失去环的约束，大地沿着裂痕塌陷，衡洲从此成为一个层层相套的环带：中央是残存的圣域，向外依次是元素环、外环，最外侧是烛幽盘踞的那道裂口。

五纪元 · 从创世到当下

你所在的服务器，正运行在第五纪元的开端。

衡洲地理志 · 十二圣域

地图上的每一座建筑都不是功能按钮，而是有来历的地标 —— 门也不由你推开：事由驻守在这里的人经手，与他交谈，他才会替你开门。

术语表

社群与文档里反复出现的高频词，一次讲清。

01项目简介

元素英雄是一款全流程上链的五行题材 RPG：英雄、武器、材料都是链上资产，战斗结果由链上随机数决定，奖励直接进入金库。

游戏围绕「召唤英雄 → 锻造/强化武器 → 挑战怪物与世界 BOSS → 领取奖励 → 市场流通」构成完整循环。英雄和武器是 ERC-721，碎片与精粹是 ERC-1155，所有产出与消耗都写在合约里，前端只做展示与交互。

02快速开始

三分钟从零到第一次出战。

1. 准备钱包。在浏览器安装 MetaMask（或兼容的 EVM 钱包）并创建/导入账户。
2. 切换到 BSC 测试网。网络参数：链 ID 97，RPC https://data-seed-prebsc-1-s1.bnbchain.org:8545，币种 BNB。游戏连接钱包时会提示自动切换，未成功请手动确认。
3. 领取测试币。到 BSC 测试网水龙头领取测试 BNB 用于支付 gas（游戏内交易已固定 0.12 gwei gasPrice）。
4. 获取 EH。战斗与 BOSS 奖励会产出代币；也可由管理端向金库注入奖励池。召唤英雄与锻造武器需要消耗 EH。
5. 召唤第一位英雄。进入游戏 →「英雄」页 → 召唤英雄，等待若干区块后自动揭示，得到随机元素与基础战力。
6. 锻造并出战。「锻造」页拿到武器 →「战斗」页选择英雄 + 武器 + 怪物 → 开打，胜利奖励进金库，去「金库」页领取。

03五行与克制

金 · 木 · 土 · 水 · 火，相生相克，决定战斗中的元素乘数。

克制顺序为 金 → 木 → 土 → 水 → 火 → 金（箭头指向被克制的一方）。战斗时，武器元素对怪物元素生效：

04英雄系统

等级、经验、战力、体力四位一体，体力决定你的出战节奏。

核心属性

• 基础战力：召唤时随机生成（区间约 300~500），是后续一切加成的基数。
• 等级与经验：战斗胜利获得经验（失败也有 1/4 经验），经验累积提升等级。
• 等级加成：每满 10 级为一个档位，奖励加成 +5%，最高 +25%（50 级以上）。
• 体力：上限 120 点，每 3 分钟恢复 1 点，每场战斗消耗 10 点（从空回满约 6 小时，即每 30 分钟攒够一场）。体力不足 10 点时无法出战——剩余零头会继续累积，不会浪费。该参数由合约控制，游戏内显示实时值与倒计时。
• 持有上限：每个地址最多持有 4 位英雄。

召唤规则

• 召唤费用来自价格预言机（合约默认 10000 EH，可由管理员调整），游戏内实时显示。
• 采用 commit-reveal：发起时冻结 费用 × 105%（含 5% 押金），揭示时按实际费用结算、押金退回。
• 元素在揭示时由链上随机数决定，召唤结果可在「待揭示」气泡中跟踪。

05武器 · 锻造 · 熔炼

锻造随机产出 1~5★ 与五行属性，不合心意的武器可以熔炼回收。

锻造

• 三种档位：单抽 / 十连 / 百连，价格分别由预言机的 getWeaponCost、getWeapon10Cost、getWeapon100Cost 给出。
• 发起时冻结「费用 + 5% 押金 + 10% 缓冲」，揭示后按实际结算。
• 产出结果包含武器（1~5★ + 元素 + 强化加成 bonusBp）与碎片掉落，也有「空手而归」的可能。

碎片合成武器

集齐 10 个同星级碎片 可直接合成该星级武器，需支付手续费：

熔炼回收

• 武器可单件或批量熔炼，按星级返还对应阶位的精粹，材料循环再利用。
• 熔炼不可逆，请先确认该武器不再需要（尤其是已强化的高星武器）。

星级对奖励的影响

武器奖励加成随武器自身强化加成（bonusBp）随机派生，但按星级分层 —— 五星整体高于四星、四星整体高于三星；同一星级内每把武器的加成各不相同。强化只会让奖励加成单调上升，不会因强化而下降：

06精粹与强化

精粹既能合成升阶，也能给武器叠加强化加成。

精粹合成（低阶 → 高阶）

每 50 个低阶精粹 合成 1 个高阶精粹，按次收取手续费：

武器强化

消耗精粹对武器进行 1~4 阶强化，每阶提升战力加成百分比（bonusBp），手续费按阶位递增：

07战斗与奖励

战力决定胜率，元素决定乘数，星级与等级决定收益。

出战流程

1. 在「战斗」页选择英雄、武器与怪物；英雄需有至少 1 点体力。
2. 系统实时计算有效战力、元素关系与预估胜率。
3. 发起战斗，链上随机判定胜负；消耗 10 点体力。
4. 胜利获得经验与奖励，奖励进入金库；失败仅获得 1/4 经验。

战力与胜率

• 英雄战力：基础战力随等级与经验成长。
• 出战战力：英雄战力 × (1 + 武器加成)；武器与英雄同元素再 ×1.10。
• 有效战力：出战战力 × 元素克制乘数（1.30 / 0.75 / 1.00），英雄克制怪物再 ×1.10。
• 胜率：有效战力 / (有效战力 + 怪物战力)，并限制在 10% ~ 95% 之间。
• 动态难度：英雄每满 10 级，怪物战力提升 15%，保持长期挑战性。

怪物与奖励基数

奖励以美元计价：基础奖励 = 0.2 × 档位系数 × (1 + 0.15 × 等级档位)，再乘武器星级加成（随机）与英雄等级加成。官网按 USDT 展示，游戏内按金库模式发放（EH 或 USDT）。档位系数以石头人（1.00）为基准：向下每个难度 ×0.90，向上按难度 ×1.20 / ×1.40 / ×1.70 / ×2.20 / ×4.00：

难度分档依据怪物战力：< 500 简单，< 2000 普通，< 8000 困难，其余为噩梦。

08世界 BOSS

7 天一轮，全服合力讨伐远古巨龙，伤害换奖池份额。

• 轮次：每轮间隔 7 天，BOSS 血量在 1,000 ~ 10,000,000 之间由管理员设定。
• 攻击：选择英雄与武器发起攻击，同样为 commit-reveal 两段式；需按奖池的 5% 缴纳保证金（奖池为 0 时免押金），揭示时全额退还。
• 伤害：基于出战战力与链上随机，累计个人伤害与全服总伤害。
• 结算：BOSS 被击破时按伤害占比分配 100% 奖池；轮次结束仍未击破，则按 50% 奖池 结算。给予最后一击的玩家额外获得武器奖励。
• 排行：伤害排行 TOP5 实时刷新，你的名次会金色高亮。

09市场交易

英雄、武器、碎片、精粹都可以挂单出售。

• 可交易品类：英雄（ERC-721）、武器（ERC-721）、碎片（ERC-1155）、精粹（ERC-1155）。
• 上架：选择品类与数量、设定 EH 价格，授权后挂单；随时可以取消上架。
• 购买：用 EH 直接购买他人挂单，成交后资产与代币同步结算。
• 手续费：由链上配置（默认 200 bp = 2%），页面会实时显示当前费率。

10金库与领取

所有战斗与 BOSS 奖励先入金库，由你主动领取。

• 累积：战斗胜利与 BOSS 结算的奖励写入金库待领取余额，不自动打款，避免频繁小额转账。
• 领取：在「金库」页一键 claim，奖励直接进入你的钱包。
• 奖励模式：模式 0 为代币模式，按预言机价格把美元计价折算成 EH 发放；模式 1 为 USDT 模式，直接发放 USDT。模式由管理员配置，页面会显示当前模式。

11排行与图鉴

看看自己排在什么位置，也看看对手长什么样。

• 排行榜：统计全部玩家的对战场次、胜场、胜率与总战力，分页查看。
• 我的战斗记录：最近的出战详情，含双方战力、胜率与奖励。
• 图鉴：英雄、武器与 10 种怪物的资料总览；在战斗页可直接跳转到图鉴挑选怪物。

12代币与经济

EH 是游戏内的通用消耗与结算单位。

EH 的主要用途

• 召唤英雄（预言机定价）
• 锻造武器（单抽 / 十连 / 百连）
• 碎片合成武器（50 ~ 1000 EH / 次）
• 精粹合成（20 / 100 / 500 EH / 次）与武器强化（2 / 10 / 30 / 80 EH / 次）
• 市场挂单与购买
• 世界 BOSS 攻击保证金（奖池 5%，揭示时退还）

EH 的获取方式

• 战斗胜利奖励（代币模式下按预言机折算发放）
• 世界 BOSS 奖池按伤害占比分配
• 在市场上出售英雄、武器、碎片与精粹

价值流转

玩家消耗 EH 召唤与锻造 → 产出 NFT 与材料 → 出战获取奖励回流 EH → 剩余资产在市场流通给新玩家，形成闭环。所有消耗项都是链上真实销毁或转入金库/市场合约，可在区块浏览器上核对。

13邀请与返现

邀请好友一起冒险：对方每次战斗胜利，你都能分到奖励的一部分，还可以把其中一定比例返现给下线。

它是怎么算的

设推荐人为 A、下线为 B。B 每赢得一场战斗、拿到奖励 R 时：

• 邀请分成池 = R × 10%，由金库单独记账，与 B 自己的战斗奖励互不影响。
• 其中 返现给 B = 分成池 × A 设定的返现比例（0 ~ 90%）。
• 剩下的 A 自留 = 分成池 − 返现部分。

三步开始邀请

1. 注册邀请码。进入游戏 →「邀请中心」→ 点「注册邀请码」，系统生成 4~10 位短码（形如 ehk7m2，字母数字、不含易混淆字符），并自动复制你的邀请链接。
2. 分享链接。把 game.html?ref=你的短码 发给好友；也可以用下面的生成器做成便于传播的分享链接。
3. 好友铸造时自动绑定。好友通过链接进入游戏后，首次召唤英雄时会自动把你设为推荐人（也可手动填写邀请码或钱包地址）。绑定即开始为你产生邀请分成。

没有注册短码也能用 —— 直接分享 ?ref=你的钱包地址 同样有效，只是链接更长。

领取与查询

• 邀请奖励与战斗奖励分开记账，在「金库」页分别领取。
• 下线的返现由下线本人在金库页领取。
• 「邀请中心」可查看：邀请码与链接、下线列表、每个下线的贡献、累计推荐奖励、当前返现比例与快照状态。

14合约与网络

当前部署在 BSC 测试网（chainId 97），以下为主力合约地址。

网络参数

15常见问题

新手最容易卡住的几件事。

16社群与链接

有问题来社群，公告与进度在推特。