What is EcBlock?
EcBlock is a Minecraft server plugin that adds a sophisticated slot-based restriction system for Ender Chests. Players can only store blocked items (shulker boxes, bundles, etc.) when they have available slots. The plugin combines permission-based base slots with purchasable slots, making it perfect for donation systems and gameplay progression.

Key Features

• Flexible dual-slot system: base slots (from permissions) + purchased slots
• Block specific items: all shulker box colors, all bundle colors, and custom items
• Complete dupe protection: tracks all item movement methods
• PlaceholderAPI integration: 8 placeholders for seamless integration
• Full internationalization: MiniMessage support for colored messages
• Permission-based access control for different player groups
• Real-time slot usage tracking
• Admin commands for slot management

How It Works

1. By default, players CANNOT place blocked items in Ender Chests
2. Admins grant base slots via permission: ecb.slots.X (where X = 0-54)
3. Additional slots can be added via commands (e.g., for donations/in-game currency)
4. Total slots = base slots (from permission) + purchased slots
5. Maximum total limit enforced via config (prevents unlimited purchases)
6. When attempting to place an item without free slots - action is cancelled
7. Slot usage is tracked in real-time and persists across restarts

Commands

/ecb help - Display all available commands /ecb myslots - Show your current slot status (available to all players) /ecb checkslots <player> - Check another player's slots [ADMIN] /ecb setslots <player> <amount> - Set purchased slots for a player [ADMIN] /ecb addslot <player> <amount> - Add slots to a player [ADMIN] /ecb remslot <player> <amount> - Remove slots from a player [ADMIN] /ecb reload - Reload plugin configuration [ADMIN] /ecb resetall confirm - Reset all player data [ADMIN]

Permissions

ecb.* - All plugin permissions (default: op) ecb.admin - Administrative commands (default: op) ecb.slots.X - Base slots from permission (X = 0-54)

Permission Examples (LuckPerms): /lp group vip permission set ecb.slots.10 - VIP gets 10 base slots /lp group premium permission set ecb.slots.20 - Premium gets 20 base slots /lp group admin permission set ecb.admin - Admins can manage slots

PlaceholderAPI Placeholders

%ecblock_used% - Number of currently used slots %ecblock_allowed% - Total allowed slots %ecblock_base% - Base slots (from permission) %ecblock_purchased% - Purchased slots %ecblock_max% - Maximum slot limit from config %ecblock_canbuy% - How many more slots can be purchased %ecblock_atlimit% - Whether limit is reached (true/false) %ecblock_canbuyslots% - Whether slots can be purchased (yes/no)

Configuration

config.yml - Main settings:

• blocked-items: List of blocked materials (SHULKER_BOX, BUNDLE, etc.)
• default-slots: Default slots for new players (default: 0)
• max-total-slots: Maximum total slots allowed (base + purchased, default: 3)
• limits: Optional group-specific limits (for reference)

messages.yml - All plugin messages:

• Fully customizable with MiniMessage formatting
• Color support with tags like <red>, <green>, <aqua>
• Placeholder support in messages
• Separate prefix configuration

playerdata.yml - Player data storage (auto-generated):

• Stores purchased slots per player UUID
• Automatically created and managed
• Safe to reset with /ecb resetall confirm

Requirements

• Minecraft: 1.21+ (Paper or Purpur recommended)
• Java: 21+
• Optional: PlaceholderAPI 2.11.6+ (for placeholder support)

Default Blocked Items

Out of the box, EcBlock blocks:

• All 17 shulker box colors (including undyed)
• All 17 bundle colors (including undyed)
• Easily customizable via config.yml

Thank you for using EcBlock!