From 3cb21a80dc8219136136fb1df8afca154d58f58c Mon Sep 17 00:00:00 2001 From: orwell96 Date: Wed, 9 Feb 2022 22:40:29 +0100 Subject: Wagons: Add two-pos wheel positioning logic for more realistic look of long wagons Adds field "wheel_positions" in wagon definition --- advtrains/api_doc.txt | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'advtrains/api_doc.txt') diff --git a/advtrains/api_doc.txt b/advtrains/api_doc.txt index 1e49df3..5668ba3 100644 --- a/advtrains/api_doc.txt +++ b/advtrains/api_doc.txt @@ -85,6 +85,13 @@ advtrains.register_wagon(name, prototype, description, inventory_image) wagon_span=2, ^- How far this wagon extends from its base position. Is the half of the wagon length. ^- Used to determine in which distance the other wagons have to be positioned. Will require tweaking. + wheel_positions = {1.5, -1.5}, + ^- Optional: if defined, the wagon will be placed so that these 2 wheel positions are on the track + ^- This parameter is recommended for long wagons (wagon_span >= 2). + ^- The position is a distance relative to the center of the wagon. + ^- Must have exactly 2 entries, corresponding to the front (1) and rear (2) wheel of the wagon object. 1st must be greater than 2nd. + ^- If not provided, the simple 1-position positioning logic will be used (wagon is positioned with the center on the track) + extent_h = 1, ^- Determines the collision box extent in x/z direction. Defaults to 1 (=3x3) ^- The actual bounding box size is (extent_h*2)+1, so 0 means 1x1, 1 means 3x3 and 2 means 5x5 -- cgit v1.2.3