菜单
ESP32 Minecraft 服务器开发技能。提供在 ESP32 上运行 Minecraft Java 服务器的完整参考，包括配置、编译、调试、网络优化等。TRIGGER when: 用户开发 ESP32 Minecraft 服务器、配置 globals.h、调试网络问题、优化性能、或需要了解嵌入式 Minecraft 服务器时触发。SKIP: 非 ESP32 平台的 Minecraft 服务器开发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | esp32-minecraft |
| description | ESP32 Minecraft 服务器开发技能。提供在 ESP32 上运行 Minecraft Java 服务器的完整参考，包括配置、编译、调试、网络优化等。TRIGGER when: 用户开发 ESP32 Minecraft 服务器、配置 globals.h、调试网络问题、优化性能、或需要了解嵌入式 Minecraft 服务器时触发。SKIP: 非 ESP32 平台的 Minecraft 服务器开发。 |
本技能提供在 ESP32 上运行 Minecraft Java 服务器的完整参考，基于 ESP32-MC 和 bareiron 项目。
当用户执行以下操作时触发此技能：
globals.h 文件以下情况不触发此技能：
// TCP 端口（Minecraft 默认 25565）
#define PORT 25565
// 最大玩家数（内存槽位，非并发数）
#define MAX_PLAYERS 16
// 最大 Mob 数
#define MAX_MOBS (MAX_PLAYERS)
// 游戏模式: 0 生存, 1 创造, 2 冒险, 3 旁观
#define GAMEMODE 0
// 最大视距（区块数）
#define VIEW_DISTANCE 2
// Tick 间隔（微秒），默认 1 秒
#define TIME_BETWEEN_TICKS 1000000
// 每秒 Tick 数（自动计算）
#define TICKS_PER_SECOND ((float)1000000 / TIME_BETWEEN_TICKS)
// 区块大小（建议 2 的幂）
#define CHUNK_SIZE 8
// 记住最近访问的区块数（避免重复发送）
#define VISITED_HISTORY 4
// 最大方块修改数（决定内存占用）
#define MAX_BLOCK_CHANGES 20000
// 网络超时时间（微秒）
#define NETWORK_TIMEOUT_TIME 15000000
// 接收缓冲区大小
#define MAX_RECV_BUF_LEN 256
// 广播所有移动更新（低 Tickrate 更流畅）
#define BROADCAST_ALL_MOVEMENT
// 根据玩家数缩放移动更新频率
#define SCALE_MOVEMENT_UPDATES_TO_PLAYER_COUNT
// 流体流动（计算密集）
#define DO_FLUID_FLOW
// 箱子支持（每个箱子占 15 个 block change 槽）
#define ALLOW_CHESTS
// 飞行模式
// #define ENABLE_PLAYER_FLIGHT
// 拾取动画
#define ENABLE_PICKUP_ANIMATION
// 仙人掌伤害
#define ENABLE_CACTUS_DAMAGE
// 服务器品牌（F3 调试信息）
#define SEND_BRAND
// 同步世界数据到磁盘/Flash
// ESP 平台默认关闭（Flash 写入慢且不稳定）
#ifndef ESP_PLATFORM
#define SYNC_WORLD_TO_DISK
#endif
// 磁盘同步间隔（微秒）
#define DISK_SYNC_INTERVAL 15000000
// 方块修改按间隔同步（而非即时）
// #define DISK_SYNC_BLOCKS_ON_INTERVAL
// 记录未知包 ID
// #define DEV_LOG_UNKNOWN_PACKETS
// 断开时打印网络诊断
#define DEV_LOG_NETWORK_DIAGNOSTICS
// 记录包长度不一致
#define DEV_LOG_LENGTH_DISCREPANCY
// 记录区块生成日志
// #define DEV_LOG_CHUNK_GENERATION
// 最小 Play 包引导（排查掉线）
#define DEV_MINIMAL_PLAY_BOOTSTRAP
// 启用 0xBEEF/0xFEED 世界数据导出导入（无鉴权）
// #define DEV_ENABLE_BEEF_DUMPS
// 初始世界种子（启动后会再 hash）
#define INITIAL_WORLD_SEED 0xA103DE6C
// 初始随机种子（掉落和 Mob 行为）
#define INITIAL_RNG_SEED 0xE2B9419
// 地形基准高度
#define TERRAIN_BASE_HEIGHT 60
// 洞穴基准深度
#define CAVE_BASE_DEPTH 24
// Biome 大小（建议 2 的幂）
#define BIOME_SIZE (CHUNK_SIZE * 8)
#define BIOME_RADIUS (BIOME_SIZE / 2)
code.inoinclude/globals.h）# Linux
./build.sh
# Windows (MSYS2 MINGW64)
pacman -Sy mingw-w64-x86_64-gcc
./build.sh
# 运行
./bareiron.exe
| 文件 | 功能 |
|---|---|
code.ino | Arduino 入口，连 WiFi，启动主任务 |
main.c | 主循环、连接管理、收包分发 |
packets.c | 协议收发 |
procedures.c | 玩家、方块、Mob、Tick 逻辑 |
worldgen.c | 地形和区块生成 |
crafting.c | 合成和熔炉 |
serialize.c | 世界数据读写 |
globals.h | 主要开关和常量 |
| 文件 | 功能 |
|---|---|
src/ | 源代码目录 |
include/ | 头文件目录 |
include/globals.h | 配置文件 |
build.sh | 构建脚本 |
build_registries.js | 注册表构建工具 |
使用 wifi_config.cpp 中的配网流程：
在 include/globals.h 中配置：
#define WIFI_SSID "your-ssid"
#define WIFI_PASS "your-password"
默认写入 world.bin 文件。
globals.h 中的 SYNC_WORLD_TO_DISKDISK_SYNC_BLOCKS_ON_INTERVAL启用 DEV_ENABLE_BEEF_DUMPS:
0xBEEF 导出世界数据0xFEED 后跟数据上传世界数据注意: 无鉴权，仅限开发调试使用。
DEV_LOG_* 选项DEV_LOG_NETWORK_DIAGNOSTICSDEV_MINIMAL_PLAY_BOOTSTRAP 排查掉线DEV_ENABLE_BEEF_DUMPS 导出世界数据