aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..de9e3bd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# Architectury Loom based template for 1.8.9 forge mods
+
+**For other templates, do check out the [other branches of this repository](https://github.com/romangraef/Forge1.8.9Template/branches/all)**
+
+To get started, clone this repository.
+In `build.gradle.kts`, replace the values of `baseGroup` and `group` with your own names.
+In `settings.gradle.kts` change `rootProject.name` to your desired mod id.
+
+The `com.example` package needs to be renamed to match the value of `baseGroup`.
+
+If you don't want mixins (which allow for modifying vanilla code), then you can remove the references to mixins from
+the `build.gradle.kts` at the lines specified with comments and the `com.example.mixin` package.
+
+This project uses [DevAuth](https://github.com/DJtheRedstoner/DevAuth) per default, so you can log in using your real
+minecraft account. If you don't need that, you can remove it from the buildscript.
+
+To run the mod you will need two JDKs, one Java 17 jdk and one Java 1.8 jdk. You can download those
+from [here](https://adoptium.net/temurin/releases) (or use your own downloads).
+
+When you import your project into IntelliJ, you need to set the gradle jvm to the Java 17 JDK in the gradle tab, and the
+Project SDK to the Java 1.8 JDK. Then click on the sync button in IntelliJ, and it should create a run task
+called `Minecraft Client`. If it doesn't then try relaunching your IntelliJ. **Warning for Mac users**: You might have to remove the `-XStartOnFirstThread` vm argument from your run configuration. In the future, that should be handled by the plugin, but for now you'll probably have to do that manually.
+
+To export your project, run the `gradle build` task, and give other people the
+file `build/libs/<modid>-<version>.jar`. Ignore the jars in the `build/badjars` folder. Those are intermediary jars that
+are used by the build system but *do not work* in a normal forge installation.
+
+### For those who have not an attention span
+
+[![Youtube Tutorial](https://i.ytimg.com/vi/nWzHlomdCgc/maxresdefault.jpg)](https://www.youtube.com/watch?v=nWzHlomdCgc)
+
+## Licensing
+
+This template is licensed under the Unlicense (license copy present in this repository), or alternatively under [Creative Commons 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/), and all contributions and PR to this template are expected to follow this. This means your mod, based on this template can be licensed whatever way you want, and does not need to reference back to this template in any way.