Differences

This shows you the differences between two versions of the page.

--- usage:tools:start [2021-01-19 08:35]
blockhead [Interlocking Tool] correct link for interlocking system
+++ usage:tools:start [2023-12-12 02:39] (current)
blockhead [Train copy/paste tool] doesn't do inventories
@@ Line 1: / Line 1: @@
-===== Tools ======
+======= Tools =======
+There are 4 main tools included with Advtrains, the 3 "sonic screwdrivers" and the [[#train_copy_paste_tool|train copy/paste tool]]. Other mods may include further tools, such as Livery Tools and DlxTrains.
+====== The sonic screwdrivers ======
 These 3 tools are used for special purposes such as laying track, setting up components for atlatc and inspecting locks for the interlocking system. There are no crafting recipes for any of these tools, and you will need the right privileges to use any of them except the trackworker.
+Blockhead likes to call them names according to their colours, so: blue screwdriver, red screwdriver & green screwdriver. You know you've used a lot of Advtrains if you've used all 3 screwdrivers!
 ===== Trackworker =====
-[[usage:tools:trackworker|{{:usage:tools:trackworker128.png?nolink&64|}}]]
+{{:usage:tools:trackworker128.png?nolink&64|}}
-The trackworker rotates track and changes its type. To use, look at the rail you want to change and click on it.
+The trackworker rotates track and changes its type. To use, look at the track you want to change and click on it.
-  * Left-click to change the rail type between straight, curved, switch (left) and switch (right).
+  * Left-click to change the track type between straight, curved, turnout (left) and turnout (right).
-  * Right-click to rotate in 30 degree increments.
+    * For diamond crossings, changing the track type with left-click will change the angles of the intersecting tracks instead.
-  * Holding the "Use" key while right-clicking rotates by 180°
+    * Not all nodes have different type options, so left-click will do nothing.
-  * You cannot make most rail types into curves or switches except the basic straight rails. For exampe, the [[usage:nodes:atc_rail|ATC Rails]] can only be straight.
+  * Right-click to rotate in 30 degree increments. You can rotate more than just track with the usual 30° increments, for instance most of the signals are rotatable. In fact, rotation them with the screwdriver will often not work and the signals will revert when the area is left and returned to later.
+  * Holding the "Aux1" (default: E) key while right-clicking rotates by 180°
+  * You cannot make most track types into curves or turnouts except the basic straight tracks. For example, the [[usage:nodes:atc_rail]] can only be straight.
-While the trackworker is useful for rotating rails after they have been placed, don't forget that when laying tracks by hand you can still make curves by placing the rails at an angle. See the [[usage:howto#getting_started|tutorial]].
+While the trackworker is useful for rotating tracks after they have been placed, don't forget that when laying tracks by hand you can still make curves by placing the tracks at an angle. See the [[usage:howto#getting_started|tutorial]].
-The trackworker tool is also used to rotate other nodes that use the 30° increments, such as most of the signals.
+The trackworker is not useful outside of the Advtrains mod as a general purpose rotation tool like the screwdriver.
 ===== Passive Component Naming Tool =====
-[[usage:tools:pcnamer|{{:usage:tools:pcnamingtool128.png?nolink&64|}}]]
+{{:usage:tools:pcnamingtool128.png?nolink&64|}}
-This tool is used to help set nice names for passive components for the [[usage:nodes:atc_rail|LuaAutomation system]]. To use it, right-click on any passive component, and a box will appear in which you can enter a name for that passive component. Once you have set that name, you can then reference that position from Lua code as a string.
+This tool is used to help set nice names for passive //and active// components for the [[usage:atlatc:start|LuaAutomation system]]. You can name signals, turnouts, operation panels, LuaATC mesecon controllers and possibly more.
+To use it, right-click on any passive component, and a box will appear in which you can enter a name for that passive component. If the component has its own GUI, then hold sneak while clicking to get the component naming GUI instead. Once you have set the name on a component, you can then reference that position from Lua code as a string.
 You will need the ''atlatc'' privilege to use this tool, and you cannot use it on protected areas you do not own.
@@ Line 26: / Line 35: @@
 ===== Interlocking Tool ====
-[[usage:tools:interlocking|{{:usage:tools:interlockingtool128.png?nolink&64|}}]]
+{{:usage:tools:interlockingtool128.png?nolink&64|}}
-This tool is used to help inspect and manually place locks for the [[usage:interlocking:start]] system. To use it, right-click on switches or signals. It will open a formspec that tells you whether there is a lock applied to that component and where that lock came from.
+This tool is used to help inspect and manually place locks for the [[usage:interlocking:start]]. To use it, right-click on turnouts or signals. It will open a formspec that tells you whether there is a lock applied to that component and where that lock came from.
 If there is no lock currently applied, you can manually place one, and it will persist until it is manually removed. If a lock is applied, you can remove it. Removing a lock that was automatically placed is useful in case a route is removed but still set, but in general it is not recommended
-This tool can help in situations where you do not know why you cannot move a switch, or where you want to place a manual lock to prevent switches from operating.
+This tool can help in situations where you do not know why you cannot move a turnout, or where you want to place a manual lock to prevent turnouts from operating.
 You will need the ''interlocking'' privilege to use this tool.
@@ Line 38: / Line 47: @@
 {{:usage:tools:interlocker-formspec-routeset.jpg}}
+====== Train copy/paste tool ======
+{{:usage:tools:copytool128.png?nolink&64|}}
+The train copy/paste tool is a tool for copying and pasting entire trains at once. It can help speed up deployment of multiple trains.
+Left-clicking on a train with the tool in hand will copy the train to the clipboard. It copes the line number, routing code, inside text and outside text (the [[usage:using_stock:train_fields]]). It copies the kinds of wagons in the train and whether they are flipped around. It puts this information into the metadata of the tool itself. You can hold multiple clipboards and even rename them with something like the  [[https://forum.minetest.net/viewtopic.php?t=17482|engraving table mod]] to help keep track. The tool will not copy inventories.
+Right-clicking will paste the train on the track, with the front wagon where you click and the rest of the train proceeding backwards. You need enough track to place the train, or it will give you an error message.
+Pasting will try to place the train facing the same way as you, just like when you place individual wagons. This can involve flipping wagons around to face the right way. An algorithm is used to determine what kind of train is being dealt with and how to place it 'forward':
+  * **Multi-unit or push-pull train**: There are wagons with motive power (is_locomotive=1) on both ends of the train, ergo locomotives or multiple unit wagons. The train will never be flipped, as it has no specific "front" and "back".
+  * **Locomotive-hauled train**: There is only one end with a locomotive. The train will be flipped so that the locomotive is always at the front. If the locomotive points long hood forward, it will still point long hood forward.
+  * **Rake of wagons**: There is no locomotive on either end of the train. The train will be flipped according to to which end of the train the player copies from. If the player is towards the back (wagon out of train divided by total wagons > 0.5), then the back becomes the new front. If the player is towards the front, no change.

Advanced Trains

User Tools

Site Tools

Differences

Page Tools