Trans is an AI for OpenTTD. It attempts to transport cargo to and from any towns and industries using buses, trucks, trams, aircraft, and ships. In the future, it will attempt to use all available vehicle types. Its current strategy is to use only one type of industry as a cargo destination where possible, based on the Cargo Concept. See implemented features in ROADMAP.md.
- Quick summary
Since version 0.7, OpenTTD allows for the implementation of custom AIs to play with. This repository contains the source code for Trans, an in-game AI opponent for OpenTTD.
There are three ways to install Trans AI, depending on your needs.
The easiest way to get the latest stable version is to download it directly from OpenTTD's in-game content service ('Bananas').
- Open OpenTTD and click "Check Online Content".
- Search for "Trans AI" under the "AI" category.
- Select it and click "Download".
If you want to try the latest features, you can download development builds directly from our GitHub Releases page.
- Go to the releases page and find the latest release marked with a date (e.g.,
250610). - Download the
.tarfile from the "Assets" section. - Place the
Trans-AI-[version].tarfile directly in your OpenTTDaidirectory. No need to extract it.
If you plan to contribute to the development, you should clone the repository directly.
- Clone this repository into your OpenTTD
aifolder:- Linux:
$(HOME)/.openttd/ai - macOS:
$(HOME)/Documents/OpenTTD/ai - Windows:
C:\Users\<username>\Documents\OpenTTD\ai
- Linux:
- Ensure you have the required dependencies (see below).
Trans AI requires the following libraries to be installed in your ../ai/library folder:
This project uses a rolling release model, with the version number based on the commit date in YYMMDD format. This means there is only one release per day; subsequent pushes on the same day will update the existing daily release with the latest changes.
If you clone this repository directly, the version number in your local info.nut file is intentionally set to a date far in the future. This ensures that OpenTTD gives priority to your local development version over any officially downloaded release.
Releases created from the bananas tag are special versions that are also uploaded to the official OpenTTD content service, 'Bananas'.
This project has moved from a manual script-based build to a fully automated process using GitHub Actions. The entire process is defined in the .github/workflows/rolling-release.yml file.
Trans AI is licensed under the GNU General Public License version 2.0. For the complete license text, see the file license.txt. This license applies to all files in this distribution. By contributing your code, you agree to license your contribution under the GNU GPL v2 License.
The issue tracker is the preferred channel for bug reports, feature requests, and pull requests. Please refer to ROADMAP.md for contribution guidelines.
- Rifani Arsyad - a.k.a fanioz -