# 🛤️ TrackAPI: NeoForge Port ⚙️🚂
**TrackAPI: NeoForge Port** is a lightweight railway foundation library for modern Minecraft modding. 🧩🛤️
This project provides the rail/track support layer needed by train and railway mods, especially large-scale railway systems that need reliable track geometry, placement logic, and compatibility infrastructure. 🚆⚙️
> ⚠️ This is an **unofficial community port** unless explicitly stated otherwise. It is not affiliated with, sponsored by, or endorsed by the original authors.
---
## 🧩 What is TrackAPI?
TrackAPI is not a normal gameplay content mod. 🛠️
It is a **technical dependency / library mod** designed to help railway mods work with track systems. 🛤️📐
Players usually install TrackAPI because another mod requires it. Modders use it as a rail foundation layer for train movement, rail placement, and track-related systems. 🚂🔧
---
## ✨ Features
🛤️ **Rail foundation layer**
Provides shared track logic for railway-focused mods.
📐 **Track geometry support**
Helps mods handle rail shapes, rail data, and track behavior.
🚂 **Train mod compatibility layer**
Designed to support large railway mods and train-related systems.
⚙️ **Modern NeoForge target**
Porting work is focused on modern Minecraft / NeoForge compatibility.
🧩 **Library-first design**
Built to be used by other mods instead of adding large standalone gameplay systems.
🌍 **Server-friendly purpose**
Useful for modpacks and servers that rely on railway infrastructure mods.
---
## 🛠️ Port Goals
✅ Modernize the TrackAPI codebase
✅ Restore compatibility for railway mods
✅ Support NeoForge environments
✅ Keep the API stable for dependent mods
✅ Preserve the original TrackAPI purpose
✅ Reduce breakage for train-focused modpacks
✅ Respect original credits and licensing requirements
---
## 🚂 Intended Use
TrackAPI is recommended for:
🚆 Railway mods
🛤️ Train systems
📦 Logistics modpacks
🏭 Industrial modpacks
🌍 Multiplayer infrastructure worlds
🧩 Mods that need track behavior support
⚙️ Developers porting or maintaining train-related content
---
## 📦 Dependencies
Required dependencies may include:
⚙️ **NeoForge**
☕ **Java 21** depending on target Minecraft version
🧩 Other dependencies listed in the **Relations** tab
Always check the **Relations** tab for the exact required versions. 📌
---
## ⚠️ Development Status
This project is a technical port. 🚧
Some behavior may change while compatibility is restored and tested.
Please report issues with:
🐞 Minecraft version
🐞 NeoForge version
🐞 TrackAPI version
🐞 Dependent mod name/version
🐞 Crash report
🐞 Latest log
🐞 Steps to reproduce
Clear reports help stabilize the API faster. 🛠️
---
## 🧪 Notes for Players
📌 If a train mod asks for TrackAPI, install this mod.
📌 TrackAPI may not add visible items or blocks by itself.
📌 Do not remove it from a modpack if another mod depends on it.
📌 Always back up worlds before updating railway mods. 💾
📌 Server owners should test updates before deploying publicly. 🖥️
---
## 🧰 Notes for Modpack Makers
🧩 Use this as a dependency for railway-focused packs.
🛤️ Keep TrackAPI version aligned with dependent mods.
🚂 Test train movement, rail placement, world reloads, and server sync.
📦 Include it in server packs when required.
⚠️ Avoid mixing incompatible TrackAPI builds across loaders or Minecraft versions.
---
## 📜 Credits
Huge credit to the original **TrackAPI** creators and contributors cam72cam . 🙏🛤️
This port exists because of the original railway foundation work created for the Minecraft train modding community.
Original project: **TrackAPI**
Original team / contributors: **TeamOpenIndustry / original TrackAPI contributors**
Port / maintenance: **OblixorPrime**
---
## ⚖️ License / Legal Notice
This is an **unofficial community port** unless explicitly stated otherwise. ⚠️
All original code, names, assets, and resources remain under their respective licenses and belong to their original creators. 📜
This project aims to respect original licensing terms, attribution requirements, and redistribution rules. 🛡️
No endorsement by the original authors is implied. 🚫
MIT Liscence
Copyright 2017 Christian Mesh
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
---
## 🛤️ Final Goal
A stable, modern rail foundation layer for Minecraft railway mods. 🚂⚙️
Small library. Big infrastructure. Strong tracks. 🛤️🔥
Build the rails. Support the trains. Connect the world. 🌍🚆
---
## 🔥 Ultra-short Curse summary
🛤️ A modern NeoForge port of TrackAPI, providing the rail foundation layer needed by railway mods, train systems, and industrial transport modpacks. 🚂⚙️🧩
