Repository navigation
JCM v2.3.0-beta-2.yanyang.3
Pre-releaseJCM Yanyang 2.3.0-beta-2.yanyang.3 — 全代码库 bug 与性能审计(yanyang.3):7 项关键修复 + 30 余项正确性/性能/加固修复;原生脚本平台矩阵扩展至 7 个平台(新增 Linux ARM64、Android、iOS/iPadOS)。本 Release 同时包含 yanyang.1(原版 2.3.0-beta.2 整合)与 yanyang.2(scriptLocations 自动语言判定与 JS + C++ 混合条目)。
原生平台扩展 / Native platform matrix (yanyang.3)
- 每个新 jar 内置 7 个平台的 JNI bridge:windows-x64、linux-x64、linux-arm64(ARM 桌面 + Pojav 类 Android 启动器的 glibc JVM)、macos-x64、macos-arm64、android-arm64(NDK arm64-v8a、16 KB page 对齐)、ios-arm64(Mach-O dylib,iOS 与 iPadOS 共用,侧载工具负责重签)。
- 修复平台键把 Linux/Windows ARM64 一律归为
-x64的旧 bug(ARM64 Linux 此前永远解析到错误目录);Linux+aarch64 环境按 linux-arm64 → ios-arm64 → android-arm64 依次回退,覆盖 iOS 沙箱内os.name=Linux的 JVM。 - native SDK zip 同步附带 7 平台的示例模块预编译库。
关键修复 / Critical fixes (yanyang.3)
- F3+T 资源重载从未真正重载 C++ 脚本:
NativeScriptManager.reload()是死代码——更新后的.so/.dll被静默忽略,且重载后NativeHost继续引用已被ModelManagerJS.reset()释放的模型(渲染线程 use-after-free)。现在重载会先释放全部模块再重新解析。 - 模组记录流越界可崩溃整个 JVM:桥接层
patch_frame_handles无边界校验地遍历模块提供的record_count/record_size(在模块崩溃保护之外执行 memmove)。现已逐步校验。 - 单个损坏的 MTR 4 脚本条目会中止整个资源包的解析(vehicle/eyecandy/lift 三类全部受牵连);
NativeScriptManager.load()遇到非法库标识符(大写路径等)直接逃逸。现逐条目隔离并跳过。 - C++
Text/Texture未设置的字段被清零覆盖:未设color完全透明、未设scale尺寸为零、未设uv退化、未设align居中——官方示例pids_arrivals.cpp即受影响。默认值现由单一来源提供。 - Forge 端原生车辆脚本只捕获不渲染(
VehicleResourceMixin从未接入原生回放);Forge 端轨道裁剪逻辑反转(限内轨道永远渲染、从不遮挡剔除——原版上游同样存在)。 - 阴影 pass(Iris/OptiFine)下车辆/电梯脚本每帧被驱动两次;骑乘中被视锥裁剪的电梯会冻结玩家;
mtrDispose永远拿到实例首帧的快照。 - C++ SDK 访问器(
Stop::interchange/exit、Exit::destination、StopList::at、Train::car、Train::rail_progress)全部补齐越界检查——脚本差一即越界读取快照 direct-ByteBuffer 并 SIGSEGV 整个 JVM。
性能 / Performance (yanyang.3):每车每帧一棵共享车厢位置树(原先每车 2N+1 棵,12 节列车 ≈ 每秒 1500 次全树重建)、仅对持有原生脚本的车辆计算视锥盒、零分配一次性追踪、rasterizeText 直读 int[]、gfx2d 复用草稿缓冲、泄漏修剪(SCRIPT_IDS/TRACED/CAR_POSITIONS)、失败加载负缓存、稳定临时文件名、clearDeadInstance 去快照化;font5x7 补齐小写 a-z(原先小写渲染为空白)。
**yanyang.2 — minecraft_custom_resources.json 脚本条目不再需要 language 字段:scriptLocations 逐条目自动判定语言,同一条目可混用任意数量的 JavaScript 与 C++ 脚本。
新版声明格式 / New declaration format
"vehicleScripts": [
{
"id": "cst_sp1900_lcd",
"prependExpressions": ["print('Hello world')"],
"scriptLocations": ["mtr:my_pack/js/sp1900_lcd/main.js", "mtr:my_pack/natives/sp1900_train_num"],
"input": { "yearEra": 2004 },
"dataFetchMode": "ALL"
}
]*.js(大小写不敏感)→ JavaScript;无扩展名 → C++ 平台无关 stem(natives/{platform}/lib*.so|*.dll|lib*.dylib自动解析);.so/.dll/.dylib完整路径与按平台映射表亦可用。- vehicle / lift / eyecandy / pids 四类脚本全部支持混合:JS 部分连接成单一 ParsedScript,C++ 模块全部挂到同一脚本 id;两侧各自捕获、各自回放,互不冲突;某一侧缺失或失败只跳过该侧(附提示),另一侧照常渲染。
- PIDS 预设(
joban_custom_resources.json)新增同样的scriptLocations键,与老的scriptFiles并存。 - 老格式完全兼容:
"language": "cpp"+nativeLibrary/nativeLibraries仍是纯 C++ 条目(也可与.js混用);"language": "javascript"强制全 JS;MTR 3script_files语义不变。 - 混合电梯条目下内置渲染只抑制一次、乘坐移动每帧只应用一次;eyecandy 方块使用事件同时送达 JS 与 C++。
En (summary): script entries no longer declare language — each scriptLocations entry is auto-classified (*.js = JavaScript, anything else = a C++ module) and any number of both may be mixed in one entry. Vehicles, lifts, eyecandies and PIDS all support it; each side captures into its own replay registry (no draw-call conflicts) and a failed part degrades gracefully. Legacy language: "cpp" / nativeLibrary declarations keep working and may be combined with .js entries. PIDS presets gain the same scriptLocations key.
翻译对齐原版 / Translations aligned with upstream
- 语言文件与原版 JCM(同样由 BugQuantumCore 维护翻译)逐键对齐、原版优先;本版采纳原版
main的爱尔兰语(ga_ie)占位与捷克语新键。
保留的全部晏阳能力 / All Yanyang features retained
getTransportType()返回 MAGIC MTR Addon 车辆类型 + 4 种基础类型(JS / Java / C++,ABI 9;可选反射集成,无硬依赖)。- 原生脚本零 GC 卡顿:StopsData 跨帧复用、零分配快照 Builder、JNI 边界收窄(无 256 KB 拷贝)、1 MB 按需像素 arena。
- 原生车辆视锥剔除(
VehicleCulling)与原版 beta.2 的 MTR 层剔除互补;ABI 6/7/8 模块与 ABI 9 并存。 - 12 jar(6 MC 版本 × Fabric/Forge,各 ~24.6 MB,内置 4 平台 bridge)+ native SDK zip,随本 Release 附带。