summaryrefslogtreecommitdiff
path: root/README.txt
diff options
context:
space:
mode:
author alemidev <me@alemi.dev>2023-01-24 01:07:30 +0100
committer alemidev <me@alemi.dev>2023-01-24 01:07:30 +0100
commit2e00a3ee4bd5740e47fe4ca5fd6d3bd9bc8af070 (patch)
tree01100cc86bc67a375475e1016dfeba3426deac95 /README.txt
chore: boilerplate
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt46
1 files changed, 46 insertions, 0 deletions
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..344bca7
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,46 @@
+
+Source installation information for modders
+-------------------------------------------
+This code follows the Minecraft Forge installation methodology. It will apply
+some small patches to the vanilla MCP source code, giving you and it access
+to some of the data and functions you need to build a successful mod.
+
+Note also that the patches are built against "un-renamed" MCP source code (aka
+SRG Names) - this means that you will not be able to read them directly against
+normal code.
+
+Setup Process:
+==============================
+
+Step 1: Open your command-line and browse to the folder where you extracted the zip file.
+
+Step 2: You're left with a choice.
+If you prefer to use Eclipse:
+1. Run the following command: `gradlew genEclipseRuns` (`./gradlew genEclipseRuns` if you are on Mac/Linux)
+2. Open Eclipse, Import > Existing Gradle Project > Select Folder
+ or run `gradlew eclipse` to generate the project.
+
+If you prefer to use IntelliJ:
+1. Open IDEA, and import project.
+2. Select your build.gradle file and have it import.
+3. Run the following command: `gradlew genIntellijRuns` (`./gradlew genIntellijRuns` if you are on Mac/Linux)
+4. Refresh the Gradle Project in IDEA if required.
+
+If at any point you are missing libraries in your IDE, or you've run into problems you can
+run `gradlew --refresh-dependencies` to refresh the local cache. `gradlew clean` to reset everything
+{this does not affect your code} and then start the process again.
+
+Mapping Names:
+=============================
+By default, the MDK is configured to use the official mapping names from Mojang for methods and fields
+in the Minecraft codebase. These names are covered by a specific license. All modders should be aware of this
+license, if you do not agree with it you can change your mapping names to other crowdsourced names in your
+build.gradle. For the latest license text, refer to the mapping file itself, or the reference copy here:
+https://github.com/MinecraftForge/MCPConfig/blob/master/Mojang.md
+
+Additional Resources:
+=========================
+Community Documentation: http://mcforge.readthedocs.io/en/latest/gettingstarted/
+LexManos' Install Video: https://www.youtube.com/watch?v=8VEdtQLuLO0
+Forge Forum: https://forums.minecraftforge.net/
+Forge Discord: https://discord.gg/UvedJ9m \ No newline at end of file