BanItems Modification
This Minecraft Forge addon provides server administrators with powerful tools to regulate game mechanics. The mod allows easy restriction of various item usage while maintaining an enjoyable gaming atmosphere.
What Can This Mod Do?
BanItems is specifically designed for servers and offers a comprehensive approach to content management:
- Two Restriction Levels:
- Soft ban - the item remains in inventory but its functionality is limited (e.g., cannot place blocks or use tools)
- Hard ban - the item is completely removed from the game, players cannot obtain or use it
- Smart Recognition - the system considers additional item characteristics (NBT data), allowing banning specific enchanted sword variants or potions with special names
- Convenient Interface - adding and removing items happens through an intuitive inventory-like menu without the need to edit configuration files
- Management Commands - quick access to all configuration functions through chat
- Data Preservation - all settings are stored in a JSON file and persist after server restarts
Configuration Commands
Using commands requires banitems.admin permissions (default for server operators):
| Command | Function |
|---|---|
/banitem soft |
Opens menu for adding items to soft ban list |
/banitem list soft [page] |
Shows all soft-banned items (page number can be specified) |
/banitem hard |
Window for hard-banning items |
/banitem list hard [page] |
Displays items under complete ban |
/banitem reload |
Reloads configuration without server restart |
/banitem help |
Shows all available commands and explanations |
How to Install?
BanItems works on servers with Minecraft Forge:
- Install appropriate Forge version for your server
- Download current mod file from official page
- Place JAR archive in
mods/folder on server or in local .minecraft/mods/ folder for client - Launch the game - the mod will automatically create necessary configuration files
Settings and Configuration
All ban rules are stored in a clear JSON file:
File location: config/banitems/banitems.json
Example configuration structure:
{
"softBannedItems": [], // Items with limited functionality
"hardBannedItems": [], // Completely banned items
"excluded": [] // Exceptions for certain containers
}Recommendation: For configuration changes, using the in-game menu is safer than manual file editing.
Additional Information
The mod is distributed under MIT license, allowing free use on any servers, code modification, and distribution of modified versions with attribution.
BanItems development follows best practices for Minecraft Forge modding, and its functionality is inspired by popular community solutions.
