aboutsummaryrefslogtreecommitdiff
path: root/advtrains/api_doc.txt
diff options
context:
space:
mode:
authororwell96 <orwell@bleipb.de>2022-02-09 22:40:29 +0100
committerorwell96 <orwell@bleipb.de>2022-02-09 23:06:02 +0100
commit3cb21a80dc8219136136fb1df8afca154d58f58c (patch)
treee9a192b09406c7cfa8b13dedfbd3f8f7ed63732a /advtrains/api_doc.txt
parentef8391a60d8221f883d54c68373607d7bb3cf4c7 (diff)
downloadadvtrains-3cb21a80dc8219136136fb1df8afca154d58f58c.tar.gz
advtrains-3cb21a80dc8219136136fb1df8afca154d58f58c.tar.bz2
advtrains-3cb21a80dc8219136136fb1df8afca154d58f58c.zip
Wagons: Add two-pos wheel positioning logic for more realistic look of long wagons
Adds field "wheel_positions" in wagon definition
Diffstat (limited to 'advtrains/api_doc.txt')
-rw-r--r--advtrains/api_doc.txt7
1 files changed, 7 insertions, 0 deletions
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