EVE Frontier 构建者完整课程

每节课约 2 小时，共 54 节：36 个基础章节 + 18 个实战案例，覆盖从玩法理解、Builder 工程闭环，到 World 合约源码精读与钱包接入。

---

章节主线

前置章节

章节	文件	主题摘要
Prelude	chapter-00.md	先读懂 EVE Frontier 这款游戏：玩家在争夺什么、设施为什么重要、位置、战损、物流和经济如何串成完整玩法

第一阶段：入门基础（Chapter 1-5）

章节	文件	主题摘要
Chapter 1	chapter-01.md	EVE Frontier 宏观架构：三层模型、智能组件类型、Sui/Move 选型
Chapter 2	chapter-02.md	开发环境配置：Sui CLI、EVE Vault、测试资产获取与最小验收
Chapter 3	chapter-03.md	Move 合约基础：模块、Abilities、对象所有权、Capability/Witness/Hot Potato
Chapter 4	chapter-04.md	智能组件开发与链上部署：角色、网络节点、炮塔、星门、存储箱改造全流程
Chapter 5	chapter-05.md	dApp 前端开发：dapp-kit SDK、React Hooks、钱包集成、链上交易

配套实战：Example 1 炮塔白名单、Example 2 星门收费站

第二阶段：Builder 工程闭环（Chapter 6-10）

章节	文件	主题摘要
Chapter 6	chapter-06.md	Builder Scaffold 入口：项目结构、smart_gate 架构、编译与发布
Chapter 7	chapter-07.md	TS 脚本与前端：helper.ts、脚本链路、React dApp 模板
Chapter 8	chapter-08.md	服务端协同：Sponsored Tx、AdminACL、链上链下配合
Chapter 9	chapter-09.md	数据读取：GraphQL、事件订阅、索引器思路
Chapter 10	chapter-10.md	dApp 钱包接入：useConnection、赞助交易、Epoch 处理

配套实战：Example 4 任务解锁系统、Example 11 物品租赁系统

第三阶段：合约设计进阶（Chapter 11-17）

章节	文件	主题摘要
Chapter 11	chapter-11.md	所有权模型深度解析：OwnerCap、Keychain、Borrow-Use-Return、委托
Chapter 12	chapter-12.md	Move 进阶：泛型、动态字段、事件系统、Table 与 VecMap
Chapter 13	chapter-13.md	NFT 设计与元数据管理：Display 标准、动态 NFT、Collection 模式
Chapter 14	chapter-14.md	链上经济系统设计：代币发行、去中心化市场、动态定价、金库
Chapter 15	chapter-15.md	跨合约组合性：调用其他 Builder 的合约、接口设计、协议标准
Chapter 16	chapter-16.md	位置与临近性系统：哈希位置、临近证明、地理策略设计
Chapter 17	chapter-17.md	测试、调试与安全审计：Move 单元测试、漏洞类型、升级策略

配套实战：Example 3 链上拍卖行、Example 6 动态 NFT、Example 7 星门物流网络、Example 9 跨 Builder 协议、Example 13 订阅制通行证、Example 14 NFT 质押借贷、Example 16 NFT 合成拆解、Example 18 跨联盟外交条约

第四阶段：架构、集成与产品（Chapter 18-25）

章节	文件	主题摘要
Chapter 18	chapter-18.md	多租户与游戏服务器集成：Tenant 模型、ObjectRegistry、服务端脚本
Chapter 19	chapter-19.md	全栈 dApp 架构设计：状态管理、实时更新、多链支持、CI/CD
Chapter 20	chapter-20.md	游戏内接入：浮层 UI、postMessage、游戏事件桥接
Chapter 21	chapter-21.md	性能优化与 Gas 最小化：事务批处理、读写分离、链下计算
Chapter 22	chapter-22.md	Move 高级模式：升级兼容设计、动态字段扩展、数据迁移
Chapter 23	chapter-23.md	发布、维护与社区协作：主网部署、Package 升级、Builder 协作
Chapter 24	chapter-24.md	故障排查手册：常见 Move、Sui、dApp 错误类型与系统化调试方法
Chapter 25	chapter-25.md	从 Builder 到产品：商业模式、用户增长、社区运营、渐进去中心化

配套实战：Example 5 联盟 DAO、Example 12 联盟招募、Example 15 PvP 物品保险、Example 17 游戏内浮层实战

第五阶段：World 合约源码精读（Chapter 26-32）

基于 world-contracts 真实源代码，深度解析 EVE Frontier 核心系统机制。

