MCphone v1.10.2

这一版正式支持 Minecraft 1.21.1 Fabric，同时多了一台设备（平板）、一个能看自己 txt 小说的阅读器，照片右下角开始印坐标。

运行环境：

• Minecraft 1.21.1 · NeoForge 21.1.200 或更高
• Minecraft 1.21.1 · Fabric Loader 0.15.0 或更高 · Fabric API
• Minecraft 1.20.1 · Forge 47.4.0 或更高
• 客户端与服务端都需安装

升级： 直接替换 jar。存储格式没动，存档、好友、聊天记录、笔记、买过的 App、手机里的唱片与终端全部原样保留。

🧵 Minecraft 1.21.1 Fabric

同一套 MCphone 现在正式提供 Fabric 1.21.1 构建，十五个内建 App、手机与平板、 副手 HUD、聊天与服务端配置同步都随这一份移植过去。它和 NeoForge / Forge 包使用同一个 版本号，但 jar 不能混用；下载时请选择文件名带 1.21.1-fabric 的那一份，并安装 Fabric API。

正式版同时修掉了 Fabric 相机里一个只接了一半的事件：按键设置中虽然能看到快门与退出键， 客户端却没有把读取它们的处理器挂到 tick 上，所以 V / X 都没有反应。现在快门、分帧截图和 退出相机的整条链路已经接通。

📐 平板 —— 同一台机器，屏幕换个方向

合成是手机外面包一圈铁锭（3×3，中间放手机，八格铁锭）。

屏幕从竖着的 120×200 变成横着的 240×168，宽正好是手机的两倍。导航栏立到了右边：横过来之后最缺的是高度，而宽有 240，右边让出 14 几乎看不出来。电源键挪到顶边、音量键到底边，都靠左那一头——右侧那一条已经是导航栏了。

它不是另一部手机。 App、聊天记录、笔记、壁纸、买过的东西、卡槽里的终端全是同一份——这些数据本来就存在玩家身上。两台可以同时带着，随手拿哪个都行。

多出来的是地方：

副手 HUD、快捷键、终端卡槽、末影箱、唱片仓一样都能用——那些地方判断的是"身上带着本模组的设备吗"，平板一并算数。装了 Curios 的话，平板也能放进那个手机槽（与手机共用一格，一次挂一台）。

已知：给手机起过的设备名不会跟着合成走（原版合成不带走物品上的数据），平板要另起一个。

📖 阅读 App：看自己的 txt 小说

把 txt 放进 config/mcphone/reader/books/，它就直接出现在书架上，点开就是手机里的阅读器——不再需要为了看小说切出游戏。本地小说不经过书城，要它离开书架，把文件挪走就是了。

• 编码自己猜：先看 BOM，再严格试 UTF-8，都不是就把 GB18030 与 Big5 各解一遍、挑"更像中文"的那个。GBK 的老书、记事本另存的、港台来源的都认。
• 章节自己认：规则抄的是 legado 自带的那份 TXT 目录规则。"第一章 风起""第一百二十三回""楔子""Chapter 12" 都认；正文里的"第二部分""他想起第三章说过的话"不会被误当成标题。认不出章节的按两千字一段切开，照样翻得动。
• 读到哪儿记着：每本记一对"第几章、第几页"，换服务器、换存档都跟着走。
• 全屏读：右上角「全屏」把整块窗口让给这本书，一页从两百来字变成一千多字。正文居中一栏（约 35 字一行），再宽的屏幕也不会让眼睛找行首。
• 边走边看：手机挂在副手 HUD 上时 PageUp / PageDown 直接翻页（键位可改）。手机一旦成了打开的界面，原版就不吃移动键，而看小说最想要的恰恰是赶路、挂机的时候看。
• 放书三条路：丢进目录；在书架页点右上角「文件夹」让系统打开它；或者把 txt 拖进游戏窗口。重名自动加 (2)(3)，不会覆盖你正在读的那本。

书架上的书还可以按住上下拖着排，拖到边缘会自动滚动。只有书架页、且没在搜的时候能拖。

边界：单个文件上限 32 MB；只认 .txt，epub 与 mobi 是压缩包，那是另一件事。

📷 照片上写着这是在哪儿拍的

拍下来的照片右下角印着按快门那一刻的坐标（X 123 Y 64 Z -890）。默认开着，在 设置 → App 管理器 → 相机 → 坐标水印 里关。

坐标是画进照片里的，不是附带的一份数据：相册里、screenshots/ 里那张 png、发给没装本模组的人的那一份，看到的都是同一行字。取景时就看得见，所见即所得。白字四面描黑边（不是阴影——阴影只偏右下，白字压在雪地、夕阳上时左上两条边仍会糊），字号按画面高度算而不跟着 GUI 缩放走。

坐标同时写进文件名（2026-09-08_14.32.10_X123_Y64_Z-890.png），相册看大图时下面那一行显示的就是它——整张照片塞进一百来像素宽时，烧进去的那行字只剩一两个像素高，谁也读不出来，所以界面上用文字再写一遍。认不出坐标的（F2 截的图、这一版之前的照片）照旧显示文件名。

代价说在前面：拍完改不了。 这一版之前的照片不会凭空长出坐标，关掉开关也擦不掉已经拍下的那些。

🧩 给附属与资源包作者

• 附属页面不用改。 PhoneCanvas 给的 x/y/width/height 一直是"这块屏幕的内容区"，平板上是 226×158，导航栏那 14 已经替你让开。把 120 写死在自己代码里的那些，现在会看出来。
• 平板的模型是 models/item/tablet.json（tablet_black / tablet_white），与手机同一套结构、同一张 textures/item/device_*.png，切换键仍是 mcphone:screen_on。
• 外壳贴图按九宫格拉伸：手机上与从前逐像素相同。平板另有 textures/phone/frame_tablet.png（不做也不会出错，会退回 frame.png 顶着用）。
• 坐标那一行的格式走翻译键 mcphone.camera.stamp，资源包覆盖它就能改写法。

🔧 顺带

修：身上同时开着两台时（副手 HUD 挂一部、手里全屏开一部），收起 HUD 那部会把手里那部的屏幕一起报灭——别人看到的是一台正开着界面、屏幕却黑掉的机器。"屏幕在别人眼里亮不亮"从此每 tick 算一次，不再靠开关机各报一次。

修：Curios 的手机槽此前在饰品栏界面上显示的是 curios.identifier.phone 这么一行原始键，中英文都没有。

屏幕尺寸从两个编译期常量变成跟着设备走的一份 DeviceMetrics，主屏与商店的列数改为按内容区宽度算、整排居中；导航栏的绘制坐标与命中判定从此是同一份，不会出现"看得见点不到"。这些不碰 Minecraft 的部分由 docs/DeviceLayoutTest 的 90 条断言钉着，加上阅读那三样：ShelfOrder（36 条）、TxtChapters（75 条）、TextDecoder（26 条）——这几件事的错法都是"在游戏里看不出来"，所以一条都不靠肉眼验。