Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions projects/VFBuilders/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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),
Expand Down
5 changes: 5 additions & 0 deletions projects/VehicleFramework/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:<player> 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_<uuid>` 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)

Expand Down