Repository navigation
Releases
mcpy macOS runtime 0.4.9
0.4.9 lets two macOS clients join the same development server. Use mcpywrap
0.7.5, which selects this runtime by default for fresh installations; mcpy connect <host> --port <port> --clients 2 then starts both players with distinct
anonymous developer identities.
mcpy already assigns each dual-client role its own identity and writes it to the
session cppconfig as player_info, but the launcher joined every network session
as LocalDev with user id 0. Two clients therefore shared a name and UUID, and
the server disconnected the first one as logged in elsewhere. The launcher now
passes player_info to InitOfflinePlayer and join_world. The identity must be
an integer user id between 1 and 2^31-1 and a 1–16 character name of letters,
digits or underscores; anything else is rejected before launch instead of being
embedded in the game-side expression. Without player_info a session still
joins as LocalDev, so single-client behavior is unchanged. The capability is
declared as developer_identity_protocol=1.
Validated on Apple Silicon / macOS 26.6.2 / developer APK 3.10.100.301421 against
a local Nemisys + SynapseAPI + Nukkit server: two clients from one --clients 2
group joined with different names and UUIDs, stayed connected through repeated
group restarts and exchanged real melee hits for a recorded comparison. Unit
tests cover the default identity, a distinct identity from cppconfig and invalid
or injected identities.
This release keeps every capability of 0.4.8 (plain-source network packs,
background window, screenshots, input clock, cppconfig, unauthenticated
connections and the host interfaces used by the built-in Tracy profiler).
Existing worlds remain bound to their original runtime; upgrading the CLI does
not silently migrate them.
The runtime contains no Minecraft APK, game library/assets, worlds or account
credentials. The corresponding recursive source archive, licenses and SHA256SUMS
accompany this runtime. It is ad-hoc signed, without a Developer ID certificate
or notarization. Its deployment target is macOS 13; live validation was on
macOS 26.6.2.
mcpy macOS runtime 0.4.11
0.4.11 lets developers choose the offline player name, including Chinese
nicknames, for local worlds and server connections. Use mcpywrap 0.7.7, which
selects this runtime by default for fresh installations and adds
--player-name to run, connect and --clients 2.
Local worlds always started as LocalDev with user id 0. The launcher now
accepts --player-name and --player-id for offline worlds. These pass the
identity to InitOfflinePlayer and play_world, and it is not written to the
instance cppconfig. Without them a world still starts as LocalDev. Network
sessions keep taking the identity from cppconfig player_info. Combining
--player-name with a network session or a custom command list is rejected.
Names may now contain Chinese characters as well as letters, digits and
underscores, up to 16 characters. Quotes, whitespace and control characters are
still rejected before a name is embedded in a game-side expression. The runtime
declares offline_identity_protocol=1.
Validated on Apple Silicon / macOS 26.6.2 / developer APK 3.10.100.301421 with a
fresh local world started as 测试玩家:
- The client and the server-side player list both reported that name.
- After reopening the same world as
Steve_1, the server reported the new
name and the host inventory was preserved.
Unit tests cover the default identity, English and Chinese identities for local
worlds and network sessions, and the rejected names.
This release keeps every capability of 0.4.10 (copy-on-write first-launch
assets, per-client developer identity, plain-source network packs, background
window, screenshots, input clock, cppconfig, unauthenticated connections and the
host interfaces used by the built-in Tracy profiler). Existing worlds remain
bound to their original runtime; upgrading the CLI does not silently migrate
them.
The runtime contains no Minecraft APK, game library/assets, worlds or account
credentials. The corresponding recursive source archive, licenses and SHA256SUMS
accompany this runtime. It is ad-hoc signed, without a Developer ID certificate
or notarization. Its deployment target is macOS 13; live validation was on
macOS 26.6.2.
mcpy macOS runtime 0.4.10
0.4.10 stops every world instance and network session from keeping its own
~400 MB copy of the game's built-in assets. Use mcpywrap 0.7.6, which selects
this runtime by default for fresh installations and also clones vanilla.mcp
into new data directories.
On the first launch of each data directory the game asks the launcher, through
copyInnerAssetDir, to copy the storge/asset tree out of the extracted APK.
The launcher did a plain recursive copy, so every instance stored an identical
copy of the shared engine's assets. Regular files are now copy-on-write clones
(clonefile on APFS, FICLONE on Linux) with the same merge and overwrite
behavior. The game can still modify its copy without affecting the shared
engine. Volumes that cannot clone, such as non-APFS or cross-volume
destinations, fall back to a normal copy. The engine log reports how many files
were cloned and copied. Nothing in the launch protocol changes, so no new
capability is declared.
Validated on Apple Silicon / macOS 26.6.2 / developer APK 3.10.100.301421: a
fresh data directory logged cloned 132, copied 0. Deleting the resulting 406
MB storge tree freed 104 KB of disk space, compared with 26 MB for a plainly
copied vanilla.mcp.
This release keeps every capability of 0.4.9 (per-client developer identity,
plain-source network packs, background window, screenshots, input clock,
cppconfig, unauthenticated connections and the host interfaces used by the
built-in Tracy profiler). Existing worlds remain bound to their original
runtime, and data directories that already hold copied assets are not changed;
only first launches with this runtime use clones.
The runtime contains no Minecraft APK, game library/assets, worlds or account
credentials. The corresponding recursive source archive, licenses and SHA256SUMS
accompany this runtime. It is ad-hoc signed, without a Developer ID certificate
or notarization. Its deployment target is macOS 13; live validation was on
macOS 26.6.2.
mcpy macOS runtime 0.4.8
0.4.8 lets network sessions load plain-source behavior packs delivered by a
development server. Use mcpywrap 0.6.5, which selects this runtime by default for
fresh installations and reports plain_source_packs in connect results.
The developer APK's MCP importer resolves only packed .mcs modules, so a pack
served as plain .py files failed with ImportError. Before joining, the runtime
now installs a source importer that handles only packs in the session's pack
cache which contain Python sources and no .mcp, .mcs or compiled files.
Reviewed .mcp packs, mixed packs and every other import path stay with the
game's own importer. Loaded packs are logged as [PlainSourcePack]; release
clients still require a reviewed .mcp, so a plain pack running on a development
server does not make it publishable. No local source directory is read and no
server-delivered content is replaced. The capability is declared as
network_plain_source_protocol=1.
Validated on Apple Silicon / macOS 26.6.2 / developer APK 3.9.100.297020 against
a local Nemisys + SynapseAPI + Nukkit server delivering both a reviewed .mcp
pack and a plain-source pack: the plain pack initialized from its delivered
sources while the .mcp pack loaded through the game importer as before. A
Python 2 behavior test covers archives, mixed packs, paths outside the session
cache, symlink escapes, bytecode suppression and idempotent installation.
This release keeps every capability of 0.4.7 (background window, screenshots,
input clock, cppconfig, unauthenticated connections and the host interfaces used
by the built-in Tracy profiler). Existing worlds remain bound to their original
runtime; upgrading the CLI does not silently migrate them.
The runtime contains no Minecraft APK, game library/assets, worlds or account
credentials. The corresponding recursive source archive, licenses and SHA256SUMS
accompany this runtime. It is ad-hoc signed, without a Developer ID certificate
or notarization. Its deployment target is macOS 13; live validation was on
macOS 26.6.2.
mcpy macOS runtime 0.4.7
修复 Android 兼容层的主机信息接口:uname 按 Bionic 6×65 字节布局转换,不再把 Darwin 5×256 字节结构写入调用方缓冲区;新增 sysinfo(取自宿主内核内存、负载、开机时长与进程数)与 getlogin。DeveloperCompat 终止桩只填补 libc-shim 缺失的接口,不再覆盖已实现的 ABI 转换。
开发者包内置的 Tracy 分析器由引擎在首次线程命名时自行启动,此前其工作线程因上述缺陷在监听前卡死或触发终止。运行包在加载游戏前默认设置 TRACY_ONLY_LOCALHOST=1、TRACY_ONLY_IPV4=1,只监听 127.0.0.1:8086(多实例顺延到 8105),已显式设置的环境变量优先;启动器不会再次启动分析器。viewer 版本须与游戏内置协议一致:3.9.100.297020 为 Tracy 0.11.1 / 协议 69。
保留 0.4.6 的全部能力与协议(后台窗口、截图、统一输入时钟、cppconfig、无认证网络连接等),未新增或移除能力声明。
在 Apple Silicon macOS 26.6.2、开发包 3.9.100.297020 使用发行压缩包验证:签名校验通过,干净实例进入 HUD,无未实现接口终止,仅监听 127.0.0.1:8086,协议 69 握手成功并持续收到分析数据;5 项原生测试通过,新增主机信息保护区测试。源码归档包含固定 Git 基线及修改文件清单,可从归档重建。
运行包不包含游戏或 APK。最低声明 macOS 13.0 尚未实机验证;采用 ad-hoc 签名,未经 Apple 公证。旧实例不自动迁移运行包;配套 mcpywrap 0.6.4 将新安装默认切换到本版本。
mcpy macOS runtime 0.4.6
支持 background_window_protocol=1:后台启动不主动聚焦、不切换全屏、不锁定或重定位系统光标;显式前台启动保留正常行为和原有偏好。
修复 macOS Mach 信号量等待被信号打断时的 Android/POSIX 错误码转换,避免保存退出期间 Python 锁状态异常。
在 Apple Silicon macOS 26.6.2、开发包 3.9.100.297020 验证后台 HUD、原生新帧截图、统一输入效果与取消释放、菜单、重启、全屏偏好、故障注入 ES3→ES2 回退和世界数据持久化;4 项原生测试通过。源码归档包含固定 Git 基线及修改文件清单,可从归档重建。
运行包不包含游戏或 APK。最低声明 macOS 13.0 尚未实机验证;采用 ad-hoc 签名,未经 Apple 公证。后台模式保留可见窗口,不保证隐藏、最小化或锁屏后的渲染。旧实例不自动迁移运行包。
mcpy macOS runtime 0.4.5
0.4.5 adds on-demand game screenshots through the native launcher control channel.
Use mcpywrap 0.5.1, which selects this runtime by default for fresh installations.
The existing screenshot command reads one game framebuffer, without ScreenCaptureKit,
screen-recording permission, a capture daemon, or continuous GPU readback.
Images contain game content and HUD in physical pixels, excluding the launcher
menu and tools. The host CLI encodes PNG; the render thread preserves GL state
and uses bounded anonymous memory. Requests are session-bound, cancellable and
time-limited. macOS video recording and video frame extraction remain unsupported.
Validated with the public CLI on Apple Silicon / macOS 26.6.2 / developer APK
3.9.100.297020: default and background-only captures produced 1440x939 PNGs,
record start returned capability_missing, temporary pixels were released, and
the test world saved and exited. Native tests cover idle behavior, request
isolation, cancellation, timeouts, GL state restoration and file-write failure.
Existing installations can explicitly install this release catalog, then use
run --new. Existing worlds remain bound to their original runtime; upgrading the
CLI does not silently migrate them. User instructions are maintained in the
mcpywrap built-in Skill.
The runtime includes the ARM64 Android compatibility layer, ANGLE Metal, source
Addon loading, client/server debugging, JSON UI reload and world configuration.
It contains no Minecraft APK, game library/assets, worlds or account credentials.
mcpy discovers the current developer APK via NetEase pe and validates its identity,
content digests and native compatibility before selecting it. The corresponding
recursive source archive, licenses and SHA256SUMS accompany this runtime.
The runtime is ad-hoc signed, without a Developer ID certificate or notarization.
Its deployment target is macOS 13; live validation was on macOS 26.6.2. This release
does not claim a new full game acceptance for the 3.10 developer APK or Intel Mac.
mcpy macOS runtime 0.4.4
0.4.4 fixes missing_monotonic_clock for mcpy unified game input on macOS.
The native launcher now exposes a steady clock to the game's Python 2 interpreter.
The game-owned float constructor is resolved through verified CPython structural
rules; missing or ambiguous bindings keep the clock disabled without disabling UI reload.
Use with mcpywrap 0.4.6, which selects this runtime for new installations. Existing
installations must explicitly install this release catalog and create a new instance
with run --new; upgrading the CLI does not change existing world bindings.
Validated on Apple Silicon / macOS 26.6.2 / developer APK 3.9.100.297020: eight live
cases passed, covering idle/pause timing, three overlapping movement/jump cases,
modifier-key cancellation, attacks while moving, chat navigation and UI clicking.
Server-side attack damage was confirmed (health 100 -> 95). Structural compatibility
also passed for 3.10.100.299889; its full input suite was not run for this release.
All test sessions were saved and stopped. No system clock changes were made.
Native Apple Silicon runtime for mcpy's local Minecraft China developer worlds.
Includes the Android compatibility layer, ANGLE Metal, source Addon loading,
client/server debugging, JSON UI reload, instance cppconfig and keyboard input fixes.
The runtime archive contains no Minecraft APK, game library, game assets, worlds,
or account credentials. mcpy downloads the current developer APK discovered via NetEase pe. It validates the APK identity,
records content digests and checks native structure compatibility before selecting
the installation. Existing local worlds retain their installed version. The corresponding recursive
source archive, licenses and SHA256SUMS accompany this runtime.
This runtime is ad-hoc signed, not Developer ID notarized. Deployment target is
macOS 13; actual game validation was performed on macOS 26.6.2. Windows continues
to use a manually installed MC Studio environment.
mcpy macOS runtime 0.4.3
0.4.3 adds unauthenticated server connections through the existing Android Python
world.join_world entry point; no new game binary patches. Requires mcpywrap 0.4.3+.
Validated with developer APK 3.10.100.299889 and a local offline Nemisys / SynapseAPI /
Nukkit stack on macOS 26.6.2. Network sessions support client Python only; external
HTTP resource-pack downloads, authenticated servers and the 0.4.2 unified input
clock are not part of this validation. Existing worlds keep their pinned runtime.
Native Apple Silicon runtime for mcpy's local Minecraft China developer worlds.
Includes the Android compatibility layer, ANGLE Metal, source Addon loading,
client/server debugging, JSON UI reload, instance cppconfig and keyboard input fixes.
The runtime archive contains no Minecraft APK, game library, game assets, worlds,
or account credentials. mcpy downloads the current developer APK discovered via NetEase pe. It validates the APK identity,
records content digests and checks native structure compatibility before selecting
the installation. Existing local worlds retain their installed version. The corresponding recursive
source archive, licenses and SHA256SUMS accompany this runtime.
This runtime is ad-hoc signed, not Developer ID notarized. Deployment target is
macOS 13; actual game validation was performed on macOS 26.6.2. Windows continues
to use a manually installed MC Studio environment.
mcpy macOS runtime 0.4.0
Native Apple Silicon runtime for mcpy's local Minecraft China developer worlds.
Includes the Android compatibility layer, ANGLE Metal, source Addon loading,
client/server debugging, JSON UI reload, instance cppconfig and keyboard input fixes.
The runtime archive contains no Minecraft APK, game library, game assets, worlds,
or account credentials. mcpy downloads the current developer APK discovered via NetEase pe. It validates the APK identity,
records content digests and checks native structure compatibility before selecting
the installation. Existing local worlds retain their installed version. The corresponding recursive
source archive, licenses and SHA256SUMS accompany this runtime.
This runtime is ad-hoc signed, not Developer ID notarized. Deployment target is
macOS 13; actual game validation was performed on macOS 26.6.2. Windows continues
to use a manually installed MC Studio environment.