From 791de2aef53dd829a4634e7e4f288d135900dab9 Mon Sep 17 00:00:00 2001 From: XxFran10xX <318299142+XxFran10xX@users.noreply.github.com> Date: Wed, 11 Nov 2026 20:00:19 +0100 Subject: [PATCH] docs: VehicleFramework idle cleanup (2.19.0), VFBuilders kept stations (2.2.4) Co-Authored-By: Claude Opus 5.5 --- projects/VFBuilders/README.md | 9 +++++++++ projects/VehicleFramework/overview.md | 5 +++++ 2 files changed, 14 insertions(+) diff --git a/projects/VFBuilders/README.md b/projects/VFBuilders/README.md index 5974039..2e2aa1d 100644 --- a/projects/VFBuilders/README.md +++ b/projects/VFBuilders/README.md @@ -85,6 +85,15 @@ does not reconstruct jobs that were never saved. Inventory, registration fees and the station file are separate stores, so a process failure during their handoff can still require staff reconciliation. +Since 2.2.4, a saved station whose world is not loaded on this server (or whose +building site's world is not) is kept as the JSON object read from the file: +written back unchanged with every save (fields this version does not know are +kept), turned back into a station when a `WorldLoadEvent` makes its worlds +available, and its block cannot become a new empty station meanwhile. Loading +logs one warning naming the worlds. Before 2.2.4 such a station (for example +from a stations file copied from another server) made every save fail, which +cancelled every construction start. + ### API for other plugins [`BeginVehicleConstructionEvent`](https://github.com/TF-Minecraft/VFBuilders/blob/main/src/main/java/net/tfminecraft/vfbuilders/events/BeginVehicleConstructionEvent.java), diff --git a/projects/VehicleFramework/overview.md b/projects/VehicleFramework/overview.md index 93b4078..e7da10b 100644 --- a/projects/VehicleFramework/overview.md +++ b/projects/VehicleFramework/overview.md @@ -355,6 +355,11 @@ Spline tracks persist samples and segment health separately from displays. Consi - `ground-engine-logging` (default `true`) - When true, appends each terrain-follow step (`state=` plus dest/vel, `lookaheadY`, `effSnap`, `air`, airborne `vx`, and geared-engine `gear`/`thr` when present) and each state swap (`state=A->B reason=... isDefault=...`) to `plugins/VehicleFramework/logs/ground_engine.log`. - `storage-logging` (default `true`, 2.18.0+) - Logs every item a player puts into or takes out of vehicle storage to `plugins/VehicleFramework/logs/storage.log` (`OPEN`, `PUT`, `TOOK` lines with player, amount, item, storage, vehicle and place, written off the server thread). With CoreProtect it also adds a chat line under the player's name, `[VF storage] took 12 iron_ingot from ...`, found with `/co lookup u: a:chat`. Dock trades and fuel drawn by a locomotive are not blamed on anyone. - `wipe-log` (default `true`) - When true, deletes `ground_engine.log` and `track.log` on plugin start and `/vf reload`. +- `cleanup` (2.19.0+, off by default) - Idle vehicle cleanup for a world where vehicles are only for trying out (TFMC sets it on the Tutorial server only). + - Keys: `worlds` (world names; empty means off), `keep-owners` (stored owner values such as `char_` that are never removed) and `idle-minutes` (default `30`, at least 1). + - Every minute, a loaded vehicle on a cleanup world that has had no passenger and has not moved more than a block for `idle-minutes` is removed like `/vf kill`: removed and tombstoned, with a `Cleanup removed ...` info line. + - The clock starts when the cleanup first sees the vehicle loaded. Mounting, dismounting and seat changes restart it at once; moving between checks also counts as use, so pulled train cars, horse carts and towed vehicles stay. + - A vehicle that unloads and loads again starts a fresh clock, so vehicles left in chunks nobody visits stay stored. ### Weapon aim mode (optional)