MCphone v1.12.0

简体中文

升级须知

• 本次调整了本机文件目录，旧文件不会自动迁移或兼容读取。需要保留的音乐、小说、壁纸、表情、收藏和 App 记录，请按 新旧目录对照 手动放入新位置；App 可重新安装，原文件保留在原处。
• 本次包含聊天协议升级，联机客户端与服务端需要同步更新。

新增

• 脚本 App 支持客户端异步 HTTP/JSON 请求：GET/POST、请求头、正文、超时和页面函数回调，可在没有脚本服务端握手时使用；请求随整次操作成功提交，关闭 App 或切换账号会取消等待。增加网络问答及本地接口演示。

• 客户端内容和本地记录统一到游戏目录的 mcphone/：音乐、小说、壁纸、表情分类存放，安装记录、App 数据和收藏放在 data/；各文件夹入口同步更新。本次直接使用新路径，旧文件留在原处，不自动迁移或兼容读取。配置、签名密钥、世界数据及原版截图位置保持原样。

• 应用商店右上角增加文件夹入口，一键打开当前游戏目录的 mcphone/apps/，目录不存在时自动创建；空列表也能使用。

• SFC 客户端函数支持 0–4 个简单形参，按钮可传入字符串、整数、布尔值及列表索引/基本字段，复用同一个函数处理不同列表项；增加待办清单示例，失败时仍整体撤回点击。onInit() 保持无参。

• SFC 脚本 App 支持长文本阅读：页面字符串和 text 正文上限为 4096 个 UTF-16 单元，配合既有换行与滚动阅读；增加整页文本预算并只绘制可见行。单行输入框及旧 IR 限制保持原样。

• 脚本 App 支持无参 onInit()：页面首次创建时自动初始化，可读取本机保存的数据；返回已有页面时保留当前内容，关闭 App 后重开再次初始化，失败时保留默认值并提示。

• 脚本 App 的客户端函数支持本地字符串读取和保存，按登录账号与 App 隔离，无需脚本服务端握手；按钮操作成功后原子保存，失败时保留原数据。名字检查器示例增加保存和读取按钮。

• 脚本 App 可在 <script> 声明普通函数，并由按钮调用；函数可处理页面状态并即时刷新界面，失败或超限时撤回本次状态修改。

• 脚本 App 新增单行 text-input 组件：绑定字符串状态并实时回显，支持占位提示、长度限制、禁用和原版文字编辑；切页、失焦或隐藏时释放输入焦点。

• 美西螈私聊和群聊的附件菜单支持发送位置，点击后把当前 X、Y、Z 方块坐标作为普通文字消息发送；服务器关闭图片或图片上传队列已满时仍可使用。

• 美西螈私聊右上角的三个点可直接查看对方的个人资料；返回原聊天时保留未发送文字、引用及滚动位置，查看资料期间仍处理发送确认。群聊继续打开群详情。

• 美西螈私聊和群聊支持收藏已加载的图片，收藏列表可预览图片，详情支持动图播放、保存到相册及取消收藏；收藏后可独立查看，不依赖原消息和服务器图片保留时间。

• 收藏采用统一索引及 text、image 分类目录，预留 audio、file；旧文字收藏自动迁移，原 JSON 保留为备份，本机仍按账号和存档／服务器隔离。

• 设置中增加“更新日志”，支持滚动浏览分类内容、平台标注和链接；正文提供简体中文和英文，其他语言显示英文。

• 正式版首次打开手机时展示当前版本日志，出现即记为已查看；本机按账号和存档／服务器分别记录，同版本不会重复提醒。测试版仅支持手动查看。

修复

• 收藏列表和详情标题统一只显示发送者名字，移除来源会话名字，避免私聊收藏出现双份名字；已有收藏可直接查看。

• 修复本地音乐与原版声音线程共享全进程 OpenAL 上下文导致的自动停播，初始化及播放改用线程局部隔离。

• 本地音乐在游戏卡顿耗尽缓冲后可恢复同一音轨；用户暂停、显式停止与真正播放结束仍保持原语义。

优化

• 右键菜单悬停行使用柔和的半透明灰底，复用面板及按钮的细分圆角，避免手机放大后出现明显切角台阶；文字和图标同步强调并跟随字体主题，删除项保留红色，禁用项保持不可选。

• 美西螈私聊和群聊支持引用文字、图片摘要；输入栏提供可取消的引用预览，回复气泡显示作者及原文摘要。

• 引用只提交消息 ID，服务端按会话与可见性生成单层快照；引用回复不嵌套，图片引用不读取额外像素。

• 引用发送等待服务端回声，超时或本地目标失效保留正文；旧聊天记录可继续读取。

• 本次聊天线格式升级，客户端和服务端须同步更新。Forge 通道 13、NeoForge 通道 10；Fabric 相关正文 payload 更新 ID，群协议更新为 v5，并检查新旧端协议是否匹配。

• 固定旧消息 ID 的迁移种子，防止新增正文属性改变旧消息身份和个人删除标记。

• 引用提交按独立票据确认，超时重试复用同一次身份，避免重复落库及通知；等待期间改动过的草稿不会被旧回声清空。

