Here you will find the source for the GTNH fork of the Railcraft Project. See covertjaguar_RC_permission.png for permission.
Please open issues on our main pack issue tracker here.
To develop on the GTNH fork, ignore the instructions in the original README below, and instead follow the standard GTNH development instructions, but usually all you need to do is:
./gradlew build- builds the project, if it fails you may need./gradlew spotlessApplyfirst./gradlew runClient- runs a Minecraft client with this project
The original README follows:
Railcraft is a mod written for the hit game Minecraft. It is built on top of the Minecraft Forge API.
It greatly expands and improves the Minecart system in Minecraft. Adding many new blocks, entities, and features. It has been in development since 2012 and contains over 800 class files and hundreds of thousands of lines of code.
The mod was created and is still currently maintained by the user going by the name CovertJaguar.
In the words of CovertJaguar:
As a new modder, I originally feared losing control of my code, my brainchild. However, since that time, I have had the privelege of being Project Lead on two other major Minecraft Mod projects that provided access to the source: Buildcraft and Forestry. I've generally found this to be a positive experiance resulting in many bug fixes and increased intermod compatibility. While I still have some concerns, I have come to feel that the benefits of providing others access to my source code outweighs the negatives and unknowns. To that end, despite my missgivings, I made Source Access a Patreon Milestone Goal. I had no idea whether I'd ever meet that Goal, but I decided to let the community decide, and decide they did, overwhelminging so! My Patrons are awesome. So, as promised, I am posting the Source Code.
- The Blog, Forums, and main download page: http://www.railcraft.info
- The Wiki: http://railcraft.info/wiki
- IRC: #railcraft on Esper.net - WebChat
- Patreon Page: http://www.patreon.com/CovertJaguar
The Official Railcraft Project welcomes contributions from anyone, provided they have signed the Contributor Licensing Agreement (CLA) found here.
Signing the CLA is simple, just follow the link, and hit the "I Agree" button and you are good to go.
Regarding new features/behavior changes, please submit a Suggestion Issue to the Tracker before you write a single line of code. Keeping everyone on the same page saves time and effort and reduces negative experiences all around when a change turns out to be controversial.
Also, as a bonus. If submit a Pull Request that ends up being 'merged into dev' you are elligable to recieve beta access. To redeem, contact CovertJaguar on IRC.
GTNH Note: These are the original building steps, which do not work on this fork and shouldn't be used.
The Railcraft Project follows standard Forge conventions for setting up and building a project, with a couple additional details (details to come).
You can create a gradle.properties file in the project root with the following properties:
mcUsername=Steve
mcPassword=ILoveNotch
Initial Setup from the Command Line:
gradlew setupDecompWorkspace eclipse
The API and Localization files reside in their own repositories and are pulled automatically into the main repo as git submodules. You will however need to run the following commands:
git submodule init
git submodule update
Railcraft is licensed under a custom usage license tailored specifically for the project. It can be read here.
- Key things to keep in mind:
- You may NOT create works using the Railcraft code (source or binary) without CovertJaguar's explicit permission except in the cases listed in this license.
- You may NOT create derivative Jars from Railcraft source to distribute to other users.
- You MAY use snippets of Railcraft Code posted on the Official Github in your own projects, but only if your project consists of less than 25% of Railcraft derived code. You must give credit to the Railcraft Project for the code used, including a link to the Github Project. Put this in your class file headers that contain Railcraft code, in your readme, and on the main download page.
- You may NOT use Railcraft Art Assets in other projects unless the project is intended to operate alongside Railcraft. Examples are Addons and InterMod Integration.
- You MAY fork and edit the Github Project for the purpose of contributing to the Official Railcraft Project. You may NOT distribute any Jar created from a fork for any reason.
- (This does not apply to our fork, because the contributions are not going to the official upstream project) All contributions to the Official Railcraft Project must be covered by a Contributor Licensing Agreement signed by the contributor.