|
1 | | -# Meteor Addon Template |
| 1 | +# Nerd addon |
2 | 2 |
|
3 | | -A template to allow easy usage of the Meteor Addon API. |
| 3 | +🤓 Meteor client addon that designed for nerds |
4 | 4 |
|
5 | | -### How to use |
| 5 | +### How to intstall |
6 | 6 |
|
7 | | -#### Use GitHub Template (Recommended) |
| 7 | +#### Github Actions (Recommended) |
8 | 8 |
|
9 | | -- Click the green `Use this template` button in the top right corner of this page. |
10 | | - This will create a new repository with this template and a clean history. |
| 9 | +- Click the `Actions` tab |
| 10 | +- Click the last successful run |
| 11 | +- The jar file will be at under the `Artifacts` part |
| 12 | + |
11 | 13 |
|
12 | 14 | #### Clone Manually |
13 | 15 |
|
14 | 16 | - Alternatively, clone this repository using these commands for a clean history: |
15 | 17 | ```bash |
16 | | - git clone --depth 1 https://github.com/MeteorDevelopment/meteor-addon-template your-addon-name |
17 | | - cd your-addon-name |
18 | | - rm -rf .git |
19 | | - git init |
20 | | - git add . |
21 | | - git commit -m "Initial commit from template" |
| 18 | + git clone https://github.com/Frko5000/Nerd-Addon.git |
| 19 | + cd Nerd Addon |
| 20 | + gradlew build |
22 | 21 | ``` |
23 | 22 |
|
24 | | -#### Development |
| 23 | +#### Contributing |
| 24 | +- Create a pull request :3 |
25 | 25 |
|
26 | | -- Use this template to add custom modules, commands, HUDs, and other features to Meteor Client. |
27 | | -- To test, run the `Minecraft Client` configuration in your IDE. |
28 | | - This will start a Minecraft client with the Meteor Client mod and your addon loaded. |
29 | | -- To build, run the gradle `build` task. This will create a JAR file in the `build/libs` folder. |
30 | | - - Move the JAR file to the `mods` folder of your Minecraft installation, alongside the Meteor Client mod and run the |
31 | | - game. |
32 | | - |
33 | | -### Updating to newer Minecraft versions |
34 | | - |
35 | | -To update this template to a newer Minecraft version, follow these steps: |
36 | | - |
37 | | -1. Ensure a Meteor Client snapshot is available for the new Minecraft version. |
38 | | -2. Update `gradle/libs.versions.toml` (the versions catalog): |
39 | | - - Set the version entries to the new versions. Common keys to update are: |
40 | | - - `versions.minecraft` - Minecraft version |
41 | | - - `versions.yarn-mappings` - Yarn mappings |
42 | | - - `versions.fabric-loader` - Fabric loader version |
43 | | - - `versions.meteor` - Meteor Client snapshot version |
44 | | - - If your addon depends on other libraries listed under the `[libraries]` section, update their versions there as |
45 | | - needed. |
46 | | - - After editing, refresh Gradle dependencies and rebuild your project in the IDE. |
47 | | -3. Update Loom: |
48 | | - - Change the `loom` version in `gradle/libs.versions.toml` (the `versions.loom` entry) to the latest version |
49 | | - compatible with the new Minecraft version. |
50 | | -4. Update the Gradle wrapper: |
51 | | - - Run the wrapper update command for your platform. Examples: |
52 | | - - Unix / macOS / Windows (Powershell): `./gradlew wrapper --gradle-version <version> && ./gradlew wrapper` |
53 | | - - Windows (cmd.exe): `gradlew.bat wrapper --gradle-version <version> && gradlew.bat wrapper` |
54 | | - - This updates and regenerates the Gradle Wrapper scripts (`gradlew`, `gradlew.bat`, etc.) for the specified version. |
55 | | -5. Update your source code: |
56 | | - - Adjust for Minecraft or Yarn mapping changes: method names, imports, mixins, etc. |
57 | | - - Check for Meteor Client API changes that may affect your addon by comparing against the |
58 | | - [master branch](https://github.com/MeteorDevelopment/meteor-client/tree/master). |
59 | | -6. Build and test: |
60 | | - - Run the gradle `build` task. |
61 | | - - Confirm the build succeeds and your addon works with the new Minecraft version. |
62 | | - |
63 | | -### Project structure |
64 | | - |
65 | | -```text |
66 | | -. |
67 | | -│── .github |
68 | | -│ ╰── workflows |
69 | | -│ │── dev_build.yml |
70 | | -│ ╰── pull_request.yml |
71 | | -│── gradle |
72 | | -│ │── libs.versions.toml |
73 | | -│ ╰── wrapper |
74 | | -│ │── gradle-wrapper.jar |
75 | | -│ ╰── gradle-wrapper.properties |
76 | | -│── src |
77 | | -│ ╰── main |
78 | | -│ │── java |
79 | | -│ │ ╰── com |
80 | | -│ │ ╰── example |
81 | | -│ │ ╰── addon |
82 | | -│ │ │── commands |
83 | | -│ │ │ ╰── CommandExample |
84 | | -│ │ │── hud |
85 | | -│ │ │ ╰── HudExample |
86 | | -│ │ │── modules |
87 | | -│ │ │ ╰── ModuleExample |
88 | | -│ │ ╰── AddonTemplate |
89 | | -│ ╰── resources |
90 | | -│ │── assets |
91 | | -│ │ ╰── template |
92 | | -│ │ ╰── icon.png |
93 | | -│ │── addon-template.mixins.json |
94 | | -│ ╰── fabric.mod.json |
95 | | -│── .editorconfig |
96 | | -│── .gitignore |
97 | | -│── build.gradle.kts |
98 | | -│── gradle.properties |
99 | | -│── gradlew |
100 | | -│── gradlew.bat |
101 | | -│── LICENSE |
102 | | -│── README.md |
103 | | -╰── settings.gradle.kts |
104 | | -``` |
105 | | - |
106 | | -This is the default project structure. Each folder/file has a specific purpose. |
107 | | -Here is a brief explanation of the ones you might need to modify: |
108 | | - |
109 | | -- `.github/workflows`: Contains the GitHub Actions configuration files. |
110 | | -- `gradle`: Contains the Gradle wrapper files and the versions catalog. |
111 | | - - `libs.versions.toml`: Defines version numbers for Minecraft, Loom, Meteor, and other dependencies. |
112 | | - - `wrapper`: Contains the Gradle wrapper executable files. |
113 | | - To update the Gradle wrapper executable itself, run the wrapper update command (examples are shown above). |
114 | | -- `src/main/java/com/example/addon`: Contains the main class of the addon. |
115 | | - Here you can register your custom commands, modules, and HUDs. |
116 | | - Edit the `getPackage` method to reflect the package of your addon. |
117 | | -- `src/main/resources`: Contains the resources of the addon. |
118 | | - - `assets`: Contains the assets of the addon. |
119 | | - You can add your own assets here, separated in subfolders. |
120 | | - - `template`: Contains the assets of the template. |
121 | | - You can replace the `icon.png` file with your own addon icon. |
122 | | - Also, rename this folder to reflect the name of your addon. |
123 | | - - `addon-template.mixins.json`: Contains the Mixin configuration for the addon. |
124 | | - You can add your own mixins in the `client` array. |
125 | | - - `fabric.mod.json`: Contains the metadata of the addon. |
126 | | - Edit the various fields to reflect the metadata of your addon. |
127 | | -- `build.gradle.kts`: Contains the Gradle build script. |
128 | | - You can manage the dependencies of the addon here. |
129 | | - Remember to keep the `fabric-loom` version up-to-date. |
130 | | -- `gradle.properties`: Contains additional build properties used by the build script |
131 | | - (for example `maven_group` and `archives_base_name`). |
132 | | - Dependency and platform version numbers are stored in `gradle/libs.versions.toml`. |
133 | | -- `LICENSE`: Contains the license of the addon. |
134 | | - You can edit this file to change the license of your addon. |
135 | | -- `README.md`: Contains the documentation of the addon. |
136 | | - You can edit this file to reflect the documentation of your addon, and showcase its features. |
137 | | - |
138 | | -## License |
139 | | - |
140 | | -This template is available under the CC0 license. Feel free to use it for your own projects. |
| 26 | +#### Issues |
| 27 | +- You can ask any questions on the issues tab |
| 28 | +- You can report the issues on here |
| 29 | +- You can ask for new features |
0 commit comments