FORGE_README.txt 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. Source installation information for modders
  2. -------------------------------------------
  3. This code follows the Minecraft Forge installation methodology. It will apply
  4. some small patches to the vanilla MCP source code, giving you and it access
  5. to some of the data and functions you need to build a successful mod.
  6. Note also that the patches are built against "un-renamed" MCP source code (aka
  7. SRG Names) - this means that you will not be able to read them directly against
  8. normal code.
  9. Setup Process:
  10. ==============================
  11. Step 1: Open your command-line and browse to the folder where you extracted the zip file.
  12. Step 2: You're left with a choice.
  13. If you prefer to use Eclipse:
  14. 1. Run the following command: `gradlew genEclipseRuns` (`./gradlew genEclipseRuns` if you are on Mac/Linux)
  15. 2. Open Eclipse, Import > Existing Gradle Project > Select Folder
  16. or run `gradlew eclipse` to generate the project.
  17. If you prefer to use IntelliJ:
  18. 1. Open IDEA, and import project.
  19. 2. Select your build.gradle file and have it import.
  20. 3. Run the following command: `gradlew genIntellijRuns` (`./gradlew genIntellijRuns` if you are on Mac/Linux)
  21. 4. Refresh the Gradle Project in IDEA if required.
  22. If at any point you are missing libraries in your IDE, or you've run into problems you can
  23. run `gradlew --refresh-dependencies` to refresh the local cache. `gradlew clean` to reset everything
  24. {this does not affect your code} and then start the process again.
  25. Mapping Names:
  26. =============================
  27. By default, the MDK is configured to use the official mapping names from Mojang for methods and fields
  28. in the Minecraft codebase. These names are covered by a specific license. All modders should be aware of this
  29. license, if you do not agree with it you can change your mapping names to other crowdsourced names in your
  30. build.gradle. For the latest license text, refer to the mapping file itself, or the reference copy here:
  31. https://github.com/MinecraftForge/MCPConfig/blob/master/Mojang.md
  32. Additional Resources:
  33. =========================
  34. Community Documentation: https://mcforge.readthedocs.io/en/latest/gettingstarted/
  35. LexManos' Install Video: https://www.youtube.com/watch?v=8VEdtQLuLO0
  36. Forge Forum: https://forums.minecraftforge.net/
  37. Forge Discord: https://discord.gg/UvedJ9m