ChainmailSieve

ChainmailSieve

ChainmailSieve is a lightweight Paper plugin that gives chainmail helmets a special survival mechanic.

When a player wearing a chainmail helmet is hit on the head by a falling block of sand, red sand, or gravel, the block breaks instantly instead of placing normally. The block drops as an item, the helmet loses durability, and a small impact effect is played using in-game particles and block break sounds.

No client-side mod is required.

Features

- Breaks falling `SAND`, `RED_SAND`, and `GRAVEL` on contact with a chainmail helmet - Drops the broken block as an item instead of placing it in the world - Damages the helmet using normal Minecraft durability behavior - Plays `falling_dust` particles and the matching block break sound - Supports permission-based control through standard Bukkit permission nodes - Works with permission managers such as LuckPerms without requiring a direct dependency

How It Works

If a falling supported block collides with the helmet area of a player wearing a chainmail helmet:

1. The falling block is removed before it can place normally 2. The corresponding block item is dropped 3. The helmet loses durability 4. Visual and sound effects are played at the impact point

Configuration

The plugin creates a `config.yml` file automatically on first startup.

Default config:

```yml enabled: true

debug: enabled: false

durability-cost: 1

supported-materials: - SAND - RED_SAND - GRAVEL

permissions: use: chainmailsieve.use bypass: chainmailsieve.bypass admin: chainmailsieve.admin

effects: particles: enabled: true count: 18 offset: 0.18 extra: 0.0 sound: enabled: true volume: 1.0 pitch: 1.0

messages: reloaded: "&aChainmailSieve config reloaded." no-permission: "&cYou do not have permission to use this command." usage: "&eUsage: /chainmailsieve reload" ```

Config Options

- `enabled`: Enables or disables the entire mechanic - `debug.enabled`: Enables debug logging for troubleshooting - `durability-cost`: How much durability is consumed per impact - `supported-materials`: List of falling block types that can be broken by the helmet - `permissions.*`: Permission nodes used by the plugin - `effects.particles.*`: Controls the `falling_dust` impact effect - `effects.sound.*`: Controls the block break sound effect - `messages.*`: Messages used by the reload command

Commands

- `/chainmailsieve reload` - Alias: `/cms reload`

Reloads the plugin configuration without restarting the server.

Permissions

- `chainmailsieve.use` Allows the mechanic for a player. Default: `true` - `chainmailsieve.bypass` Prevents the mechanic from affecting a player. Default: `false` - `chainmailsieve.admin` Allows use of the reload command. Default: `op`

LuckPerms

ChainmailSieve uses normal Bukkit permission nodes, so it works with LuckPerms out of the box.

Example:

```text /lp user Steve permission set chainmailsieve.use true /lp user Steve permission set chainmailsieve.bypass false ```

Compatibility

- Minecraft: `1.21.11` - Server software: `Paper` - Likely compatible with modern Paper forks such as `Purpur` and `Pufferfish`, but officially developed and tested for Paper - Not designed for `Spigot`, `CraftBukkit`, or `Folia` - Java: `21+`

Installation

1. Download the plugin jar 2. Put it into your server's `plugins` folder 3. Start or restart the server 4. Edit `plugins/ChainmailSieve/config.yml` if needed 5. Use `/chainmailsieve reload` after changing the config

Notes

- The mechanic only works when the player is actually wearing a chainmail helmet - Players with the bypass permission are ignored by the mechanic - If you are using a permission plugin, make sure `chainmailsieve.bypass` is not granted by mistake