• 私聊补发回声按消息 ID 去重；图片缓存增加元数据条数上限，被逐出的后台解码结果不再重新创建条目。

• 引用菜单补上圆环左引号图标，按参考图调整方向、尺寸及对齐，随主题文字着色；保留 Lucide 原稿与许可。

相关链接

• 查看 GitHub 发布记录。

English

Upgrade notes

• Local file locations have changed. Old files are not migrated or read automatically. Move media, favorites and App records manually using the directory guide, or reinstall Apps. Original files remain untouched.
• This release updates the chat protocol. Multiplayer clients and servers must update together.

Added

• Script apps can send asynchronous client-side HTTP/JSON requests with GET/POST, headers, bodies, timeouts and page-function callbacks, without a script-server handshake. Requests are published only after the operation commits; closing the App or changing accounts cancels pending work. Added a request demo and a local fixture server.

• Client content and local records now use the game directory's mcphone/ tree, with media in dedicated folders and install records, App data and favorites under data/. Folder shortcuts use the new locations. Old files remain untouched and are not migrated or read automatically. Configuration, signing keys, world data and vanilla screenshots keep their locations.

• Added a folder shortcut to the App Store header. It opens mcphone/apps/ in the current game directory and creates it if missing, including when the store list is empty.

• SFC client functions accept 0–4 simple parameters. Buttons can pass strings, integers, booleans and list indices/primitive fields to reuse one function across rows. Added a todo-list sample; failed clicks still roll back atomically. onInit() remains zero-argument.

• SFC script apps support long-text reading: page strings and text bodies accept up to 4096 UTF-16 units with existing wrapping and scrolling. Page text budgets and visible-line rendering bound the work; single-line inputs and legacy IR retain their limits.

• Script apps can declare a zero-argument onInit() to initialize each new page state and restore local data. Returning preserves the page; reopening the App initializes it again. Failures keep defaults and show a notice.

• Client script functions can read and save local strings, isolated by login account and App without a script-server handshake. Successful clicks save atomically; failures preserve existing data. The name-checker sample now includes save and load buttons.

• Script apps can declare page-local functions and invoke them from buttons. Valid state changes refresh the UI; errors and execution-limit failures roll back the click.

• Script apps can use a single-line text-input bound to string state, with live updates, placeholders, length limits, disabled state and vanilla text editing. Page changes, focus loss and hidden fields release keyboard focus.

• The attachment menu in Axolotl private and group chats can send the player's current X, Y and Z block coordinates as a plain text message. Location remains available when images are disabled or the image upload queue is full.

• The top-right menu in Axolotl private chats opens the other player's profile. Returning preserves the unsent draft, reply preview and scroll position, while send confirmations continue to be processed. Group chats still open group details.

• Axolotl private and group chats can favorite loaded images. Favorites show image previews and support animated playback, gallery export and removal. Saved images remain available independently of the original message and server image retention.

• Favorites use one index with separate text and image directories, reserving audio and file directories. Existing text favorites migrate automatically while the original JSON remains as a backup. Storage remains local and scoped per account and world/server.

• Added Changelog to Settings, with scrollable categories, platform labels and links. Notes are available in Simplified Chinese and English; other languages use English.

• Opening the phone on a new stable release shows that version's notes once. Viewing progress is stored locally per account and world/server, and is recorded as soon as the popup appears. Prerelease notes are available manually.

Fixed

• Favorites now show only the sender's name in both the list and detail view, removing the conversation name that duplicated private-chat names. Existing favorites remain readable.

• Isolated local music playback from the process-wide OpenAL context used by the vanilla sound thread, preventing unexpected playback stops.

• Local music resumes the same track after a game stall exhausts its buffers, while preserving user pause, explicit stop and actual end-of-track behavior.

Improved

• Context menus use a soft translucent neutral hover background with the same subdivided rounded corners as panels and buttons, avoiding coarse cut corners when the phone is enlarged. Text and icons gain emphasis using the current font theme. Delete remains red, and disabled entries remain unavailable.
• Axolotl private and group chats support replies to text and image summaries, with a cancellable input preview and an author/original-text preview in the reply bubble.
• Replies submit only a message ID. The server creates a single-level snapshot according to conversation visibility; replies do not nest or load extra image pixels.
• Reply drafts are kept when the server echo times out or the local target becomes unavailable. Existing chat history remains readable.
• [Forge 1.20.1 / NeoForge / Fabric] Clients and servers must update together. Forge channel is now 13, NeoForge channel 10; Fabric body payload IDs changed, group protocol is v5, and protocol compatibility is checked.
• Legacy message ID migration uses a fixed seed so new body properties cannot change old message identities or personal deletion markers.
• Reply sends use independent confirmation tickets. Retries reuse the original identity to avoid duplicate storage and notifications; late echoes cannot clear a newer draft.
• Private-chat echoes are deduplicated by message ID. Image-cache metadata has a bounded entry count, and evicted background decodes cannot recreate entries.
• The reply menu has an aligned quotation icon that follows the theme's text color. The original Lucide artwork and license are retained.

Links

• Browse GitHub releases.