C++ 原生脚本

这是什么

Joban Client Mod（JCM）原版允许资源包用 JavaScript 编写动态显示脚本。Yanyang 分支在此基础上加入 C++ 原生脚本：把脚本编译为本机共享库（.dll / .so / .dylib），由模组在游戏内加载并逐帧驱动。

C++ 脚本与 JS 脚本可以在同一个声明条目里混用、同时渲染。模组按文件特征自动判定语言——.js 是 JavaScript，其余按 C++ 模块解析。两侧各自捕获绘制指令、各自回放，互不干扰。

一帧的旅程

十五行的 PIDS 脚本

#include <mtr/script.hpp>

struct ArrivalState {};

struct ArrivalDisplay : mtr::PidsScript<ArrivalState> {
    static constexpr auto ID = "example:arrivals";

    void render(mtr::PidsContext& ctx, ArrivalState&, const mtr::Pids& pids) override {
        for (int row = 0; row < pids.rows(); row++) {
            if (pids.is_row_hidden(row)) continue;
            std::string text = pids.get_custom_message(row).str();
            if (text.empty() && row < pids.arrivals().size())
                text = pids.arrivals().at(row).destination().str();
            if (!text.empty())
                mtr::Text::create().text(text.c_str())
                    .pos(2, row * 10.0 + 2).size(pids.width() - 4, 9).draw(ctx);
        }
    }
};

MTR_REGISTER_PIDS_SCRIPT(ArrivalDisplay)

没有 JNI、没有反射、没有逐调用的装箱——pids.rows()、arrivals().at(i).destination() 都是紧凑快照上的普通内存读取。

什么时候选 C++

兼容性

文档目录