KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Weave-Loader

★ 174 Open GitHub ↗

Universal Minecraft Client Mod-Loader, written in Kotlin

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Weave Loader, the Universal Minecraft Mod Loader

Weave Loader is a tool designed to simplify the process of modding Minecraft. It allows
developers to easily create mods by providing a simple and intuitive API for interacting with Minecraft's codebase,
while supporting injection into clients that are somewhat closed-off to developers.

## Supported Clients / Versions

<table>
<tr><th>Supported Clients</th><th>Supported Versions</th></tr>
<tr><td>
        
| Client  |     Supported      |
|---------|:------------------:|
| Vanilla | :white_check_mark: |
| Forge   | :white_check_mark: |
| Fabric  | :white_check_mark: |
| Lunar   | :white_check_mark: |
| Badlion |        :x:         |
| Feather |        :x:         |
| Labymod | :white_check_mark: |

</td><td>
    
| Version |     Supported      |
|---------|:------------------:|
| 1.7     | :white_check_mark: |
| 1.8     | :white_check_mark: |
| 1.12    | :white_check_mark: |
| 1.16    | :white_check_mark: |
| 1.17    | :white_check_mark: |
| 1.18    | :white_check_mark: |
| 1.19    | :white_check_mark: |
| 1.20    | :white_check_mark: |
| 1.21    | :white_check_mark: |

</td></tr>
</table>

**If you find any issues with supported clients, please report them to us.**

## Installation

To install Weave-Loader, you can either download a pre-built release from
the [releases page](https://github.com/Weave-MC/Weave-Loader/releases), or build it yourself from source.

### Building with Gradle

- First clone the project with [Git][git] then `cd` into the project directory:

```bash
git clone --recursive https://github.com/Weave-MC/Weave-Loader
cd Weave-Loader
```

You then need to give permission to the Gradle wrapper and run the `build` task. This can be done a bit differently
depending on your operating system:

<details open>
<summary><b>UN*X</b> (Linux, BSDs, macOS, etc.)</summary>

```bash
chmod +x ./gradlew
./gradlew build
```
</details>

<details>
<summary><b>Windows</b></summary>

```powershell
.\gradlew.bat build
```
</details>

Lastly, the finalised Loader Agent JAR can be found at `loader/build/libs/weave-loader-<version>-all.jar`.

## Usage

To use Weave-Loader, you have two options:
- Use [Weave-Manager](https://github.com/Weave-MC/Weave-Manager) to handle the process of attaching Weave to your preferred Minecraft client automatically.
- Manually add the Weave-Loader agent mentioned in the previous step to the JVM arguments when launching Minecraft.
  - You will need to include the following argument: `-javaagent:$PATH_TO_AGENT`

Weave will automatically load mods from `~/.weave/mods/`.

## Contributing

We welcome contributions from anyone interested in improving Weave-Loader. If you find a bug or have an idea for a new
feature, feel free to submit a pull request.

---

Weave-Loader is licensed under the [GNU General Public License v3.0][license].

</div>

[git]:     https://git-scm.com/

[license]: https://github.com/Weave-MC/Weave-Loader/blob/master/LICENSE

Weave-Loader

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README