️ BlockItems ️
Simple and efficient Item Restriction by Groups!
Control exactly what your players can wear or use based on their Rank/Permissions. Perfect for RPG servers, Survival servers with tiers, or simply to block OP items for new players!
Simple and efficient Item Restriction by Groups!
BlockItems is lightweight and works instantly. If a player tries to equip an armor piece or use a tool they are not allowed to use, the plugin will block the action and notify them. Fully compatible from 1.16.x to 1.21.x!
Ready to Use (Default Config)
Out of the box, the plugin comes pre-configured for safety! Without touching a single file, the default group (new players) will be restricted from:
- Diamond Items: Armor, Tools, and Swords.
- Netherite Items: Armor, Tools, and Swords.
- ❌ Equipping: Prevents wearing the armor.
- ❌ Interaction: Prevents using the item (Right-Click).
- ❌ Combat: Prevents attacking entities/players.
- ❌ Mining: Prevents breaking blocks with the tool.
Key Features
️ Group-Based Restrictions Create unlimited custom groups in the config! You can define a vip group that blocks Diamond items, and a default group that blocks Netherite. The possibilities are endless.
⚡ Auto-Unequip System If a player tries to equip a blocked helmet, chestplate, leggings, or boots (via inventory click, right-click, or shift-click), the plugin automatically unequips it and returns it to their inventory (or drops it if full).
Smart Interaction Blocking Blocks players from:
- Attacking entities with blocked weapons.
- Breaking blocks with blocked tools.
- Interacting with the world using blocked items.
Fully Configurable Messages Customize the prefix and all error messages. Supports color codes (&c, &a, etc.).
How it Works
The plugin uses a simple logic:
- Default: If a player has no permissions, they fall under the default section in config.yml.
- Groups: If you give a player the permission blockitems.group.vip, the plugin will check the vip list in the config.
- Bypass: Admins or players with blockitems.bypass can use EVERYTHING.
Commands
- /blockitems reload
- Description: Reloads the config.yml without restarting the server.
- Permission: blockitems.admin
- Description: Reloads the config.yml without restarting the server.
- blockitems.group.<name>
- Description: Assigns a player to a specific restricted group defined in the config (e.g., blockitems.group.vip).
- blockitems.bypass
- Description: Allows the player to bypass ALL restrictions (Default for OPs).
- blockitems.admin
- Description: Allows using the reload command.
# ==============================================================================
# BLOCK ITEMS CONFIGURATION
# ==============================================================================
#
# Main plugin setting to toggle the functionality on/off.
# Set to 'false' to disable all checks without removing the plugin.
enable: true
# ------------------------------------------------------------------------------
# MESSAGES SECTION
# ------------------------------------------------------------------------------
# Customize the chat messages sent to players.
# Color codes using '&' are supported (e.g., &c for red, &a for green).
messages:
# The prefix shown before every plugin message.
prefix: "&8[&cBlockItems&8] &r"
armor-blocked: "&cYou cannot use this armor."
tool-blocked: "&cYou cannot use this tool."
reload: "&aConfiguration reloaded."
no-permission: "&cYou do not have permission."
# ------------------------------------------------------------------------------
# GROUPS CONFIGURATION
# ------------------------------------------------------------------------------
# Define custom groups with specific lists of blocked items.
#
# HOW IT WORKS:
# 1. 'default': This group applies to players who DO NOT have any specific
# group permission.
#
# 2. Custom Groups (e.g., 'vip'): To assign a player to a group, give them
# the permission node: blockitems.group.<groupname>
# Example: blockitems.group.vip
#
# 3. If a player has permissions for multiple groups, items from ALL those
# groups will be blocked for them.
#
# MATERIAL NAMES:
# Use the official Bukkit Material names (uppercase).
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# ------------------------------------------------------------------------------
groups:
# Default group for players without specific permissions.
# Currently blocks all Diamond and Netherite items.
default:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- DIAMOND_SWORD
- DIAMOND_PICKAXE
- DIAMOND_AXE
- DIAMOND_SHOVEL
- DIAMOND_HOE
- NETHERITE_HELMET
- NETHERITE_CHESTPLATE
- NETHERITE_LEGGINGS
- NETHERITE_BOOTS
- NETHERITE_SWORD
- NETHERITE_PICKAXE
- NETHERITE_AXE
- NETHERITE_SHOVEL
- NETHERITE_HOE
# VIP group example.
# Players with 'blockitems.group.vip' will have these items blocked.
# Currently blocks only Diamond items.
vip:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- DIAMOND_SWORD
- DIAMOND_PICKAXE
- DIAMOND_AXE
- DIAMOND_SHOVEL
- DIAMOND_HOE
# You can create more groups...
# BLOCK ITEMS CONFIGURATION
# ==============================================================================
#
# Main plugin setting to toggle the functionality on/off.
# Set to 'false' to disable all checks without removing the plugin.
enable: true
# ------------------------------------------------------------------------------
# MESSAGES SECTION
# ------------------------------------------------------------------------------
# Customize the chat messages sent to players.
# Color codes using '&' are supported (e.g., &c for red, &a for green).
messages:
# The prefix shown before every plugin message.
prefix: "&8[&cBlockItems&8] &r"
armor-blocked: "&cYou cannot use this armor."
tool-blocked: "&cYou cannot use this tool."
reload: "&aConfiguration reloaded."
no-permission: "&cYou do not have permission."
# ------------------------------------------------------------------------------
# GROUPS CONFIGURATION
# ------------------------------------------------------------------------------
# Define custom groups with specific lists of blocked items.
#
# HOW IT WORKS:
# 1. 'default': This group applies to players who DO NOT have any specific
# group permission.
#
# 2. Custom Groups (e.g., 'vip'): To assign a player to a group, give them
# the permission node: blockitems.group.<groupname>
# Example: blockitems.group.vip
#
# 3. If a player has permissions for multiple groups, items from ALL those
# groups will be blocked for them.
#
# MATERIAL NAMES:
# Use the official Bukkit Material names (uppercase).
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# ------------------------------------------------------------------------------
groups:
# Default group for players without specific permissions.
# Currently blocks all Diamond and Netherite items.
default:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- DIAMOND_SWORD
- DIAMOND_PICKAXE
- DIAMOND_AXE
- DIAMOND_SHOVEL
- DIAMOND_HOE
- NETHERITE_HELMET
- NETHERITE_CHESTPLATE
- NETHERITE_LEGGINGS
- NETHERITE_BOOTS
- NETHERITE_SWORD
- NETHERITE_PICKAXE
- NETHERITE_AXE
- NETHERITE_SHOVEL
- NETHERITE_HOE
# VIP group example.
# Players with 'blockitems.group.vip' will have these items blocked.
# Currently blocks only Diamond items.
vip:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- DIAMOND_SWORD
- DIAMOND_PICKAXE
- DIAMOND_AXE
- DIAMOND_SHOVEL
- DIAMOND_HOE
# You can create more groups...
Resource Information
Author:
----------
Total Downloads: 9
First Release: Apr 12, 2026
Last Update: Apr 12, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings