JS 之腳類型

車輛腳本

MTR 四代之「車輛」者，一節車廂模型之條目也；玩家於側線之界面，自如編組以成列。腳本不繫乎單節之廂，亦不繫乎整列，乃繫乎一腳本之條：車輛之條以 scriptId 引之，多車得復用同一之腳——混編、疾徐、NTE 相容，三美兼焉。

回呼凡三（ctx 者 VehicleScriptContext 也，vehicle 者 VehicleWrapper 也）：

function create(ctx, state, vehicle) { /* 首繪之前：建紋理、註回呼 */ }
function render(ctx, state, vehicle) { /* 每幀：讀狀態、納繪製與聲音之令 */ }
function dispose(ctx, state, vehicle) { /* 退場：釋紋理 */ }

VehicleScriptContext（ctx）

已廢 drawCarModel(...) / playCarSound(...) / setDataFetchMode(...) 仍可用；然新碼請用上列之 RenderManager / SoundManager / 宣告之欄。drawConnModel（車廂連接之件）有兩式，呼之皆擲 NotImplementedException，以其未實現也；drawConnStretchTexture 則未設於此上下文。二者皆不可用。

VehicleWrapper（vehicle）

已廢：NTE 同名之舊口（getAllPlatforms / trainCars / speed / doorValue / mtrTrain 之屬）悉留可用，逐一與上表新口等價。

Stop（停站）

RouteInterchange（轉乘之線路）

color: int（RGB）· name: String；晏陽 增益之欄 getTransportMode(): TransportMode?、getTransportType(): String（含 MAGIC 之細分）、getRouteId(): long（來源線路之 id，缺數據為 0）——見 晏陽增補。

車輛數據獲取之式

MTR 四代惟同步鄰近之數據，而車輛腳本往往須整趟線路之站名。JCM 乃設三級之式（dataFetchMode 欄）：

裝飾腳本

懸於 MTR 裝飾（Decoration Object）模型之條：資源包中選該模型之裝飾方塊方被渲染，腳本乃始其工。註冊用 objects 加 objectScripts（MTR 三代舊式書於 eyecandy.json）；內容條上 isScriptControlled: true，可隱原模型，悉以畫面付腳本。

回呼凡三：ctx 者 EyeCandyScriptContext 也，eyecandy 者 EyecandyWrapper 也。

EyeCandyScriptContext（ctx）

EyecandyWrapper（eyecandy）

getModelId(): String（當前模型條目之 id）· getTranslateX/Y/Z(): float（GUI 之移，米）· getRotateX/Y/Z(): float（GUI 之旋，弧度）· pos(): Vector3f（方塊加移）· blockPos(): Vector3f · facing(): Direction · facingAngle(): double（朝向之角）· isCrosshairTarget(): boolean（準星所指，可用以彈提示）· getFullBrightness(): boolean · redstoneLevel(): int（0–15）。

已廢：欄直讀之式（eyecandy.translateX、eyecandy.prefabId 之屬）仍可用。

電梯腳本

懸於電梯轎廂之樣（材質）之條；玩家以電梯刷新器選其樣，乃效。註冊用 lifts 加 liftScripts；樣條之上 isScriptControlled: true，隱原模型。

回呼凡三：ctx 者 LiftScriptContext 也，lift 者 LiftWrapper 也。

LiftScriptContext（ctx）

getRenderManager(): RenderManager（基準者，電梯之基位加偏移，隨電梯而旋）· getSoundManager(): SoundManager（基準同上）· setDebugInfo(...)。

LiftWrapper（lift）與 Floor

PIDS 腳本

joban_custom_resources.json 之 pids_images 陣列中，預設之物件帶 scriptFiles 或 scriptTexts，即為腳本之預設（scriptInput / scriptRateLimit 之義與他類同；Yanyang 亦受 scriptLocations 混入 C++，見 相雜之條）：

{
    "pids_images": [
        {
            "id": "pids_demo",
            "name": "Demo Scripted PIDS",
            "scriptFiles": ["jsblock:scripts/pids_demo.js"],
            "scriptInput": { "theme": "dark" },
            "scriptRateLimit": 0.75
        }
    ]
}

預設之欄 outOfBound: boolean（上游 v2.3.0-prerelease.3）：屏出相機視界之外，仍續繪之不輟——投影機之預設（pids_projector），須臾不可停者，賴乎此。

PIDS 之上所畫者，世界中之多邊形也，非 2D 之畫布——元素得出屏之界，界內之裁剪，腳本自任其責（誠須繁難裁剪 / 圖像之處理，以 GraphicsTexture 畫成而貼之）。繪之序，即其層：後畫者蓋先畫者；預設每繪一次，沿 z 之向移一小步（0.0002）以防 z-fighting；得以 ctx.setAutoZOrdering(false) 閉之，改手動 zOrder()（ctx.setZOrderStep(m) 調其步長）。

PIDSScriptContext（ctx）與 PIDSBlockEntity（pids）

ctx.getRenderManager() / ctx.getSoundManager()（基準者，方塊之位）· ctx.setAutoZOrdering(b) · ctx.setZOrderStep(m) · ctx.setDebugInfo(...)。

ArrivalEntries 與 ArrivalEntry

ArrivalEntries：get(i): ArrivalEntry?（每站台至多取到站十條）· length(): int（到站之總數，上游 v2.3.0-prerelease.3）· mixedCarLength(): boolean · platforms(): List<Platform> · forEach(consumer) / forEach(platformId, consumer)（逐條而歷，免手動判空）。

