游戏指南

什么是 Spirit Cards

Spirit Cards 是一个由元素生物构成的链上世界。一张卡不是抽象的代币，而是带有元素、战斗属性和“性格”的精灵角色——全部由其链上种子（seed）确定性地推导而来。你不是在买一张图，而是在挖出一只生物。

每张卡都由其种子生成的分层素材渲染，因此同一个代币在应用、元数据和区块浏览器里永远长得一模一样。

• ▸第一赛季 16 个物种——8 个通用（Emberback · Ripplefin · Mossroot · Cloudwhisk · Flashbound · Frostpuff · Quicksilver · Moonglimmer）与 8 条龙（Cindermaw · Tidecoil · Rootwaker · Zephyrcrest · Voltrush · Frostmane · Silvervein · Starwisp）。
• ▸6 个稀有度档位：普通、稀有、超稀有、极稀有、秘密稀有，以及棱镜（1-of-1）。稀有度取自种子的高位，并放大基础 HP / ATK / DEF。
• ▸4 种元素，构成“石头-剪刀-布”循环：余烬 › 磐石 › 疾风 › 潮汐 › 余烬。
• ▸有限供应——最多 8888 张卡（maxSupply）。铸造与销毁只会让剩余的越来越少。

⚠ 战斗结果并非仅由属性决定——元素、技能和每场对战内的随机浮动都起作用。详见“对战”。

游戏循环

整个游戏就是五个节点反复循环上百次。没有几百页的规则树：主页就是一个大大的 MINE 按钮，其余都是清晰的板块。

挖 MINE  →  熔 MERGE  →  ⚔ BATTLE  →  押 STAKE  →  榜 POINTS  →  重复

各节点互相供给：弱卡变成熔炼燃料，更强的卡打得更好，赢过的卡值得质押，而资金池的份额又鼓励你再玩一轮。每个动作也会累积积分。

挖矿（PoW）

卡不能在商店里买到——你得挖出来。这里的挖矿是真正的工作量证明：你的设备不断尝试 nonce，直到某个哈希越过难度阈值。计算在链下进行且免费；只有铸造那一刻才付 gas。

work = keccak256(chainId ‖ contract ‖ miner ‖ nonce)
有效 ⟺ leadingZeroBits(work) ≥ requiredBits()

leadingZeroBits 是哈希中前导零位的数量。合约 SpiritCards 校验这条规则；链上 Mined 事件携带的 work 与 CLI 矿工计算出的完全一致。

难度按赛季固定，只随价格纪元上升——这里没有“难度棘轮”（只快升几乎不降的调节器，它曾杀死很多早期项目）。节奏由协议决定（发行闸门 + 价格），而不是算力竞赛，所以手机和矿机每张卡的奖励完全一样。

当 eraSize = 1111、maxSupply = 8888 时约有 8 个价格纪元：价格从第一个纪元一步步走到最后一个纪元的几美元——温和台阶，而非翻倍。

筹码（ERC-1155）：按全价铸造会得到一枚筹码；使用筹码会让下一次铸造 −30%，筹码随即被烧毁。打折铸造只消耗筹码，不再发放新的筹码。

⚠ 这些都是 Config 的参数——所有者无需重新部署即可调整难度、限速和价格。

熔炼（Merge）

熔炼就是“重掷”：两张弱卡融合成一张更强的卡。世界的供应因此收缩（通缩），而以铸造价没人会买的“垃圾”则变成搏一次稀有度的机会。

• ▸选择你自己的两张卡（两张都不能处于质押中）。
• ▸支付一笔很小的熔炼费。
• ▸两张卡都被烧毁，诞生一张高一档位的新卡（进化）。

子卡的种子在交易打包后才确定，所以无法在交易前预先算出必胜的一对。base = max(rankA, rankB)；子卡是加权抽取，可能原地不变，偶尔还会掉档。

⚠ 如果熔炼落空（dud），两张卡都烧掉且不产生新卡——这是防套利保护（堵住“2×N 总是比 N+1 划算”的循环）。将 mergeFailBps 设为 0 即可关闭。不变量：不能把卡与自身熔炼，也不能熔炼不属于你或处于质押中的卡；操作是原子的。

质押（6 个档位）

质押就是卡的银行。你把一张卡锁进 StakeVault 一段时间，并获得资金池的一份份额——即游戏真实收取的手续费中的一部分。锁得越久权重越高，份额也就越大。

t0 灵活（随时可取）；t1–t5 是硬锁定——到期前不能取回卡。权重决定了这张卡相对于其他所有质押卡能分到资金池的多大比例。

资金池由项目手续费（铸造、熔炼、卡包收入的一部分）和外部收入（对战抽成）填充，随后在 StakeVault 内按权重比例分配（accRewardPerWeight）。若没有任何卡被质押，流入会累积，归第一个质押者。你可以随时领取奖励而无需解除质押，且 stakeBatch / claimBatch / unstakeBatch 可用一笔交易移动多张卡。

已质押的卡依然可以战斗：它不会离开金库——只在决斗期间被锁定（lockForBattle），分红继续累积，也无需 NFT 授权。如果它在战斗中失去最后一条命，金库会亲自烧掉它，并把未领取的奖励结算给质押者。

⚠ 诚实提醒：资金池与真实活跃度挂钩。没有铸造或交易量 → 没有流入 → 支付下降，直至为零。这是项目真实赚取部分的收入分成，不是“存款利息”，也不是回报承诺。我们不发布、也不保证任何 APY、收益率或回本期限。

对战

