summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorcpw <cpw+github@weeksfamily.ca>2023-07-15 17:03:54 -0400
committercpw <cpw+github@weeksfamily.ca>2023-07-15 17:03:54 -0400
commit2b3334097e4aa634fdad0dcae2a6d8a7879bd879 (patch)
treef82103101910a4651291fc75340586d7c81d1e99 /README.md
parent55cc1e2504e84501f426334f36225866df0c7bcf (diff)
Update readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9eecc2b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+
+Installation information
+=======
+
+This template repository can be directly cloned to get you started with a new
+mod. Simply create a new repository cloned from this one, by following the
+instructions at [github](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template).
+
+Once you have your clone, you can initialize your copy.
+
+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/NeoForged/NeoForm/blob/main/Mojang.md
+
+Additional Resources:
+==========
+Community Documentation: https://docs.neoforged.net/
+NeoForged Discord: https://discord.neoforged.net/