EVE Frontier Builder Course
Choose your language / 选择语言:
🇬🇧 English | 🇨🇳 中文
Complete EVE Frontier Builder Course
Approximately 2 hours per lesson , 54 total lessons : 36 core chapters + 18 practical case studies, covering gameplay understanding, Builder engineering workflow, World contract source code analysis, and wallet integration.
Build Status:
# Build both languages + language picker (recommended)
./build.sh
# Or build one language (mdbook 0.4.x has no --config-file; use env overrides)
mdbook build # English → book/en/
MDBOOK_BOOK__SRC=src/zh MDBOOK_BOOK__LANGUAGE=zh-CN MDBOOK_BUILD__BUILD_DIR=book/zh mdbook build
Chapter
File
Summary
Prelude
chapter-00.md
Understanding EVE Frontier: what players compete for, why facilities matter, how location, combat, logistics and economy form complete gameplay
Stage 1: Fundamentals (Chapters 1-5)
Chapter
File
Summary
Chapter 1
chapter-01.md
EVE Frontier macro architecture: three-tier model, smart component types, Sui/Move rationale
Chapter 2
chapter-02.md
Development environment setup: Sui CLI, EVE Vault, test asset acquisition and minimal acceptance
Chapter 3
chapter-03.md
Move contract basics: modules, Abilities, object ownership, Capability/Witness/Hot Potato
Chapter 4
chapter-04.md
Smart component development and on-chain deployment: characters, network nodes, turrets, stargates, storage box transformation
Chapter 5
chapter-05.md
dApp frontend development: dapp-kit SDK, React Hooks, wallet integration, on-chain transactions
Paired Examples: Example 1 Turret Whitelist, Example 2 Stargate Toll Station
Stage 2: Builder Engineering Workflow (Chapters 6-10)
Chapter
File
Summary
Chapter 6
chapter-06.md
Builder Scaffold entry: project structure, smart_gate architecture, compilation and publication
Chapter 7
chapter-07.md
TypeScript scripts and frontend: helper.ts, script pipeline, React dApp template
Chapter 8
chapter-08.md
Server-side collaboration: Sponsored Tx, AdminACL, on-chain/off-chain coordination
Chapter 9
chapter-09.md
Data reading: GraphQL, event subscription, indexer approaches
Chapter 10
chapter-10.md
dApp wallet integration: useConnection, sponsored transactions, Epoch handling
Paired Examples: Example 4 Quest Unlock System, Example 11 Item Rental System
Stage 3: Advanced Contract Design (Chapters 11-17)
Chapter
File
Summary
Chapter 11
chapter-11.md
Ownership model deep dive: OwnerCap, Keychain, Borrow-Use-Return, delegation
Chapter 12
chapter-12.md
Advanced Move: generics, dynamic fields, event system, Table and VecMap
Chapter 13
chapter-13.md
NFT design and metadata management: Display standard, dynamic NFT, Collection patterns
Chapter 14
chapter-14.md
On-chain economic system design: token issuance, decentralized marketplace, dynamic pricing, treasury
Chapter 15
chapter-15.md
Cross-contract composability: calling other Builders' contracts, interface design, protocol standards
Chapter 16
chapter-16.md
Location and proximity systems: hash location, proximity proof, geographic strategy design
Chapter 17
chapter-17.md
Testing, debugging and security audit: Move unit tests, vulnerability types, upgrade strategies
Paired Examples: Example 3 On-chain Auction, Example 6 Dynamic NFT, Example 7 Stargate Logistics Network, Example 9 Cross-Builder Protocol, Example 13 Subscription Pass, Example 14 NFT Staking Lending, Example 16 NFT Crafting/Decomposition, Example 18 Inter-Alliance Diplomatic Treaty
Stage 4: Architecture, Integration and Product (Chapters 18-25)
Chapter
File
Summary
Chapter 18
chapter-18.md
Multi-tenancy and game server integration: Tenant model, ObjectRegistry, server-side scripts
Chapter 19
chapter-19.md
Full-stack dApp architecture design: state management, real-time updates, multi-chain support, CI/CD
Chapter 20
chapter-20.md
In-game integration: overlay UI, postMessage, game event bridging
Chapter 21
chapter-21.md
Performance optimization and Gas minimization: transaction batching, read-write separation, off-chain computation
Chapter 22
chapter-22.md
Advanced Move patterns: upgrade compatibility design, dynamic field extension, data migration
Chapter 23
chapter-23.md
Publishing, maintenance and community collaboration: mainnet deployment, Package upgrade, Builder collaboration
Chapter 24
chapter-24.md
Troubleshooting handbook: common Move, Sui, dApp error types and systematic debugging methods
Chapter 25
chapter-25.md
From Builder to product: business models, user growth, community operations, progressive decentralization
Paired Examples: Example 5 Alliance DAO, Example 12 Alliance Recruitment, Example 15 PvP Item Insurance, Example 17 In-Game Overlay Practice
Stage 5: World Contract Source Code Analysis (Chapters 26-32)
Based on real source code from world-contracts , deep dive into EVE Frontier core system mechanisms.
Chapter
File
Summary
Chapter 26
chapter-26.md
Complete access control analysis: GovernorCap, AdminACL, OwnerCap, Receiving pattern
Chapter 27
chapter-27.md
Off-chain signature × on-chain verification: Ed25519, PersonalMessage intent, sig_verify analysis
Chapter 28
chapter-28.md
Location proof protocol: LocationProof, BCS deserialization, proximity verification practice
Chapter 29
chapter-29.md
Energy and fuel system: EnergySource, fuel consumption rate calculation, known bug analysis
Chapter 30
chapter-30.md
Extension pattern practice: official tribe_permit + corpse_gate_bounty analysis
Chapter 31
chapter-31.md
Turret AI extension: TargetCandidate, priority queue, custom AI development
Chapter 32
chapter-32.md
KillMail system: PvP kill records, TenantItemId, derived_object replay prevention
Paired Examples: Example 8 Builder Competition System, Example 10 Comprehensive Practice
Stage 6: Wallet Internals and Future (Chapters 33-35)
After learning wallet integration and dApp development, dive deep into wallet internals and future directions for a smoother learning curve.
Chapter
File
Summary
Chapter 33
chapter-33.md
zkLogin principles and design: zero-knowledge proofs, FusionAuth OAuth, Enoki salt, ephemeral key pairs
Chapter 34
chapter-34.md
Technical architecture and deployment: Chrome MV3 five-layer structure, Keeper security container, messaging protocol, local build
Chapter 35
chapter-35.md
Future outlook: zero-knowledge proofs, fully decentralized games, EVM interoperability
Paired Suggestion: After completing this stage, review Example 17 for wallet connection, signing, and in-game integration pipeline.
Beginner Cases (Examples 1-3)
Example
File
Technical Highlights
Example 1
example-01.md
Turret whitelist: MiningPass NFT + AdminCap + management dApp
Example 2
example-02.md
Stargate toll station: vault contract + JumpPermit + player ticket dApp
Example 3
example-03.md
On-chain auction: Dutch pricing + auto settlement + real-time countdown dApp
Intermediate Cases (Examples 4-7)
Example
File
Technical Highlights
Example 4
example-04.md
Quest unlock system: on-chain flag quests + off-chain monitoring + conditional stargate
Example 5
example-05.md
Alliance DAO: custom Coin + snapshot dividends + weighted governance voting
Example 6
example-06.md
Dynamic NFT: evolvable equipment with metadata updating based on game state
Example 7
example-07.md
Stargate logistics network: multi-hop routing + Dijkstra pathfinding + dApp
Advanced Cases (Examples 8-10)
Example
File
Technical Highlights
Example 8
example-08.md
Builder competition system: on-chain leaderboard + points + trophy NFT auto-distribution
Example 9
example-09.md
Cross-Builder protocol: adapter pattern + multi-contract aggregated marketplace
Example 10
example-10.md
Comprehensive practice: space resource battle (integrating characters, turrets, stargates, tokens)
Extension Cases (Examples 11-15)
Example
File
Technical Highlights
Example 11
example-11.md
Item rental system: time-locked NFT + deposit management + early return refund
Example 12
example-12.md
Alliance recruitment: application deposit + member voting + veto power + auto NFT issuance
Example 13
example-13.md
Subscription pass: monthly/quarterly packages + transferable Pass NFT + renewal
Example 14
example-14.md
NFT staking lending: 60% LTV + 3% monthly interest + overdue liquidation auction
Example 15
example-15.md
PvP item insurance: purchase policy + server signature claims + payout pool
Advanced Extension (Examples 16-18)
Example
File
Technical Highlights
Example 16
example-16.md
NFT crafting/decomposition: three-tier item system + on-chain randomness + consolation mechanism
Example 17
example-17.md
In-game overlay practice: in-game toll station + postMessage + seamless signing
Example 18
example-18.md
Inter-alliance diplomatic treaty: dual signature activation + deposit constraint + breach evidence and penalties
每节课约 2 小时 ,共 54 节 :36 个基础章节 + 18 个实战案例,覆盖从玩法理解、Builder 工程闭环,到 World 合约源码精读与钱包接入。
构建方式:
# 同时构建双语与入口页(推荐)
./build.sh
# 或单独构建一种语言(mdbook 0.4.x 无 --config-file,用环境变量覆盖)
mdbook build # 英文 → book/en/
MDBOOK_BOOK__SRC=src/zh MDBOOK_BOOK__LANGUAGE=zh-CN MDBOOK_BUILD__BUILD_DIR=book/zh mdbook build
章节
文件
主题摘要
Prelude
chapter-00.md
先读懂 EVE Frontier 这款游戏:玩家在争夺什么、设施为什么重要、位置、战损、物流和经济如何串成完整玩法
章节
文件
主题摘要
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)
配套实战:Example 4 任务解锁系统、Example 11 物品租赁系统
第三阶段:合约设计进阶(Chapter 11-17)
配套实战:Example 3 链上拍卖行、Example 6 动态 NFT、Example 7 星门物流网络、Example 9 跨 Builder 协议、Example 13 订阅制通行证、Example 14 NFT 质押借贷、Example 16 NFT 合成拆解、Example 18 跨联盟外交条约
第四阶段:架构、集成与产品(Chapter 18-25)
配套实战: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 的钱包连接、签名与游戏内接入链路。