Differences

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

--- start [2019-02-21 10:27]
141.30.224.17 created
+++ start [2022-08-14 21:39]
ywang mention NotABug
@@ Line 1: / Line 1: @@
 ====== Advanced Trains ======
-Advanced Trains, 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.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]].
-==== Main features ====
+===== 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 [[https://en.wikipedia.org/wiki/Interlocking|Interlocking]] system, featuring track sections, routes and automatic stopping before signals
+  * 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.1.
+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 Minetest main menu. [[https://content.minetest.net/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 ====
-Main source for download and install instructions, announcements and discussion is the Minetest Forum topic, located at:
+Official announcements are done on the Minetest Forum topic, located at:
 [[https://forum.minetest.net/viewtopic.php?f=11&t=14726]]
-==== Contents of this Wiki ====
+==== Mailing lists ====
+The mailing lists serve as a hub for discussion about ideas, problems and development of advtrains.
+  * Mailing list for general discussion: https://lists.sr.ht/~gpcf/advtrains-discuss
+  * Mailing list for development discussion and submitting patches: https://lists.sr.ht/~gpcf/advtrains-devel
+==== NotABug ====
+  * 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 [[https://notabug.org/advtrains_supplemental|a collection of mods for Advtrains]]. Please note that some repos hosted there are mirrored - please report issues on the original repository for these mods.
+==== 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 will supersede the instruction documents currently located at [[https://advtrains.de/manual]] and [[https://advtrains.de/interlocking]] and become a place to collect information and useful tips for using things in this mod.
+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]].
-This is an open wiki, which means that you are allowed and explicitly invited to contribute to this wiki.
+Documentation on this wiki has been contributed by many people, including Maxime Launois, Blockhead, ywang, and 56independent. Thank you for your help!

Advanced Trains

User Tools

Site Tools

Differences

Page Tools