Repository navigation
JCM v2.3.0-beta-2.yanyang.6
Pre-releaseJCM Yanyang 2.3.0-beta-2.yanyang.4 — GC 与稳态分配优化(yanyang.4):脚本渲染管线(JS + C++)的「捕获→回放」稳态分配降至接近零,从根源消除 GC 周期性停顿导致的瞬时卡顿;含 2 项新发现的正确性修复。本 Release 同时包含 yanyang.3(全代码库审计 + 7 平台原生矩阵)、yanyang.1 与 yanyang.2 的全部内容。
GC / 分配优化 (yanyang.4)
- 变换隔离零拷贝:
StoredMatrixTransformationsMixin(新增 mixin,双加载器)暴露 mark/truncate,ScriptRenderManager.invoke不再为每个绘制调用做storedMatrixTransformations.copy()(每车每帧 N 次「新对象 + 新 ObjectArrayList + 全元素拷贝」);NativeContentDriver的逐上下文transform.copy()全部移除。 - 原生绘制调用池化:
NativeModelDrawCall/TextWrapper/TextureWrapper(原生记录回放创建的实例)经空闲链表复用,由每帧本就执行的reset()/takeFrom()释放回收;JS 脚本持有的 wrapper 不受影响。 - 零拷贝捕获
takeFrom:ScriptRenderManager/ScriptSoundManager交换内部列表取代逐车逐脚本的copy()(VehicleScriptCallsHolder.Captured.capture、PIDSScriptInstance、EyeCandyScriptInstance、LiftScriptInstance);空声音帧不再分配。 - 矩阵零分配:
NativeModelDrawCall.pose在捕获时把姿态矩阵拷入实例私有可增长存储,持久消费者回放时读取——取代每记录float[count][16]+ 每 pose lambda + 新 SMT(6 节列车 10 个模型记录 ≈ 60fps 下 460 KB/s 短命数组);GraphicsHolderMatrixMixin复用渲染线程 JOMLMatrix4f/Matrix3f。 - 原生字符串与
Identifier驻留(NativeStringCache/CachedIdentifiers):C++ 脚本每帧发出的相同字符串/字体 id/声音 id 不再重复解码与解析。 - 跑马灯字形缓存(
TextWrapper):每字符两次「格式化 + 测量」降为内容或样式变化时一次;PIDSDrawCall的位置/层级消费者改为每实例一次分配。
正确性修复 (yanyang.4)
- 跨车辆矩阵 arena 别名:C++ 帧的 arena 由模块持有、仅在下一次该模块渲染前有效,而车辆管线先捕获全部再逐车回放——两辆车共享同一脚本模块时回放会读到最后一辆车的矩阵。现捕获时即拷入实例私有存储,结构上不可能串车。
- WeakHashMap 自引用泄漏(
RenderEyeCandyMixin,双加载器):眼糖变换缓存的 lambda 捕获了作为弱键的方块实体,条目永不可回收。现仅捕获基本类型,且位置平移并入缓存,整个基础变换仅在 NBT 变化时重建。 - 跑马灯缓存补上样式键(font/粗体/斜体):跨帧持有 wrapper 并改样式的 JS 脚本不再绘制过期格式。
yanyang.3 — 全代码库 bug 与性能审计:7 项关键修复 + 30 余项正确性/性能/加固修复;原生脚本平台矩阵扩展至 7 个平台(新增 Linux ARM64、Android、iOS/iPadOS)。
原生平台扩展 / 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 附带。