Skip to content

Commit edb9d37

Browse files
authored
Update README.md
1 parent c3813b0 commit edb9d37

1 file changed

Lines changed: 17 additions & 128 deletions

File tree

README.md

Lines changed: 17 additions & 128 deletions
Original file line numberDiff line numberDiff line change
@@ -1,140 +1,29 @@
1-
# Meteor Addon Template
1+
# Nerd addon
22

3-
A template to allow easy usage of the Meteor Addon API.
3+
🤓 Meteor client addon that designed for nerds
44

5-
### How to use
5+
### How to intstall
66

7-
#### Use GitHub Template (Recommended)
7+
#### Github Actions (Recommended)
88

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+
1113

1214
#### Clone Manually
1315

1416
- Alternatively, clone this repository using these commands for a clean history:
1517
```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
2221
```
2322

24-
#### Development
23+
#### Contributing
24+
- Create a pull request :3
2525

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

Comments
 (0)