章节	文件	主题摘要
Chapter 26	chapter-26.md	访问控制完整解析：GovernorCap、AdminACL、OwnerCap、Receiving 模式
Chapter 27	chapter-27.md	链下签名 × 链上验证：Ed25519、PersonalMessage intent、sig_verify 精读
Chapter 28	chapter-28.md	位置证明协议：LocationProof、BCS 反序列化、临近性验证实战
Chapter 29	chapter-29.md	能量与燃料系统：EnergySource、Fuel 消耗率计算、已知 Bug 分析
Chapter 30	chapter-30.md	Extension 模式实战：官方 tribe_permit + corpse_gate_bounty 精读
Chapter 31	chapter-31.md	炮塔 AI 扩展：TargetCandidate、优先级队列、自定义 AI 开发
Chapter 32	chapter-32.md	KillMail 系统：PvP 击杀记录、TenantItemId、derived_object 防重放

配套实战：Example 8 Builder 竞赛系统、Example 10 综合实战

第六阶段：钱包内部与未来（Chapter 33-35）

在已经会接入钱包和 dApp 之后，再回头深入钱包内部实现与未来方向，学习曲线更顺。

章节	文件	主题摘要
Chapter 33	chapter-33.md	zkLogin 原理与设计：零知识证明、FusionAuth OAuth、Enoki 盐值、临时密钥对
Chapter 34	chapter-34.md	技术架构与开发部署：Chrome MV3 五层结构、Keeper 安全容器、消息协议、本地构建
Chapter 35	chapter-35.md	未来展望：零知识证明、完全去中心化游戏、EVM 互操作

配套建议：完成本阶段后，回看 Example 17 的钱包连接、签名与游戏内接入链路。

---

案例索引

主线分配见上；下面保留按复杂度查看的索引，方便选题和回查。

初级案例（Example 1-3）

案例	文件	技术亮点
Example 1	example-01.md	炮塔白名单：MiningPass NFT + AdminCap + 管理 dApp
Example 2	example-02.md	星门收费站：金库合约 + JumpPermit + 玩家购票 dApp
Example 3	example-03.md	链上拍卖行：荷兰式定价 + 自动结算 + 实时倒计时 dApp

中级案例（Example 4-7）

案例	文件	技术亮点
Example 4	example-04.md	任务解锁系统：链上位标志任务 + 链下监控 + 条件星门
Example 5	example-05.md	联盟 DAO：自定义 Coin + 快照分红 + 加权治理投票
Example 6	example-06.md	动态 NFT：随游戏状态实时更新元数据的可进化装备
Example 7	example-07.md	星门物流网络：多跳路由 + Dijkstra 路径规划 + dApp

高级案例（Example 8-10）

案例	文件	技术亮点
Example 8	example-08.md	Builder 竞赛系统：链上排行榜 + 积分 + 奖杯 NFT 自动分发
Example 9	example-09.md	跨 Builder 协议：适配器模式 + 多合约聚合市场
Example 10	example-10.md	综合实战：太空资源争夺战（整合角色、炮塔、星门、代币）

扩展案例（Example 11-15）

案例	文件	技术亮点
Example 11	example-11.md	物品租赁系统：时间锁 NFT + 押金管理 + 提前归还退款
Example 12	example-12.md	联盟招募：申请押金 + 成员投票 + 一票否决 + 自动发 NFT
Example 13	example-13.md	订阅制通行证：月、季套餐 + 可转让 Pass NFT + 续费
Example 14	example-14.md	NFT 质押借贷：LTV 60% + 月息 3% + 逾期清算拍卖
Example 15	example-15.md	PvP 物品保险：购买保单 + 服务器签名理赔 + 赔付池

高级扩展（Example 16-18）

案例	文件	技术亮点
Example 16	example-16.md	NFT 合成拆解：三级物品体系 + 链上随机数 + 安慰奖机制
Example 17	example-17.md	游戏内浮层实战：收费站游戏内版 + postMessage + 无缝签名
Example 18	example-18.md	跨联盟外交条约：双签生效 + 押金约束 + 违约举证与罚款

---

创意库

• Sui 核心特性创意 100 例
• 常规综合创意 100 例

---

阅读入口

• 课程首页
• 目录
• 术语表
• 案例运行指南

---

参考资源

• 官方 builder-documentation
• builder-scaffold（脚手架）
• World Contracts 源码
• EVE Vault
• Sui 文档
• Move Book
• EVE Frontier dapp-kit API
• Sui GraphQL IDE（Testnet）
• EVE Frontier Discord