====== Advanced Trains ======

Advanced Trains (technical name "advtrains") is a [[https://en.wikipedia.org/wiki/Mod_(video_gaming)|mod]] for the [[https://www.luanti.org/|Luanti engine]]. It features realistic trains and various equipment for railways, with a focus on automated train operation. It should work with any [[https://wiki.luanti.org/Games|game]], but Minetest Game is still the best experience.

===== Main features =====

  * A small selection of different trains (passenger and goods trains) (see the [[usage:trains:start|Train Catalogue]])
  * Almost-realistic tracks with actual curves and switches
  * Railway signals, controllable by various means
  * [[usage:nodes:atc_controller|ATC]]: simple, command-like automatic train control
  * [[usage:atlatc:start|LuaATC]]: powerful Lua-scripted automatic train operation (requires some programming knowledge)
  * An [[wp>Interlocking|Interlocking]] system, featuring track sections, routes and automatic stopping before signals

===== Repository =====

The source code for Advtrains is available on [[https://git.bananach.space/advtrains.git|Bananach.space]]. Latest version is 2.4.7.

The official mirror lives at [[https://notabug.org/advtrains/advtrains|NotABug]], along with an issue tracker, for those not inclined to use the mailing list (see below).

There is also an unofficial mirror at [[https://github.com/minetest-mirrors/advtrains|minetest-mirrors]] on GitHub. This may be more reliable than NotABug, but please do not post issues there.

Old versions prior to August 2018 are available on [[https://github.com/orwell96/advtrains|GitHub]]. **@gpcf** also [[https://git.gpcf.eu/advtrains.git|mirrored]] versions prior to February 2017.
===== Installation instructions =====

The easiest way to install advtrains is by using the Package Manager inside the Luanti main menu. [[https://content.luanti.org/packages/orwell/advtrains/|or here]]

You can also use [[https://git-scm.com|Git]] to install advtrains. Once you installed Git, clone the Advtrains repository with these commands:

<code>
cd MINETEST_ROOT/mods
git clone http://git.bananach.space/advtrains.git
</code>

Then enable Advtrains in the world settings. You can also enable each mod individually.

The git repository contains a directory called 'assets'. It contains the .blend and .xcf files for some of the assets. This directory is not required to run advtrains.

===== Get in touch =====

==== Forum page ====

Official announcements are done on the Luanti Forum topic, located at:

[[https://forum.luanti.org/viewtopic.php?f=11&t=14726]]

==== Mailing lists ====

The mailing lists serve as a hub for discussion about ideas, problems and development of advtrains. Please read [[https://man.sr.ht/lists.sr.ht/etiquette.md|Sourcehut's mailing list etiquette]] and [[https://useplaintext.email|useplaintext.email]] before posting.

  * Mailing list for general discussion: [[https://lists.sr.ht/~gpcf/advtrains-discuss|~gpcf/advtrains-discuss@lists.sr.ht]]
  * Mailing list for development discussion and submitting patches: [[https://lists.sr.ht/~gpcf/advtrains-devel|~gpcf/advtrains-devel@lists.sr.ht]]
  * Announcements: [[https://lists.sr.ht/~gpcf/advtrains-announce|~gpcf/advtrains-announce@lists.sr.ht]]

Older entries can be found on [[https://lists.sr.ht/~gpcf/advtrains|~gpcf/advtrains@lists.sr.ht]]. However, this mailing list should no longer be used.

==== NotABug & others ====

  * The Advtrains and Basic trains repos are mirrored [[https://notabug.org/advtrains|on NotABug]]. The bugtracker for Advtrains is also viewed by developers. The serialization library used by Advtrains can also be found there.
  * There is also a [[https://codeberg.org/advtrains_supplemental|"supplemental"]] collection of mods for Advtrains (also on [[https://content.luanti.org/users/advtrains_supplemental/|ContentDB]]). It was previously at [[https://notabug.org/advtrains_supplemental|NotABug]], where some mirrors are still present.
==== Contributing ====

You can contribute to advtrains in various ways:
  * Report bugs and problems or discuss with us on the mailing list [[~gpcf/advtrains-discuss@lists.sr.ht]]
  * Help with development by fixing a bug or implementing a feature and sending a patch to [[~gpcf/advtrains-devel@lists.sr.ht]]
  * Contribute to documentation on this wiki

Please note that the //old bug tracker (Hemiptera)// is retired due to various issues with it.

===== So, what's the purpose of this wiki? =====

This wiki supersede the information at [[https://advtrains.de/manual]] and [[https://advtrains.de/interlocking]]. Unlike these pages, you are [[wiki:contributing|free to improve the wiki contents]], as it is open wiki licensed under [[https://creativecommons.org/licenses/by-sa/4.0/|Creative Commons Attribution-ShareAlike 4.0 International]].

Documentation on this wiki has been contributed by many people, including Maxime Launois, Blockhead, and ywang. Thank you for your help!

===== Legal information =====
[[wiki:privacy]]