Minecraft Transit Railway Wiki

User Tools

Site Tools

You are here: Minecraft Transit Railway » Minecraft Transit Railway » Getting Started
mtr:getting_started

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
mtr:getting_started [2023/10/19 09:02] – fewer markdowns, more internal links BDark000mtr:getting_started [2025/11/22 12:30] (current) – Fixed grammar, formatting, and the notes section botond
Line 1: Line 1:
 ====== Getting Started ====== ====== Getting Started ======
  
-The 3.0 release of _Minecraft Transit Railway_ has reimagined the concept of Minecraft train systems. Rather than using the traditional [[https://minecraft.gamepedia.com/Minecart|minecart]], a central dashboard system controls where trains are at all times. Lagging entities, inactive trains inside unloaded chunks, and overloaded servers are now problems of the past. +This tutorial will guide you through the basics of the Minecraft Transit Railway mod. **This tutorial is for MTR version 4.0.x. Any step of the tutorial may change when using an older or a newer version.** This mod is recommended to be used in creative mode, but survival mode is also supported with crafting recipes. We recommend a mod such as [[https://modrinth.com/mod/jei|Just Enough Items]] for a list of crafting recipes.
- +
-The [[/dashboards|dashboard]] items are the central parts of the mod. Stations, routes, and depots can be added, moved, and deleted. +
- +
-Trains are no longer entities or "retextured minecarts". Instead, they are part of the world data, with each train's position simulated on every server tick. This avoids a lot of unnecessary entity position, velocity, and collision calculations, and can move trains even outside of currently loaded chunks. This also means that train-spawning items no longer exist, as trains now run according to user-created schedules. As of version 3.0.0-beta-5 of the mod, trains no longer use vanilla Minecraft rails.+
  
 ===== Video Tutorials ===== ===== Video Tutorials =====
Line 11: Line 7:
 Please see [[https://www.youtube.com/playlist?list=PLp0jZgheSlXv_vjilwnbrOtdbmgvz1VkC|this playlist for video tutorials]]. Please see [[https://www.youtube.com/playlist?list=PLp0jZgheSlXv_vjilwnbrOtdbmgvz1VkC|this playlist for video tutorials]].
  
-===== Creating a Rail =====+===== Transport Modes =====
  
-These are the basic steps for creating rails. See the [[/rails|Rails]] page for more information. +MTR has four modes of transport: 
-  - Place down a rail node on the ground. + 
-  - Walk forward at least a few blocks and put down another rail node. +  * Trains 
-  - Obtain any rail connector item. Right click one of the rail nodes while holding the item. The rail connector should start flashing in the inventory. +  * Boats 
-  - Right click the other rail node while still holding the rail connector item. Railway tracks should appear between the two rail nodes.+  * Cable Cars 
 +  * Airplanes 
 + 
 +Each mode of transport works independently of the others and has its own dashboard and node system. Making buses is possible using hidden rails. **The tutorial on this page will only cover trains.** 
 + 
 +| {{ :mtr:railway_dashboard.png?100 }} | {{ :mtr:boat_dashboard.png?100 }} | {{ :mtr:cable_car_dashboard.png?100 }} | {{ :mtr:airplane_dashboard.png?100 }} | 
 +|  The four dashboards of Minecraft Transit Railway.  ||||
  
 ===== Building Your First Railway ===== ===== Building Your First Railway =====
 +
 +==== First steps ====
 +
 +The four main components of the railway are the following:
 +
 +  * Rails
 +  * Stations
 +  * Routes
 +  * Depots
 +
 +The most important items are the **railway dashboard**, the **rail node**, the **rail connector**s, and the **brush**.
 +
 +==== Rails ====
 +
 +<WRAP right>
 +
 +| {{ :mtr:rails.png?200 }} |
 +|  All rail connectors of the mod and the rail remover  |
 +
 +| {{ :mtr:rails_placed.png?245 }} |
 +|  Several rail connections with different rotations  |
 +
 +| {{ :mtr:rails_placed_hold.png?245 }} |
 +|  Rails when a rail-related item is in hand  |
 +
 +| {{ :mtr:rails_brush.png?245 }} |
 +| Viewing the properties of a rail with a brush |
 +
 +</WRAP>
 +
 +Rails specify the path your vehicles will take.
 +
 +To make a new rail, place two rail nodes and connect them using rail connectors. Rail nodes can also be rotated 90 degrees, 45 degrees or 22.5 degrees. While connecting the rails, you may see information about your rail, such as the XYZ offset, the horizontal radius and the total length. If you'd like to see this information after you connected your rails, point your crosshair to one of its rail nodes and look in the direction of the desired connection. Holding a rail related item, such as a brush, connector or node will show the type and arrows (if one-way) of every rail. To remove a rail connection, break one of the nodes or use the **rail remover** item. There are five types of rail connectors for trains, which are:
 +
 +  * Speed limit
 +  * Speed limit (one-way)
 +  * Platforms
 +  * Sidings
 +  * Turnbacks
 +
 +If you get an error such as "Could not connect rail; invalid orientation", check the rotation of your rails.
 +
 +The following rails will not work with the rail node, the reason is listed below.
 +
 +^ Name ^ Reason ^
 +| Cable Car Connector | To be used with Cable Car nodes |
 +| Runway Rail Connector | To be used with Airplane nodes |
  
 ==== Platforms ==== ==== Platforms ====
Line 25: Line 74:
 A platform is a section of track where trains can stop to pick up passengers. A platform is a section of track where trains can stop to pick up passengers.
  
-  - Create a platform rail by following the steps above (outlined in the [[/getting_started#creating_a_rail|Creating a Rail]] while using the platform rail connector item. This will be the first train platform. +  - Create a platform rail by following the steps [[mtr:getting_started#first_steps|above]] while using the platform rail connector item. 
-  - Go somewhere else and create another platform rail, not connected to the first one. Try to keep it about the same length as before. This will be the second train platform. +  - Go to your next station and place another platform rail, not connected to the first one. It is recommended to keep it about the same length as before. This will be the second train platform. 
-  - Connect the two train platforms together using any of the other rail connector items (not the platform or siding rail connector items). Use more rail nodes if necessary. +  - Connect the two train platforms together using any of the other speed rail connector items. Use more rail nodes if necessary. 
-<markdown> +  - Use the dashboard to configure the dwell time and the platform number. 
-> <img alt="Building the Platform" src="https://github.com/jonafanho/Minecraft-Transit-Railway/blob/master/images/getting-started/build-platform.png" width=512/><br>An example of two platform rails connected by another rail +
-</markdown>+
 ==== Stations ==== ==== Stations ====
  
-A station is a rectangular area marked in the world. Each station should completely cover one or more platforms.+<WRAP right>
  
-  - Obtain the [[/dashboard|railway dashboard]] item and right click to open it.+| {{ https://raw.githubusercontent.com/Minecraft-Transit-Railway/Minecraft-Transit-Railway/refs/heads/master/images/getting-started/create-station.png?245 }} | 
 +| Two example stations, Northgate and East Green \\ Lake, have been created in the railway dashboard. | 
 + 
 +</WRAP> 
 + 
 +A station is a rectangular area marked in the world. Each station should completely cover one or more platforms and each platform should be covered by a station. 
 + 
 +  - Open the [[mtr:dashboards|railway dashboard]] item
   - The menu on the left has three tabs: ''Stations'', ''Routes'', and ''Depots''.   - The menu on the left has three tabs: ''Stations'', ''Routes'', and ''Depots''.
     * The ''Stations'' tab is selected by default.     * The ''Stations'' tab is selected by default.
     * The map on the right shows the current world.     * The map on the right shows the current world.
     * The blue dot with a white outline marks the current player location.     * The blue dot with a white outline marks the current player location.
-    * Platforms are bright white on the map.+    * Platforms are bright white on the map. If you zoom in, you may see the number.
     * Click and drag on the map to move it.     * Click and drag on the map to move it.
     * Use the mouse scroll wheel or the ''+'' or ''-'' buttons on the bottom right to zoom.     * Use the mouse scroll wheel or the ''+'' or ''-'' buttons on the bottom right to zoom.
Line 52: Line 107:
   - Click on the ''Add Station'' button again. Draw another rectangular station area, covering the second platform. Type in a name for the second station.   - Click on the ''Add Station'' button again. Draw another rectangular station area, covering the second platform. Type in a name for the second station.
   - Click ''Done'' when finished.   - Click ''Done'' when finished.
-<markdown> 
-> <img alt="Create Station" src="https://github.com/jonafanho/Minecraft-Transit-Railway/blob/master/images/getting-started/create-station.png" width=512/><br>Two example stations, Northgate and East Green Lake, have been created in the railway dashboard. 
  
 The two stations should now be visible on the map. The two stations should now be visible on the map.
  
-## Routes+==== Routes ====
  
-A route is simply a list of platforms (not stations). Trains assigned to a route will attempt to find a path to visit all the platforms. At the end of the route, the trains will be removed.+<WRAP right>
  
-1. Inside the railway dashboard, click on the `Routes` tab. +| {{ https://raw.githubusercontent.com/Minecraft-Transit-Railway/Minecraft-Transit-Railway/refs/heads/master/images/getting-started/create-route.png?245 }} | 
-1. Click on the button at the bottom called `Add Route`. +| A route serving the two platforms has been created. |
-1. The map is now in edit mode. Click on the first platform (in white) on the map. It should show up under the `Routes` tab on the left. +
-1. Click on the second platform on the map. There should now be two entries under the `Routes` tab on the left. +
-1. Type in a name for the new route. Use the `|` character to separate different languages, for example `馬鞍山綫|Ma On Shan Line`. +
-1. Click `Done` when finished.+
  
-> <img alt="Create Route" src="https://github.com/jonafanho/Minecraft-Transit-Railway/blob/master/images/getting-started/create-route.png" width=512/><br>A route serving the two platforms has been created.+</WRAP>
  
-The route is now complete! Hit `Esc` on the keyboard to exit out of the railway dashboard.+A route is simply a list of platforms (it will display the stations the platforms are at, if the platform is not inside a station area then it will appear blank). Depots assigned to a route will first attempt to find a path between each siding and the first platform selected and then to all the platforms. At the end of the route, the trains must find their way back to the depot.
  
-## Depots and Sidings+  - Inside the railway dashboard, click on the ''Routes'' tab. 
 +  - Click on the button at the bottom called ''Add Route''. 
 +  - The map is now in edit mode. Click on the first platform (in white) on the map. It should show up under the ''Routes'' tab on the left. 
 +  - Click on the second platform on the map. There should now be two entries under the ''Routes'' tab on the left. 
 +  - Type in a name for the new route. Use the ''|'' character to separate different languages, for example ''馬鞍山綫|Ma On Shan Line''. 
 +  - Click `Done` when finished. 
 + 
 +The route is now complete! Hit ''Esc'' on the keyboard to exit out of the railway dashboard. 
 + 
 +==== Depots and Sidings ====
  
 A siding is a section of track where trains can spawn from, and a depot provides instructions for where trains should go. A siding is a section of track where trains can spawn from, and a depot provides instructions for where trains should go.
  
-1. Create a siding rail by following the steps above (outlined in the [Creating a Rail](#creating-a-rail) section) while using the siding rail connector item. +  - Create a siding rail by following the steps above (outlined in the [[#rails|Creating a Rail]] section) while using the siding rail connector item. 
-1. Using any of the other rail connector items (not the platform or siding rail connector items), connect the siding to the first platform of the route. +  - Using any of the other rail connector items (not the platform or siding rail connector items), connect the siding to the first platform of the route. 
-1. Connect the siding again to the last platform of the route. +  - Connect the siding again to the last platform of the route. 
-1. Obtain the [railway dashboard](https://github.com/jonafanho/Minecraft-Transit-Railway/wiki/Dashboards) item and right click to open it. +  - Obtain the [[mtr:dashboards|Railway Dashboard]] item and right click to open it. 
-1. On the `Depots` tab, click on the button at the bottom called `Add Depot`. +  - On the `Depots` tab, click on the button at the bottom called ''Add Depot''. 
-1. Draw a depot area over the siding and type a name into the text box. This process will be very similar to how the stations were created.+  - Draw a depot area over the siding and type a name into the text box. This process will be very similar to how the stations were created. 
 +  - Click the pencil icon and select your routes in the desired order. 
 + 
 +==== Selecting a train ==== 
 + 
 +<WRAP right> 
 + 
 +| {{ :mtr:trainselection.png?245 }} | 
 +| Selecting a train for a siding | 
 + 
 +</WRAP> 
 + 
 +  - Inside the railway dashboard, make sure the ''Depots'' tab is selected. 
 +  - Click on the siding (in white) on the map. 
 +  - Click on the ''Edit'' button. This will change the train type that will spawn. 
 +  - Select the desired train: 
 +    * First, add the ''Cab'' car type, specifically the ''Forwards'' one. 
 +    * Add the desired amount of trailers, the ''Duplicate Cars'' button may help. 
 +    * The last car should be the ''Backwards'' cab type. 
 +    * If you see a ''⚠'' icon, then your siding isn't long enough to fit that specific type of car. To fix that, simply make your siding longer. Resize your depot if necessary 
 + 
 +  - Press the ''Done'' button and configure the number of trains, acceleration, deceleration, speed increases when delayed and if the train on the siding should be drivable. 
 +  - Press the ''Esc'' button on the keyboard to return to the main dashboard screen. 
 + 
 +==== Schedules ==== 
 + 
 +The depot must be given a schedule and instructions in order for [[mtr:trains|trains]] to move along the predefined route. There are two types of schedules: Minecraft Time and Real Time. 
 + 
 +=== Minecraft Time === 
 + 
 +Hours listed on this type of schedule are based on the [[https://minecraft.wiki/w/Daylight_cycle|game time]], not real life time. 
 + 
 +  - Hover over the desired depot and click on the pencil icon. The schedule configuration screen should appear. 
 +  - Drag all the sliders to the desired position. For example, if you drag all sliders to the very right, that will mean that trains will spawn every twenty seconds in real life. 
 +    * You can hold ''Left Shift'' and drag to set ALL sliders to your desired position. 
 +  - Hit ''Esc'' on the keyboard to exit out of the menu, and again to exit out of the dashboard. 
 + 
 +Your train should start spawning every twenty (real life) seconds. 
 + 
 +| {{ :mtr:minecrafttime.png?245 }} | 
 +| Example of a depot with Minecraft time schedules | 
 + 
 +=== Real Time === 
 + 
 +  - To get started with real time scheduling, click the "Minecraft Time" button on the top left to turn your depot into real time mode. 
 +  - There is a text input at the bottom. Enter a time, such as `17:00:00`. Now your train will spawn every day at 5 pm in your time zone. 
 +  - If you'd like more trains, enter more times. 
 +  - You can automate this process by multiplying the times. If you'd like your trains to run at a specific frequency all day, enter `00:00:00+[desired time in minutes divided by 1440]*[desired time in hh:mm:ss format] For example, if you enter ''00:00:00+1440*00:01:00'', your trains will spawn every minute. Here are more examples: 
 +    * If you enter ''00:00:00+720*00:02:00'', your trains will spawn every 2 minutes 
 +    * If you enter ''00:00:00+480*00:03:00'', your trains will spawn every 3 minutes 
 +    * If you enter ''00:00:00+288*00:02:00'', your trains will spawn every 5 minutes 
 +    * If you enter ''00:00:00+144*00:02:00'', your trains will spawn every 10 minutes 
 +  - If you'd like to search for a specific time, use the search bar on the top right. 
 +  - If you'd like to delete all departures, click the reset button above the search bar 
 + 
 +| {{ :mtr:realtime.png?245 }} | 
 +| Example of a depot with real time schedules | 
 + 
 +==== Platform Blocks ==== 
 + 
 +//Not to be confused with platform **__rails__**// 
 + 
 +[[mtr:platform_block|Platform blocks]] are required for trains to open their doors and pick up passengers. Place down a row of platform blocks by each platform rail. Each door needs a platform block in front or else it will not open. 
 + 
 +| {{ :mtr:platformrail.png?400 }} | 
 +| Platform blocks next to a platform rail |
  
-## Schedules+==== Refreshing the path ====
  
-The depot must be given a schedule and instructions in order for [trains](https://github.com/jonafanho/Minecraft-Transit-Railway/wiki/Trains) to move along the predefined route. Hours listed on the schedule are based on the [game time](https://minecraft.gamepedia.com/Daylight_cycle), not real life time.+  - After you set up everything for your line, go back to your depot menu and click ''Refresh Path'' 
 +  - If you encounter errors, check the following: 
 +    * Missing rail connectors in the displayed section 
 +    * Misplaced one-way connectors in the displayed section 
 +    * Wrongly ordered platforms in the route 
 +    * Wrongly ordered routes in the depot instructions 
 +  - If there are no errors, trains will be deployed from your depot according to your schedule 
 +  - If you would not like to wait for the trains to go through your line, you may use the ''Instant Deploy'' button. 
 +  - If you would like to clear all your trains, click the ''Clear Vehicles'' button
  
-1. Inside the railway dashboard, make sure the `Depots` tab is selected. +Board your train using one of the doors. Enjoy the ride; your first railway is complete!
-1. Click on the siding (in white) on the map. +
-1. Click on the `SP 1900` button. This will change the train type that will spawn. +
-1. Select `Minecart` and click on the `+` button. +
-1. Hit `Esc` on the keyboard to return to the main dashboard screen. +
-1. Hover over the newly created depot and click on the pencil icon. The schedule configuration screen should appear. +
-1. Drag all the sliders to the very right. This means that trains will spawn every twenty seconds in real life. +
-1. Click on `Edit Train Instructions` and hover over the route that was just created. Click on the `+` button to add it to the train instructions. +
-1. Click on `Refresh Path`. This button must be clicked every time the train instructions or rails have been modified. +
-1. Hit `Esc` on the keyboard to exit out of the menu, and again to exit out of the dashboard.+
  
-A train made up of minecarts should start spawning every twenty (real life) seconds.+| {{ :mtr:door_open.png?400 }} | 
 +| A door opening in an MPL 16 train. Players may now enjoy the ride! |
  
-## Platform Blocks+==== Transport System Map ====
  
-[Platform blocks](https://github.com/jonafanho/Minecraft-Transit-Railway/wiki/Platform-Block) are required to pick up passengers. Place down a row of platform blocks by each platform rail.+To open the transport system map, go to your dashboard and click the ''Transport System Map'' button. Your system map will open in your default browser. Only routes going to at least 2 stations will show on the system map.
  
-> <img alt="Platform Blocks" src="https://github.com/jonafanho/Minecraft-Transit-Railway/blob/master/images/getting-started/platform-next-to-rail.png" width=512/><br>Platform blocks should be placed by the platform rail.+==== Notes ====
  
-Walk onto any of the minecarts to hop in. Enjoy the ride; your first railway is complete!+  * Each route must have at least two platforms, or else no trains will spawn.  
 +  * More than one route may be added to the train instructions. 
 +    * The siding must be connected (with rails) to the //first// platform of the //first// route and the //last// platform of the //last// route. 
 +    * The ''Refresh Path'' button must be clicked every time the train instructions or rails have been modified. 
 +  * The length of the trains you may be able to spawn is limited by the length of the siding. 
 +  * See the [[mtr:trains|trains]], the [[mtr:dashboards|Railway Dashboard]] page, or the train selection menu inside the railway dashboard itself for the length of each train. 
 +  * Visit the [[https://addons.minecrafttransitrailway.com/|community content database]] for community made trains and other resources!
  
-> <img alt="Enjoy Ride" src="https://github.com/jonafanho/Minecraft-Transit-Railway/blob/master/images/getting-started/enjoy-ride.png" width=512/><br>A player is enjoying the train ride.+==== Still need help? ====
  
-## Notes+Join our [[https://discord.com/invite/PVZ2nfUaTW|Discord]] !
  
-* Each route must have at least two platforms, or else no trains will spawn. 
-* More than one route may be added to the train instructions. 
-   * The siding must be connected (with rails) to the _first_ platform of the _first_ route and the _last_ platform of the _last_ route. 
-   * The `Refresh Path` button must be clicked every time the train instructions or rails have been modified. 
-* [Trains](https://github.com/jonafanho/Minecraft-Transit-Railway/wiki/Trains) will momentarily stop at each platform. This is normal. 
-* The train with minecarts is not actually made up of real minecarts from the vanilla Minecraft game. In fact, placing in a vanilla minecart manually on the rails won't interact with the routes or schedules at all. 
-* The length of the train that will spawn is limited by the length of the siding. 
-   * If the platform is too short to spawn even one carriage, no trains will appear! 
-   * See the [Trains](https://github.com/jonafanho/Minecraft-Transit-Railway/wiki/Trains) page for the length of each train. 
  
-</markdown> 
mtr/getting_started.1697706126.txt.gz · Last modified: 2023/10/19 09:02 by BDark000