ArrivalEntry：destination(): String · arrivalTime() / departureTime()（Unix 毫秒，以 new Date(v) 化為 JS 之期）· arrived() / departed() · deviation(): long（相對圖定：正者晚點，負者早點）· realtime(): boolean（圖定，或實時所推）· departureIndex(): long · terminating(): boolean（終到於本站）· route(): SimplifiedRoute? / routeId() / routeName() / routeNumber() / routeColor() / circularState() · platform(): Platform? / platformId() / platformName() · carCount() / cars(): List<CarDetails>。

Text / Texture / Rect（繪事三具）

三者皆「造 → 鏈式之配 → draw(ctx)」流式之物也；Rect 者，貼圖硬編為純白 PNG 之 Texture 也：

Texture 專屬：texture(id)（PNG 或 mcmeta）、uv(u1, v1, u2, v2)（0–1）。

不須腳本乎？pids_images 中惟書 background / color / fonts / showWeather / showClock / hidePlatform / hideRow / topPadding / textOverflowMode 諸 JSON 之欄，即為「JSON 預設」——簡易改容，足用矣；且與腳本預設二擇其一，不可混書。

PSD 之腳（屏蔽之門）

為屏蔽之門之玻璃與其上之板作腳。於 mtr_custom_resources.json 增 psdScripts 之目——其式同 vehicleScripts（scriptLocations 之列，JS 與 C++ 可相混，逐條自辨其語），別立 type 之欄以擇所繫之面：

"psdScripts": [
    {
        "id": "psd_glass_pids",
        "type": "glass",
        "scriptLocations": [
            "mtr:my_pack/js/psd_glass_pids/main.js",
            "mtr:my_pack/native/psd_glass_pids"
        ],
        "dataFetchMode": "ALL"
    }
]

入遊戲，持新物「屏蔽門腳本編輯器」（與 MTR 之「刷」同列於創造之分類），於任意屏蔽門之玻璃（端玻璃、半高之 APG 閘門皆可；MTR、天津地鐵諸模組，凡本於 MTR PSD 之類者咸宜）或其上之板右擊之，界面既出，可擇同類之目或任一腳本 PIDS 之預設（PIDS 之腳如舊而行，畫布自適其面）；擇「無腳本」則解其繫。所繫存於伺服器，同維之眾咸得同步。

• 玻璃：衬以不透明之底——月台之側玄色（仿真 PIDS 深屏之觀），軌道之側純白（車中乘客惟見白板，不見鏡像之文）。腳之畫布居月台一側、藏於玻璃之內，自裁於玻璃透明之窗（依資源包模型與貼圖 alpha 而推；門框拉筋等不透明者仍顯於前而蔽其文）；兩門之間連續之玻璃共為一段、同用一布，整柱兩格者上下合而為一。畫布隨窗自適（每方 96 像素）。
• 其上之板：同一門區之上整段 psd_top 共用一布，其段不復顯舊有之箭頭 / 線圖——所顯者一由腳司之；餘段如故。畫布每方寬 96 像素（左右各留 0.125/16 之際）× 高 42 像素。

玻璃或頂板相連，未逾六十四格者，仍共一全幅，雖跨座標之界亦不分。逾此數者，循畫布右行之有號世界座標，以六十四格為齊界而分段，首尾可短；編輯器之繫解與頂板舊圖之隱，皆以同一子段為限。

繪畫之法與 PIDS 全同（Text / Texture / Rect 佐 ctx.draw，畫布之原點在可見面之左上）。數據之法（JS 之 psd 參 / C++ 之 mtr::Psd，訪問器之全備者見 數據快照 · Psd）：

C++ 之側，此第五類之基 mtr::PsdScript<State> 也（MTR_REGISTER_PSD_SCRIPT），數據快照曰 JcmPsdSnapshot（ABI 12；車站之目，自 ABI 13 始），例見 native/examples/psd_glass.cpp。

DisplayHelper（內建多屏之輔）

車載多屏現成之案：include(Resources.id("mtrsteamloco:scripts/display_helper.js")) 之後——

let slotCfg = {
    "version": 1,
    "texSize": [2048, 1024],
    "slots": [
        { "name": "lcd_north", "texArea": [0, 0, 2048, 274],
          "pos": [[[-0.59, 2.125, -1.75], [-0.755, 2.03, -1.75],
                   [-0.755, 2.03, -3.25], [-0.59, 2.125, -3.25]]],
          "offsets": [[0, 0, -5], [0, 0, 0], [0, 0, 5], [0, 0, 10]] }
    ]
};
let dhBase = new DisplayHelper(slotCfg);

function create(ctx, state, vehicle) {
    state.rl = new RateLimit(0.05);
    state.dh = dhBase.create();          // 立實例而繫其紋理
}
function render(ctx, state, vehicle) {
    if (state.rl.shouldUpdate()) {
        let g = state.dh.graphicsFor("lcd_north");  // 槽位之畫布（自為平移）
        // ... AWT 之繪 ...
        state.dh.upload();
    }
    for (let car of ctx.getMyCars())
        ctx.getCarRenderManager(car).drawModel(state.dh.model, null);  // 每幀必畫
}
function dispose(ctx, state, vehicle) {
    state.dh.close();
}

• 諸槽位共享 texSize 一張巨紋理；texArea 指槽位所用之域（x, y, w, h）。
• pos 者，三維之陣列：每屏四角之坐標（左上 → 左下 → 右下 → 右上），其單位米（Blockbench 1/16 之單位，須除以 16）；原點在列車之中、地板之高；+X 左 / +Y 上 / +Z 後。
• offsets 複製同內容之屏（門上小屏連排，可省紋理）；graphicsFor(name) 取既自動平移之畫布，graphics() 取整張。
• 上傳置 RateLimit 之內，畫模型置其外——模型必逐幀納之。

繼之：晏陽增補 —— JS 與 C++ 相雜之條、開門方向之記、交通類型之細分，與直寫像素之上傳。