对战 v2 是一种带押注的托管决斗。两名玩家各自提交一张卡和等额的 ETH 押注；赢家拿走奖池减去抽成，输家失去卡的三条命之一。对战在链上确定性地结算，但结果是一场概率游戏——并不是“谁更强谁就赢”。

流程：你用一张卡 + 押注发起一场公开决斗；对手用他的卡 + 相同押注接受，决斗在同一笔交易里结算；你可以取消自己发起的公开决斗（卡与押注退回）。你不能接受自己的决斗。奖池 = 押注 × 2。

元素

循环：余烬 › 磐石 › 疾风 › 潮汐 › 余烬。占优元素造成 +20% 伤害，劣势元素造成 −20%（typeAdvBps = 2000）。

技能

卡片的技能由其种子决定（skill = (seed >> 208) % 6），玩家无法左右。

每次攻击都会乘以 ±40% 的随机系数（atkVarianceBps = 4000）。再加上元素 ±20% 与技能效果，结果就是真正的波动：实力相当的两张卡几乎等于抛硬币，而强约 25% 的卡胜率约 72%——弱者仍有约 28% 的机会赢。明显更强的卡几乎总能赢。

诚实说明：确切结果还取决于执行区块的 prevrandao，而接受者在签名时并不知道它——所以没人能挑到一个必胜的时刻。由于对战在链上是确定性的，任何人都能用卡种子、押注和 prevrandao 在链下复现结果。

生命：每张卡有 3 条命。输家失去一条命；赢家拿走奖池减去抽成，并在胜场计数 +1。0 条命的卡会被烧毁（真实的供应消耗），每张卡都会保留胜负履历，作为它的来历。

抽成为奖池的 10%（pvpRakeBps = 1000），属于外部收入（并非来自铸造），所以决斗会滋养分红池。决斗是玩家之间的零和博弈外加抽成——不是金字塔。

⚠ 对战是零和（加抽成）的概率机制：你可能既输掉钱也可能输掉卡。不保证任何收益。

卡包

卡包就是以折扣购买一组卡。Packs 合约会为买家铸造 N 张真实的卡——普通 token id、普通稀有度、普通权利。购买卡包会跳过 PoW、纪元上限和冷却，因为这正是这个产品的定义。

卡包价格 = 数量 ×（currentPrice() × 2）− 体量折扣（`packPriceBps = 20000`）：买包跳过 PoW，单价为矿价的 2 倍，减去随尺寸递增的折扣。收入走与其他手续费相同的通用分成（资金池 60 / 推荐 10 / 国库 30 / 储备 0）。每张卡都从 8888 的总供应中产出，稀有度由其种子推导。

合约为买家维护一个保底（pity）计数器，各稀有度的公开掉率会在仪表盘上披露。

⚠ 卡包不保证特定卡片，也不保证回本；卡的价值由市场（二级交易）决定，而非项目。不保证任何收益。

积分

积分是链上的活跃度积分加上排行榜。游戏奖励活跃——挖矿、熔炼、质押和对战胜利——这种竞争正是留存引擎。

积分由获授权的模块（SpiritCards、StakeVault、Battle）通过 Points 合约发放，并链上存储为 points[address]；排行榜读取同一合约。赛季是链下的（按快照）。合约会发出 PointsAdded(user, amount, reason) 事件，因此活跃度可验证。

⚠ 积分没有货币价值，也不能兑换成钱——它只是游戏内指标。赛季奖励是皮肤或独特物品，不是钱。新赛季只重置排行榜；你的收藏永远不会被轮换出游戏。

经济与推荐

Spirit Cards 是一款游戏；它的资金层建立在项目真实收取的手续费之上。这里没有保证收益，也没有“存款生息”。所有分配出去的都是已收取手续费的一部分。

每笔项目手续费都按这些固定比例拆分（可通过 setSplit 调整，但必须始终合计 100%）。版税（5%，ERC-2981）进入国库而非资金池，来自 OpenSea 上的二级销售。

推荐：邀请是被邀请者“活动”的百分比，而不是其“存款”的百分比。玩家只能设置一次推荐人，且推荐人自己至少挖过一次矿。在 10% 的推荐基金中，毛支付的 3% 给主推荐人（对每个付款者固定的顶层推荐人），7% 给付款者自己的推荐人。若付款者没有推荐人，这 7% 留在未分配基金中。已记入推荐人的金额受保护，所有者不能以“剩余”名义提取。

资金池由以下填充：铸造费的 60%、熔炼费的 60%、卡包收入的 60%、对战抽成的 30%，以及（计划中的）外部赞助。版税不进资金池。一个无需许可的 pumpPool() 会把累积的资金池作为分红注入 StakeVault——任何人都能调用，资金永远进入金库，绝不进入调用者。

⚠ 诚实的算术：资金池份额与活跃度挂钩——没有手续费就没有流入，支付会降到零。没有 APY 数字、没有收益率、没有回本期限。没有“存款利息”——推荐只在活动上支付，也没有手动托底或刷量。

链与合约

Spirit Cards 部署在 Robinhood Chain 上，这是一条 Arbitrum Orbit L2，gas 用 ETH 支付。chainId 4663。

核心合约有 Config、SpiritCards、ChipToken（ERC-1155 筹码）、StakeVault、Battle、Points 和 Packs。所有权会移交给多签 Safe（之后再加时间锁）；所有经济参数都是 Config 的参数，无需重新部署即可更改。

交易发生在 OpenSea 上，这是该链原生的市场。没有 ERC-20 代币，也没有 LP——项目不使用 Uniswap。

⚠ 合约地址维护在项目的 ops/ADDRESSES.md 中，每当整套合约重新部署时都会更新。请以该文件为唯一事实来源；我们有意不把地址硬编码进本指南，因为它们会变。