classic coaches mod for advtrains

Marnack e603dc6ba1 Minor code cleanup 6 months ago
locale 94356962ee Use current Minetest internationalization system 6 months ago
models f2d855e2e7 Initial version 1 year ago
textures e794456b24 Add support for AdvTrains Livery Tools 1 year ago
.gitattributes f2d855e2e7 Initial version 1 year ago
LICENSE.txt f2d855e2e7 Initial version 1 year ago
README.md e794456b24 Add support for AdvTrains Livery Tools 1 year ago
init.lua e603dc6ba1 Minor code cleanup 6 months ago
mod.conf 94356962ee Use current Minetest internationalization system 6 months ago
screenshot.png f2d855e2e7 Initial version 1 year ago

README.md

Classic Coaches

This mod is an extension for Advanced Trains that adds a set of four intercity style passenger wagons, all of which have liveries that can be customized in-game by their owning players.

Wagons

All of the wagons in this mod are loosely based on passenger coaches used for European inter city railway service during the late 20th and early 21st centuries.

Corridor Coach Class 1

This wagon features modern compartment style seating with corridor access to adjoining wagons. Each compartment contains six extra wide first class airline style seats with a folding center table and stylish overhead shelving.

The wagon is modeled with 24 seats. Up to 4 players can board each wagon.

Corridor Coach Class 2

This wagon also features modern compartment style seating with corridor access to adjoining wagons. Each compartment contains six standard second class airline style seats with a folding center table, two small side tables and standard overhead shelving.

The wagon is modeled with 24 seats. Up to 4 players can board each wagon.

Open Coach Class 1

This wagon features modern open plan style seating with vestibule access to adjoining wagons. Each row contains three extra wide first class airline style seats. Stylish overhead shelving is located along both sides of the wagon.

The wagon is modeled with 18 seats. Up to 3 players can board each wagon.

Open Coach Class 2

This wagon also features modern open plan style seating with vestibule access to adjoining wagons. Each row contains four standard second class airline style seats. Standard overhead shelving is located along both sides of the wagon.

The wagon is modeled with 32 seats. Up to 5 players can board each wagon.

Livery Customization

Like some other mods for Advanced Trains, this mod supports using the bike painter tool from the bike mod to allow players to paint a portion of their wagon a custom color. In addition to supporting that tool, however, this mod also introduces support for the livery designer tool included in the AdvTrains Livery Tools modpack that allows players to customize the appearance of their wagons. By using the livery designer tool, players will be have access to more customization options.

Both the bike painter and the livery designer tools are optional and can be used interchangeably on wagons from this mod.

Bike Painter Tool

In addition to using the bike painter to change a color, this mod also allows players to use the bike painter tool to alter the appearance of their wagons by selecting a different livery template. These templates each have a different texture and a different area of the wagon that is affected when colorized by the painter.

In order to support the selection of livery templates, this mod handles the bike painter tool slightly differently than other mods. Specifically, the bike painter can be used to select which livery template is applied to a wagon as well as colorize one aspect of the livery. This is accomplished by using the bike painter tool's "alpha" value to select a livery template instead of a transparency level. Valid alpha values can range from 0 to n where n is one less than the number of livery templates that have been defined for the wagon. Values greater than n cause the bike painter to have no effect. Currently, this mod defines 7 livery templates for each of its 4 wagons.

The bike painter tool's RGB value otherwise works as usual to define a custom color but that color is only applied to the livery template's first overlay, if defined. Also, an RGB value of #000000 has a special meaning in that instead of setting the color to black, it resets the color to its default value. (Consider using color "#010000", "#010101" or something similar for black if needed.) This "#000000" RBG value only applies to the bike painter and does not have a special meaning when using the livery designer tool.

If a livery template has no overlays defined, then the RGB value has no effect but the alpha value is still used to select the template. (Currently, all livery templates defined in this mod have multiple overlays.)

Examples:

Bike Painter Value Result
#00000000 Applies livery template #00 with its default colors (this is the wagon's initial appearance)
#00000001 Applies livery template #01 with its default colors
#FF000002 Applies livery template #02 with a red color applied to the first overlay of the livery template
#00FF0003 Applies livery template #03 with a green color applied to the first overlay of the livery template
#00092B07 No effect due to livery template #07 not being defined.

Note that the bike painter tool first clears any livery customization that may have previously been applied to the wagon.

Livery Designer Tool

The livery designer tool has a graphical user interface that allows easier access to livery template selection and supports independent colorization of multiple overlays of the livery. It also allows players to preview and select predefined liveries. See the livery designer tool's documentation included in the AdvTrains Livery Tools modpack for more information.

Author's Notes

1) These wagon models are the same ones that I created in 2022 with the intention of adding them to the Moretrains mod pack. However, with multiple variations of the Moretrains modpack currently in use, I have decided to release these wagons separately in this mod for easier distribution and to use them for showcasing new livery customization functionality. Both the liveries and the crafting recipes in this mod are different from the those that I created for Moretrains so they won't conflict with one another if used in the same game.

Licenses

Copyright © 2022-2023 Marnack

  • Classic Coaches code is licensed under the GNU AGPL version 3 license, see LICENSE.txt for details.
  • Unless otherwise specified, Classic Coaches media (models, textures, images and sounds) are licensed under CC BY-SA 3.0 Unported.

Attributions

The following items from prior art were included in whole or in part in this mod:

  • From the mod for Minetest named "moretrains_basic" in the "minetest-moretrains" modpack:

    • Models and textures for the bogie, wheels and buffers (CC BY-SA 3.0 by rbduck)
  • From the mod for Minetest named "advtrains_train_jre231" in the "JR_E231series_modpack" modpack:

    • Portions of the code to support livery customization via the bike painter tool (LGPL 2.1 by Mainote plants lab).