Differences

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

--- start [2019-12-18 11:47] – The latest version of Advtrains is 2.1.0, but the page shows 2.0.1 TSS mlaunois
+++ start [2025-06-14 23:31] (current) – [Repository] Remove reference to latest version since keeping it current here seems easy to overlook marnack
@@ Line 1: / Line 1: @@
 ====== Advanced Trains ======
-Advanced Trains, aka with its technical name "advtrains", is a [[https://en.wikipedia.org/wiki/Mod_(video_gaming)|mod]] for the [[https://www.minetest.net/|Minetest engine]]. It features realistic trains and various equipment for railways, with a focus on automated train operation. It should work with any [[https://wiki.minetest.net/Games|game]].
+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 also "Extensions")
+  * 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
-  * ATC: simple, command-like automatic train control
+  * [[usage:nodes:atc_controller|ATC]]: simple, command-like automatic train control
-  * LuaATC: powerful Lua-scripted automatic train operation (requires some programming knowledge)
+  * [[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.1.0.
+The source code for Advtrains is available on [[https://git.bananach.space/advtrains.git|Bananach.space]].
-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.
+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 =====
-To download Advtrains you will need [[https://git-scm.com|Git]]. See how to install [[https://git-scm.com/downloads|here]]. If you already installed it, clone the Advtrains repository with these commands:
+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>
@@ Line 29: / Line 34: @@
 Then enable Advtrains in the world settings. You can also enable each mod individually.
-===== Forum page =====
+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.
-Main source for download and install instructions, announcements and discussion is the Minetest Forum topic, located at:
+===== Get in touch =====
-[[https://forum.minetest.net/viewtopic.php?f=11&t=14726]]
+==== Forum page ====
-===== So, what's the purpose of this wiki? =====
+Official announcements are done on the Luanti Forum topic, located at:
-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]].
+[[https://forum.luanti.org/viewtopic.php?f=11&t=14726]]
-===== Contributing =====
+==== 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 on the [[https://bugs.linux-forks.de/advtrains/|Bug Tracker]]
+  * 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 orwell ät bleipb döt de
+  * 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
-Note: Registering on the wiki is currently disabled due to spam issues. Please write me an email (orwell ät bleipb döt de) or PM me on the forum if you want an account. I dont actually need your e-mail address if you dont want to share it with me.
+Please note that the //old bug tracker (Hemiptera)// is retired due to various issues with it.
-Note 2: When you open a [[https://bugs.linux-forks.de/advtrains/|Bug]], please note that I might not respond to this. This doesn't mean that I don't take the bug serious, it rather means that your bug report is certainly valid and correct. I try to fix the things you report, but currently my time to work on the project is limited. (if something's wrong, I will respond)
+===== 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]].
-===== Credit =====
+Documentation on this wiki has been contributed by many people, including Maxime Launois, Blockhead, and ywang. Thank you for your help!
-A big Thank You goes to Maxime Launois, who has contributed large parts of this wiki page.
-Dear Maxime, dear other contributors: I see that it is very hard to give credit to the wiki contents when there's only anonymous editing functionality. I'd like to enable the user system. To do this, I need to know who of you has contributed which parts of the wiki and a way to contact you. Please email me at orwell ät bleipb döt de.
+===== Legal information =====
--- orwell, 28.10.19
+[[wiki:privacy]]