Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
No Netherite +
Have you ever wanted to disable netherite armor on your server but all the plugins aren't really what you are looking for? Well look no more! NoNetherite+ allows you to configure what parts to disable!
Compatibility: Minecraft 26.x (Java 25) or 1.21.x (Java 21) on Paper/Spigot. Optional soft-depend: PlaceholderAPI.
Paper Configuration
The plugin creates plugins/NoNetheritePlus/config.yml (and limits.yml) on first startup. After editing, run /nonetherite reload to apply changes.
# NoNetheritePlus Configuration
# Set to true to disable crafting of netherite items and enable refund system
# Set to false to allow normal crafting
# Netherite Armor
disable_netherite_helmet: true
disable_netherite_chestplate: true
disable_netherite_leggings: true
disable_netherite_boots: true
disable_netherite_horse_armor: true
# Netherite Tools
disable_netherite_sword: false
disable_netherite_pickaxe: false
disable_netherite_axe: false
disable_netherite_shovel: false
disable_netherite_hoe: false
disable_netherite_spear: false
# General Settings
refund_materials: true
refund_message: "&cNetherite crafting is disabled for this item. Your materials have been refunded."
disable_upgrade_templates: false
# When false, netherite armor can still receive smithing-table trims even if crafting that armor is disabled
disable_netherite_trims: false
# Player-facing messages
messages:
blocked_craft: "&cNetherite crafting is disabled for this item. Your materials have been refunded."
blocked_pickup: "&cYou cannot pick up this netherite item."
stripped_on_join: "&cDisabled netherite items were removed from your inventory."
blocked_equip: "&cEquipping this netherite armor is disabled."
# Stronger enforcement (all default off — existing servers stay unchanged)
enforcement:
block_ancient_debris: false
block_scrap_and_ingot_craft: false
block_piglin_barter: false
block_pickup: false
strip_disabled_on_join: false
block_equip_disabled: false
convert_on_strip: false
# Soft possession limit (also mirrored in limits.yml)
limits:
enabled: false
max_netherite_items: 0
# Audit log of blocked actions
audit:
enabled: false
file: audit.log
# Periodic Netherite Purge
# Removes all netherite items from online players on a timer
periodic_purge:
enabled: false
interval_seconds: 60
# Statistics & Analytics
statistics:
enabled: true
track_refunds: true
track_blocked_crafts: true
track_template_removals: true
track_purged_items: true
reset_on_reload: false
log_to_file: false
# Debug Mode
debug:
enabled: false
log_loot_events: false
log_craft_events: false
log_config_changes: true
verbose_messages: false
# World-Specific Configurations
worlds:
world:
world_nether:
world_end:
# If an item is not specified, the global config will be used.
# Configuration Presets (auto-generated)
presets: {}
Netherite Armor
Set to true to block smithing that item and remove its recipe. Set to false to allow normal crafting.
| Option | Default | Description |
|---|---|---|
disable_netherite_helmet |
true |
Block netherite helmet crafting |
disable_netherite_chestplate |
true |
Block netherite chestplate crafting |
disable_netherite_leggings |
true |
Block netherite leggings crafting |
disable_netherite_boots |
true |
Block netherite boots crafting |
disable_netherite_horse_armor |
true |
Block netherite horse armor crafting |
Netherite Tools
Tools are allowed by default. Set to true to disable crafting for that item.
| Option | Default | Description |
|---|---|---|
disable_netherite_sword |
false |
Block netherite sword crafting |
disable_netherite_pickaxe |
false |
Block netherite pickaxe crafting |
disable_netherite_axe |
false |
Block netherite axe crafting |
disable_netherite_shovel |
false |
Block netherite shovel crafting |
disable_netherite_hoe |
false |
Block netherite hoe crafting |
disable_netherite_spear |
false |
Block netherite spear crafting |
General Settings
| Option | Default | Description |
|---|---|---|
refund_materials |
true |
Refund the base item, ingot, and template when a blocked craft is attempted |
refund_message |
(see config) | Legacy refund message (prefer messages.blocked_craft). Supports & color codes |
disable_upgrade_templates |
false |
Remove netherite upgrade smithing templates from generated loot |
disable_netherite_trims |
false |
Block armor trim application on netherite armor |
Messages
| Option | Description |
|---|---|
messages.blocked_craft |
Shown when a smithing upgrade is blocked and refunded |
messages.blocked_pickup |
Shown when pickup is blocked |
messages.stripped_on_join |
Shown when disabled items are stripped on join |
messages.blocked_equip |
Shown when equipping disabled armor is blocked |
Enforcement
All default false so existing servers stay unchanged.
| Option | Description |
|---|---|
enforcement.block_ancient_debris |
Prevent ancient debris drops when mined |
enforcement.block_scrap_and_ingot_craft |
Block scrap smelting and ingot/block crafting |
enforcement.block_piglin_barter |
Strip netherite scrap/ingot/templates from piglin barters |
enforcement.block_pickup |
Cancel picking up restricted netherite items |
enforcement.strip_disabled_on_join |
Remove craft-disabled gear/tools on join |
enforcement.block_equip_disabled |
Cancel equipping craft-disabled netherite armor |
enforcement.convert_on_strip |
Convert stripped gear to diamond equivalents |
Limits (limits.yml)
Soft possession limits are also mirrored under limits: in config.yml.
| Option | Default | Description |
|---|---|---|
limits.enabled |
false |
Enable soft possession limits |
limits.max_netherite_items |
0 |
Max gear/tools in inventory (0 = unlimited) |
Audit
| Option | Default | Description |
|---|---|---|
audit.enabled |
false |
Append blocked actions to an audit file |
audit.file |
audit.log |
File name under the plugin data folder |
Periodic Netherite Purge
Periodically strips all netherite items from every online player's inventory, armor, and offhand.
| Option | Default | Description |
|---|---|---|
periodic_purge.enabled |
false |
Enable or disable the purge timer |
periodic_purge.interval_seconds |
60 |
How often to run the purge, in seconds (minimum 1) |
Removed items include armor, tools, ingots, scrap, blocks, and upgrade templates.
Statistics & Analytics
| Option | Default | Description |
|---|---|---|
statistics.enabled |
true |
Master toggle for statistics tracking |
statistics.track_refunds |
true |
Count material refunds |
statistics.track_blocked_crafts |
true |
Count blocked smithing attempts |
statistics.track_template_removals |
true |
Count templates removed from loot |
statistics.track_purged_items |
true |
Count items removed by periodic purge |
statistics.reset_on_reload |
false |
Reset stats when the config is reloaded |
statistics.log_to_file |
false |
Write stats to statistics.yml after every change |
View stats in-game with /nonetherite stats.
Debug Mode
| Option | Default | Description |
|---|---|---|
debug.enabled |
false |
Enable debug logging |
debug.log_loot_events |
false |
Log template removals from loot |
debug.log_craft_events |
false |
Log blocked crafts and stat updates |
debug.log_config_changes |
true |
Log config reloads and updates |
debug.verbose_messages |
false |
Extra detailed debug output |
Debug can also be toggled in-game with /nonetherite debug <on|off>.
World-Specific Configurations
Override global settings per world. Any setting from the global config can be placed under a world name:
worlds:
world:
disable_netherite_helmet: true
disable_upgrade_templates: false
refund_materials: true
world_nether:
disable_upgrade_templates: true
disable_netherite_sword: true
world_end:
disable_upgrade_templates: true
Unspecified settings fall back to the global config.
Configuration Presets
Presets are saved and loaded via commands (see below). The presets: section in config.yml is managed automatically — do not edit it by hand unless you know what you are doing.
Commands & Permissions
Commands
| Command | Permission | Description |
|---|---|---|
/nonetherite |
nonetherite.info |
Show plugin version and info |
/nonetherite reload |
nonetherite.reload |
Reload config and restart purge timer |
/nonetherite stats |
nonetherite.stats |
View plugin statistics |
/nonetherite debug <on|off> |
nonetherite.debug |
Toggle debug mode |
/nonetherite preset save <name> |
nonetherite.preset |
Save current config as a preset |
/nonetherite preset load <name> |
nonetherite.preset |
Load a saved preset |
/nonetherite preset list |
nonetherite.preset |
List available presets |
/nonetherite preset delete <name> |
nonetherite.preset |
Delete a preset |
/nonetherite inspect [player] |
nonetherite.inspect |
Summarize a player's netherite inventory |
/nonetherite gui |
nonetherite.gui |
Open the config toggle GUI |
/nonetherite audit [lines] |
nonetherite.audit |
Tail the audit log |
Permissions
| Permission | Default | Description |
|---|---|---|
nonetherite.info |
all players | Access to /nonetherite |
nonetherite.bypass |
false | Skip all netherite restrictions |
nonetherite.reload |
op | Reload configuration |
nonetherite.stats |
op | View statistics |
nonetherite.debug |
op | Toggle debug mode |
nonetherite.preset |
op | Manage configuration presets |
nonetherite.inspect |
op | Inspect player inventories |
nonetherite.gui |
op | Open config GUI |
nonetherite.audit |
op | View audit log |
nonetherite.admin |
op | Parent for admin commands |
PlaceholderAPI
Optional soft-depend. Placeholders:
| Placeholder | Description |
|---|---|
%nonetherite_version% |
Plugin version |
%nonetherite_blocked_crafts% |
Total blocked crafts |
%nonetherite_disabled_<item>% |
Whether that item is craft-disabled (helmet, netherite_sword, etc.) |
Paper Installation
- Place the matching
.jar(26.x or 1.21.x) into yourplugins/folder. - Start the server.
- When the server starts, a
NoNetheritePlusfolder will be created withconfig.ymlandlimits.ymlinside. (See above for config.) - After making changes to the config file, run:
/nonetherite reload
to apply changes.
Join the Discord!


