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++

相容性

文件目錄