Difference between revisions of "TrainCarts/en"

From BergerHealer Wiki
Jump to navigation Jump to search
(Updating to match new version of source page)
 
(Updating to match new version of source page)
 
(11 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
[[Special:MyLanguage/Main Page|« Go back]]
 
[[Special:MyLanguage/Main Page|« Go back]]
  
'''TrainCarts''' is a plugin developed by Bergerkiller and features everything related to Trains of [[Special:MyLanguage/minecart|minecart]]s. It was initially developed to link multiple carts together, creating a moving train. Over time the plugin grew to host many more features, such as action signs, commands, properties, attachments and a broad API other plugins can implement to add their own features.
+
'''TrainCarts''' is a plugin developed by Bergerkiller and features everything related to Trains of minecarts. It was initially developed to link multiple carts together, creating a moving train. Over time the plugin grew to host many more features, such as action signs, commands, properties, attachments and a broad API other plugins can implement to add their own features.
 
 
  
 
== Trains ==
 
== Trains ==
Line 12: Line 11:
 
The first thing you will notice is that you can now connect carts together to form infinitely long trains. Every cart in this train is called a ''member'', all members combined are called a ''group''. Every member communicates with the group, so when the front cart hits a block, it stops the entire group. When someone pushes a cart, this pushing force is shared among all members. Therefore, long trains are less responsive than short trains.
 
The first thing you will notice is that you can now connect carts together to form infinitely long trains. Every cart in this train is called a ''member'', all members combined are called a ''group''. Every member communicates with the group, so when the front cart hits a block, it stops the entire group. When someone pushes a cart, this pushing force is shared among all members. Therefore, long trains are less responsive than short trains.
  
 +
By default all minecarts placed by players become TrainCarts managed Minecarts. If you want to spawn Vanilla Minecarts that behave with original Minecraft Physics, you can do so through '''permissions''' or by spawning with a '''dispenser'''. [[TrainCarts/VanillaMinecarts|See this page for more information]].
 +
 +
Mobs no longer get into Traincarts Minecarts by default. If you want to change this, [[TrainCarts/MobEntering|see this page for more information]] or spawn vanilla minecarts instead.
 +
 +
== Spawning ==
 +
Trains can be spawned by players using Minecart items or the [[TrainCarts/Train Spawn Chest|Train Spawn chest]]. They can be spawned automatically using the [[TrainCarts/Signs/Spawner|spawn sign]].
 +
 +
[[Special:MyLanguage/TrainCarts/Spawning|» Spawning]]
 +
 +
[[Special:MyLanguage/TrainCarts/Train Spawn Chest|» Train Spawn Chest]]
 +
 +
== Properties ==
 +
Trains and individual carts of trains have properties. These can be set using commands (/train and /cart) or using the [[TrainCarts/Signs/Property|property sign]].
 +
 +
[[Special:MyLanguage/TrainCarts/Signs/Property|» Property Sign]]
  
 
== New physics ==
 
== New physics ==
Line 18: Line 32:
  
 
[[Special:MyLanguage/TrainCarts/Physical|» Physical]]
 
[[Special:MyLanguage/TrainCarts/Physical|» Physical]]
 
  
 
== Signs ==
 
== Signs ==
Line 25: Line 38:
  
 
[[Special:MyLanguage/TrainCarts/Signs|» Signs]]
 
[[Special:MyLanguage/TrainCarts/Signs|» Signs]]
 
  
 
== Command ==
 
== Command ==
Line 33: Line 45:
 
[[Special:MyLanguage/TrainCarts/Commands|» Commands]]
 
[[Special:MyLanguage/TrainCarts/Commands|» Commands]]
  
 +
== Command Selectors ==
 +
You can use command selectors like ''@train'' and ''@ptrain'' in all other commands (including non-traincarts commands) to perform actions on trains or player passengers of trains based on selector criteria. For tighter integration with other plugins like economies and status effects, this is the ideal mechanism.
  
== Train Spawn Chest ==
+
[[TrainCarts/Commands/SelectorsCommand Selectors]]
 
 
A special item allows for trains to be picked up and spawned.
 
 
 
[[Special:MyLanguage/TrainCarts/Train_Spawn_ChestTrain Spawn Chest]]
 
 
 
  
 
== Path finding ==
 
== Path finding ==
Line 47: Line 56:
 
[[Special:MyLanguage/TrainCarts/PathFinding|» Traincarts Path Finding]]
 
[[Special:MyLanguage/TrainCarts/PathFinding|» Traincarts Path Finding]]
  
 +
== Tickets ==
 +
 +
Train ticket items can be used to restrict who can enter trains. They can also be used to assign properties to trains when used, such as assigning a destination to go to.
 +
 +
[[Special:MyLanguage/TrainCarts/Tickets|» Traincarts Tickets]]
  
 
== Configuration ==
 
== Configuration ==
Line 53: Line 67:
  
 
[[Special:MyLanguage/TrainCarts/TrainProperties|» Train Properties]]
 
[[Special:MyLanguage/TrainCarts/TrainProperties|» Train Properties]]
 
  
 
==Attachments==
 
==Attachments==
  
[[Special:MyLanguage/TrainCarts/Attachments|» Attachments]] (WIP)
+
The attachment editor is used to configure the appearance of your train. The interactive menu enables players to configure customized trains using item models, entities, seats, sounds and more. All of these can be animated to bring the train alive.
  
 +
[[Special:MyLanguage/TrainCarts/Attachments|» Attachments]]
  
 
== Permissions ==
 
== Permissions ==
Line 66: Line 80:
 
[[Special:MyLanguage/TrainCarts/Permissions|» Overview of all permissions]]
 
[[Special:MyLanguage/TrainCarts/Permissions|» Overview of all permissions]]
  
 +
== Performance ==
 +
Some features by this plugin may result in server or client lag. There are ways to prevent them.
 +
 +
[[TrainCarts/Lag|» Lag]]
  
== Add-ons ==
+
== API and Add-ons ==
  
TrainCarts has a flexible API which allows other plugins to implement custom track, signs, attachments and more.
+
TrainCarts has a [[TrainCarts/API|flexible API]] which allows other plugins to implement custom track, signs, attachments and more.
 
* [[Special:MyLanguage/TC-Coasters|TC-Coasters]]: Adds smooth rollercoaster track to TrainCarts
 
* [[Special:MyLanguage/TC-Coasters|TC-Coasters]]: Adds smooth rollercoaster track to TrainCarts
 
+
* [https://www.spigotmc.org/resources/tc-hangrail.39627/ TC-Hangrail]: Hang below or float above any kind of block as fake track
 +
* [https://www.spigotmc.org/resources/traincartsdestinationselector.73170/ TrainCartsDestinationSelector]: Adds clickable signs so players can select train destinations
 +
* [https://www.spigotmc.org/resources/traincarts-advancedsigns.99881/ Traincarts AdvancedSigns]: Adds additional sign types, particularly useful for rollercoaster rides
 +
* [https://www.spigotmc.org/resources/tcminecartvariants.100658/ TC Minecart Variants]: Unique models for carts showing different types of resources (coal, gold, etc.)
 +
* [https://www.spigotmc.org/resources/tcanimatronics.101995/ TCAnimatronics]: Play [https://www.spigotmc.org/resources/animatronics-animate-armorstands-1-8-1-18-2.36518/ Animatronics] animations with a Traincarts sign
  
 
== Useful Links ==
 
== Useful Links ==
  
 
*[https://www.spigotmc.org/resources/traincarts.39592/ Spigot Dev Page & Forum]
 
*[https://www.spigotmc.org/resources/traincarts.39592/ Spigot Dev Page & Forum]
*[https://discord.gg/q9gutsN Discord]
+
*[https://discord.gg/wvU2rFgSnw Discord]
  
 
'''Traincarts'''
 
'''Traincarts'''
Line 92: Line 114:
 
[https://ci.mg-dev.eu/job/TC%20Coasters/ Jenkins]
 
[https://ci.mg-dev.eu/job/TC%20Coasters/ Jenkins]
 
[https://github.com/bergerhealer/TC-Coasters GitHub]
 
[https://github.com/bergerhealer/TC-Coasters GitHub]
 
  
 
== Depreciated Addons ==
 
== Depreciated Addons ==

Latest revision as of 16:10, 21 September 2024

Other languages:
Deutsch • ‎English • ‎Español • ‎Nederlands • ‎中文(中国大陆)‎ • ‎日本語 • ‎한국어
TrainCarts
TrainCarts train 1.gif
Minecarts redefined
Spigot: TrainCarts
GitHub: TrainCarts


« Go back

TrainCarts is a plugin developed by Bergerkiller and features everything related to Trains of minecarts. It was initially developed to link multiple carts together, creating a moving train. Over time the plugin grew to host many more features, such as action signs, commands, properties, attachments and a broad API other plugins can implement to add their own features.

Trains

The first thing you will notice is that you can now connect carts together to form infinitely long trains. Every cart in this train is called a member, all members combined are called a group. Every member communicates with the group, so when the front cart hits a block, it stops the entire group. When someone pushes a cart, this pushing force is shared among all members. Therefore, long trains are less responsive than short trains.

By default all minecarts placed by players become TrainCarts managed Minecarts. If you want to spawn Vanilla Minecarts that behave with original Minecraft Physics, you can do so through permissions or by spawning with a dispenser. See this page for more information.

Mobs no longer get into Traincarts Minecarts by default. If you want to change this, see this page for more information or spawn vanilla minecarts instead.

Spawning

Trains can be spawned by players using Minecart items or the Train Spawn chest. They can be spawned automatically using the spawn sign.

» Spawning

» Train Spawn Chest

Properties

Trains and individual carts of trains have properties. These can be set using commands (/train and /cart) or using the property sign.

» Property Sign

New physics

Trains can travel on top of pressure plates and alongside ladders, and also upside-down below vanilla rails placed on a ceiling.

» Physical

Signs

Loads of different signs are available to automate stations, eject trains, put players in trains or update train configuration.

» Signs

Command

The plugin has lots of commands you can use to alter the behavior of trains and minecarts.

» Commands

Command Selectors

You can use command selectors like @train and @ptrain in all other commands (including non-traincarts commands) to perform actions on trains or player passengers of trains based on selector criteria. For tighter integration with other plugins like economies and status effects, this is the ideal mechanism.

» Command Selectors

Path finding

Trains can have a destination set, after which switcher signs will automatically switch the track to lead the train towards it with the shortest route possible. This can be used to automate a large train network, sending trains to different stations fully automatically. It is also possible to configure a list of destinations the train should visit and have the train automatically go from one destination to the next.

» Traincarts Path Finding

Tickets

Train ticket items can be used to restrict who can enter trains. They can also be used to assign properties to trains when used, such as assigning a destination to go to.

» Traincarts Tickets

Configuration

TrainCarts can be configured in the config.yml file. All setting nodes have a header to help you understand what that particular node adjusts. Other than that, you can set the default train properties (properties applied to new trains) in the DefaultTrainProperties.yml file. The nodes should speak for themselves. Try not to touch the other files, as it can cause corrupted save data, or the plugin getting out of sync. Deleting the files should re-set TrainCarts completely, may one of the files get corrupted. The plugin automatically generates all configuration needed.

» Train Properties

Attachments

The attachment editor is used to configure the appearance of your train. The interactive menu enables players to configure customized trains using item models, entities, seats, sounds and more. All of these can be animated to bring the train alive.

» Attachments

Permissions

Like in all plugins that use BKCommonLib as a base, all permissions can be found in PermissionDefaults.yml in the plugin folder. There they are all listed together with a description and permission default, which you can alter as well.

» Overview of all permissions

Performance

Some features by this plugin may result in server or client lag. There are ways to prevent them.

» Lag

API and Add-ons

TrainCarts has a flexible API which allows other plugins to implement custom track, signs, attachments and more.

Useful Links

Traincarts Spigot Jenkins GitHub

BKCommonLib Spigot Jenkins GitHub

TC Coasters Spigot Jenkins GitHub

Depreciated Addons

(No longer supported in current versions of Traincarts)

ActionBlocks, added block-based systems to the game. They were dumbed-down versions of the sign systems mentioned above.

TrainCartsBlocks GitHub Download Page