Immersive Railroading Reforged

# 🚂 Immersive Railroading: NeoForge Port ⚙️🔥

**Immersive Railroading: NeoForge Port** is an **unofficial community port** of the legendary railway mod **Immersive Railroading**, rebuilt and modernized for newer Minecraft versions using **NeoForge**. 🚆🛠️

This project aims to bring back the large-scale train experience: realistic locomotives, heavy rolling stock, industrial rail systems, immersive railway construction, and deep railroad gameplay for modern modded Minecraft. 🌍🚉⚙️

> ⚠️ This is an **unofficial port** and is not affiliated with, sponsored by, or endorsed by the original Immersive Railroading team.

---

## 🚆 What is this mod?

Immersive Railroading is focused on **full-size trains**, **realistic rail systems**, and **industrial transportation**.  
This port continues that vision for modern Minecraft modpacks. 🔥

Build rail networks, operate locomotives, move freight, connect factories, and create massive industrial railway infrastructure. 🏭🚂📦

---

## ✨ Features

🚂 **Large-scale locomotives**  
Run heavy steam, diesel, and industrial rail vehicles.

🛤️ **Railway construction**  
Build immersive track networks for transportation and logistics.

📦 **Freight transport**  
Move cargo, materials, resources, and industrial supplies across your world.

🧱 **Industrial integration focus**  
Designed to fit naturally into engineering, machinery, factory, and logistics modpacks.

⚙️ **Modern NeoForge target**  
Porting work is focused on modern Minecraft / NeoForge compatibility.

🎮 **Survival-friendly gameplay**  
Rail systems are intended to feel useful, expensive, heavy, and rewarding.

🌍 **Multiplayer-oriented design**  
Railroads are perfect for servers, towns, factories, bases, and long-distance infrastructure.

---

## 🛠️ Port Goals

✅ Modernize the codebase  
✅ Restore core train gameplay  
✅ Preserve the original Immersive Railroading spirit  
✅ Improve compatibility with modern modpacks  
✅ Support NeoForge environments  
✅ Keep the project maintainable for future Minecraft versions  
✅ Respect original licenses and credits  

---

## 🔥 Planned / Target Systems

🚂 Locomotives  
🚃 Passenger cars  
📦 Freight cars  
🛢️ Tank cars  
🛤️ Track placement  
⚙️ Rail tools  
🏗️ Multiblock machines  
🎛️ Train controls  
🔊 Train sounds  
🌫️ Smoke / visual effects  
📚 Resource pack train support  
🧰 Modpack integration  

Some systems may arrive progressively depending on porting progress. 🚧

---

## 📦 Dependencies

Required / planned dependencies may include:

🛤️ **TrackAPI**  
⚙️ **UniversalModCore**  
🔥 **NeoForge**

Additional compatibility may be added later for industrial and engineering mods. 🏭

Always check the **Relations** tab for the exact required versions. 📌

---

## ⚠️ Development Status

This project is a **large technical port**. 🚧  
Some features may be incomplete, experimental, or temporarily disabled while the codebase is being modernized.

Please report issues with:

🐞 Minecraft version  
🐞 NeoForge version  
🐞 Mod version  
🐞 Crash report  
🐞 Latest log  
🐞 Steps to reproduce  

Helpful reports make the port better. 🛠️

---

## 🎮 Recommended For

✅ Industrial modpacks 🏭  
✅ Train-focused servers 🚉  
✅ Logistics gameplay 📦  
✅ Survival engineering worlds ⚙️  
✅ Large multiplayer worlds 🌍  
✅ Players who love massive machines 🚂  

---

## 🧪 Known Notes

🚧 This is not a lightweight cosmetic mod.  
🚧 Train systems are complex and may require testing.  
🚧 Compatibility with every modpack is not guaranteed.  
🚧 Always back up your world before updating. 💾  
🚧 Server testing is recommended before public use. 🖥️  

---

## 📜 Credits

Huge credit to the original **Immersive Railroading** creators and contributors cam72cam . 🚂🙏  
This project exists because of the original work, design, and community built around Immersive Railroading.

Original project: **Immersive Railroading**  
Original team / contributors: **TeamOpenIndustry / original IR contributors**  
Port / maintenance: **OblixorPrime**

---

## ⚖️ License / Legal Notice

This is an **unofficial community port**. ⚠️

All original code, assets, models, sounds, names, and resources remain under their respective licenses and belong to their original creators.  
This project aims to respect the original licensing terms, attribution requirements, and redistribution rules. 📜

If any asset or content cannot legally be redistributed in this port, it will be removed, replaced, or required from the original source when appropriate. 🛡️

No endorsement by the original authors is implied. 🚫

This project is an unofficial port/fork of Immersive Railroading by cam72cam / TeamOpenIndustry.

Original project: [Immersive Railroading](https://www.curseforge.com/minecraft/mc-mods/immersive-railroading)

Original source: [TeamOpenIndustry/ImmersiveRailroading](https://github.com/TeamOpenIndustry/ImmersiveRailroading)

Licensed under GNU Lesser General Public License version 2.1 (LGPLv2.1), matching the original project license.

---

## 🚂 Final Goal

Bring immersive, full-scale railway engineering back to modern Minecraft.  
Heavy trains. Long rails. Big factories. Real logistics. Industrial power. ⚙️🔥

Build the network. Move the world. 🚆🌍