MCphone Forge 1.20.1 v0.10.2

这是 MCphone 移植到 Minecraft 1.20.1 + Forge 的第一个发布版本。 1.21.1 那一支的功能已经全部搬过来了 —— 14 个 App、七个模组联动、三十多个网络包，一样不缺。

运行环境： Minecraft 1.20.1 · Forge 47.4.0 或更高 · 客户端与服务端都需安装 可选： Curios —— 装了多一个手机槽，手机能挂腰上 可选： Waystones（传送石碑）+ Balm —— 装了多一个「传送石」App 可选： MCEF —— 装了多一个「浏览器」App 可选： NetMusic（网络音乐机）—— 装了唱片仓还收它刻的 CD 可选： Patchouli（教程手册）—— 装了「阅读」里多它那批手册 可选： GuideME —— 同上，AE2 那批手册 可选： FTB Quests —— 装了多一个「任务书」App 可选： Integrated Dynamics —— 装了不多任何东西（这一支上它是预防性的，见下）

⚠️ 先说清楚这一版验到哪儿

别把它当成熟版本用。 这一支的代码、专用服务端启动、两道构建期校验都是绿的， 6 个断言测试 122,204 条全过；但界面这一层只在真游戏里点过一部分：

三十多个网络包是一次性挂上通道的，序号分配与两端握手目前只在专用服务端上"看着对"。 开个新存档试，别拿主力存档。 碰到问题请带上 logs/latest.log 开 issue。

1.0.0 留给"每个 App 都在游戏里点过"之后。

📱 这一支有什么

与 1.21.1 那一支功能等价：

• 开机：右键手机，或用快捷键（手上、背包、饰品槽都找得到）
• 14 个 App：设置、应用商店、聊天、相机、相册、音乐、末影箱、记事本、传送石、浏览器、时钟、天气、阅读、任务书
• 壁纸、设备名、字体配色、好友与聊天记录、笔记、已购 App 都随存档走

🔧 与 1.21.1 那一支的差别

绝大多数是看不见的（网络层、玩家数据、注册表在两个版本上是完全不同的 API）， 但有两处玩家能感觉到：

唱片判定变严了。 1.21 那边查的是 JUKEBOX_PLAYABLE 数据组件，所以别的模组、 甚至只靠 json 定义的唱片它都认得。1.20.1 上没有那个组件，曲长与音效直接挂在 RecordItem 这个类上，只能按类型判 —— 别的模组若没继承 RecordItem 而是自己 实现一套，这边就认不出来。这是 1.20.1 的天花板，不是偷懒。

配置界面还没有。 1.21 那边挂的是 NeoForge 自带的配置界面，Forge 1.20.1 没有内置的。 配置文件本身照常工作（config/mcphone-client.toml 与存档里的 mcphone-server.toml）， 只是暂时得手改。

📝 版本号说明

刻意不追 1.21.1 那一支的 1.8.x。 玩家看版本号判断的是"这一支有多完整"， 两支功能不等价的时候用同一个号等于骗人。这一支从 0.1.0（骨架）走到 0.10.2， 号段是它自己的。

🙏 第三方

jar 里嵌着 JavaMP3（MIT，用于音乐 App 解码 mp3）， 许可证全文见 jar 内的 THIRD-PARTY.txt。