quilt-template-mod/README.md

30 lines
2 KiB
Markdown
Raw Normal View History

2022-04-24 20:02:48 +00:00
# Quilt Template Mod
2022-04-20 17:09:40 +00:00
2022-12-10 00:58:09 +00:00
The official Quilt template mod. You can use it as a template for your own mods!
2022-04-20 17:09:40 +00:00
2022-04-20 19:04:10 +00:00
## Usage
In order to use this mod as a template:
2022-04-20 19:02:00 +00:00
1. Create a new repository from this template with `Use this template`
2022-04-20 19:02:00 +00:00
2. Clone the recently-created repo on your PC
3. Make the necessary changes in order to make it yours:
- Update `gradle.properties` in order to use your Maven group and mod ID
- If you don't know which Maven group to use, and you are planning to host the mod's source code on GitHub, use `io.github.<Your_Username_Here>`
2022-04-20 19:02:00 +00:00
- Update `quilt.mod.json` in order to reflect your mod's metadata
- If you are planning to include (jar-in-jar) a mod, don't forget to declare its dependency on it!
2022-04-20 19:02:00 +00:00
- The icon provided here is a placeholder one. If you aren't able to replace it yet, you can delete it and remove the "icon" property
- Create a LICENSE file for this mod! If you don't know which license to use, check out [here](https://choosealicense.com/).
- If you use `LICENSE.md`, don't forget to update the buildscript in order to use that file name!
2022-04-20 23:39:33 +00:00
- In `quilt.mod.json`, don't forget to put the license's [SPDX identifier](https://spdx.org/licenses/) under the `"license"` property in `"metadata"`.
- The GPLv3 and AGPLv3 are not valid mod licenses, so you can use almost any license except for those.
2022-04-20 19:02:00 +00:00
- Update the Java sub-directory structure so it reflects your Maven group
- If the dependencies on `gradle/libs.versions.toml` isn't up-to-date, feel free to update them! The [linked utility](https://lambdaurora.dev/tools/import_quilt.html) should help you in this easy and quick process.
2022-04-20 19:02:00 +00:00
4. The mod is now ready to be worked on!
2022-04-20 17:09:40 +00:00
## License
2022-04-20 19:02:00 +00:00
This template on the QuiltMC GitHub is licensed under the [Creative Common Zero v1.0 license](./LICENSE-TEMPLATE.md).
2022-04-20 17:09:40 +00:00
Mods created with this template are not automatically licensed under the CC0, and are not required to give any kind of credit back to QuiltMC for this template.