mjolnir-resource-pack

# ⚡ Mjolnir <p align="center"> <strong>A Thor-inspired custom weapon plugin for Paper Minecraft servers.</strong> </p> --- ## ⚡ About **Mjolnir** is a lightweight custom weapon plugin for **Paper Minecraft servers**. The plugin adds a custom **Trident-based weapon** called **Mjolnir**, inspired by Thor's legendary hammer. Mjolnir features two switchable gameplay modes: - 🌊 **Travel Mode** - ⚡ **Fighting Mode** The weapon uses a persistent internal identifier rather than relying only on its visible name, making it impossible for a normal renamed Trident to accidentally activate Mjolnir's abilities. Mjolnir is also permanently unbreakable and includes a dedicated resource pack for its custom appearance. --- ## ✨ Features - ⚡ Custom Mjolnir weapon - 🔱 Built on the vanilla Trident - 🌊 Travel Mode - ⚡ Fighting Mode - 🌊 Riptide X - 🌩 Channeling I - 🗡 Impaling X - 🔄 Loyalty X - 🛡 Unbreaking X - ✨ Mending I - ♾️ Permanently unbreakable - 🔐 Persistent Data Container item identification - 🌩 Configurable thunderstorm - ⏳ Configurable mode-switch cooldown - ⚡ Cosmetic lightning effects - ✨ Electric particles - 🔊 Thunder and Trident sound effects - 📦 Plugin-controlled resource pack - 🔄 Designed to work alongside an existing server resource pack - 🪶 Lightweight and suitable for small SMP servers - 🖥️ Console-compatible `/mjolnir give` command --- # 🖥️ Requirements | Requirement | Version | |---|---| | Minecraft Java Edition | **26.1.2** | | Server Software | **Paper** | | Paper | **26.1.2** | | Java | **25** | > ⚠️ Mjolnir is specifically developed and tested for Paper 26.1.2. > > Older Minecraft/Paper 1.21.x versions are not supported. --- # 📦 Installation ## 1. Install Paper Create or use a Paper 26.1.2 server running Java 25. Verify Java: ```bash java --version ```` You should see Java 25. --- ## 2. Download Mjolnir Download the latest: ```text Mjolnir-x.x.x.jar ``` from the project's release/download page. Place the JAR inside: ```text plugins/ ``` Your server should look like: ```text server/ ├── plugins/ │ └── Mjolnir-x.x.x.jar │ ├── world/ ├── world_nether/ ├── world_the_end/ └── server.properties ``` --- ## 3. Start the server Start Paper normally. On the first startup, Mjolnir will generate: ```text plugins/Mjolnir/ ``` including: ```text plugins/Mjolnir/config.yml ``` --- # 🎨 Resource Pack Mjolnir uses a dedicated resource pack for its custom weapon appearance. The resource pack is controlled by the plugin and does **not** need to replace the server's main resource pack. This allows a server to use: ```text Server Resource Pack + Mjolnir Resource Pack ``` at the same time. The Mjolnir resource pack is added to the client's resource-pack stack by the plugin. You do **not** need to add the Mjolnir resource pack to: ```text server.properties ``` --- ## 📦 Resource Pack Configuration The resource pack settings are located in: ```text plugins/Mjolnir/config.yml ``` Example: ```yaml resource-pack: enabled: true url: "YOUR_RESOURCE_PACK_URL" sha1: "YOUR_RESOURCE_PACK_SHA1" required: true send-on-join: true send-delay-ticks: 40 ``` ### Configuration options | Setting | Description | | ------------------ | ---------------------------------------------- | | `enabled` | Enables/disables the Mjolnir resource pack | | `url` | Direct download URL of the resource pack | | `sha1` | SHA-1 hash of the resource-pack ZIP | | `required` | Whether players must accept the resource pack | | `send-on-join` | Automatically sends the pack when players join | | `send-delay-ticks` | Delay before sending the resource pack | --- ## 🔐 SHA-1 The SHA-1 should match the exact resource-pack ZIP being hosted. On Linux: ```bash sha1sum Mjolnir-Resource-Pack-x.x.x.zip ``` Example: ```text aabbccddeeff00112233445566778899aabbccdd Mjolnir-Resource-Pack-1.0.0.zip ``` Then configure: ```yaml resource-pack: sha1: "aabbccddeeff00112233445566778899aabbccdd" ``` If you modify the resource pack after calculating the SHA-1, calculate the hash again. --- # 🔨 Getting Mjolnir Mjolnir can be given using the main plugin command. ## Command ```text /mjolnir give <player> ``` Example: ```text /mjolnir give Steve ``` The player receives the custom Mjolnir Trident. --- # 🔐 Permission The administrative permission is: ```text mjolnir.admin ``` Players must have this permission to use administrative Mjolnir commands. Server operators can use the command by default. --- # 🌊 Travel Mode Travel Mode is the movement-focused version of Mjolnir. ## Enchantments ```text Riptide X Unbreaking X Mending I ``` Mjolnir behaves as a Riptide Trident while Travel Mode is active. This makes it useful for: * Fast movement * Water travel * Rain travel * General exploration --- ## 🌊 Travel Mode Appearance The Mjolnir resource pa