EcBLOCK

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

• NEW! In-game slot shop with GUI: Players can purchase additional slots through an interactive menu
• NEW! CoinsEngine integration: Automatic balance checking and transaction processing
• NEW! Beautiful GUI system: Two-stage confirmation menu with visual feedback
• NEW! Safe transaction system: Double balance verification to prevent payment errors
• NEW! Sound effects: Audio feedback for successful purchases and errors
• NEW! Comprehensive slot information display: Shows base slots, purchased slots, and available purchase options
• 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. NEW! Players can purchase additional slots using /buyslots command (requires CoinsEngine)
4. Additional slots can also be added by admins via commands (e.g., for donations)
5. Total slots = base slots (from permission) + purchased slots
6. Maximum total limit enforced via config (prevents unlimited purchases)
7. When attempting to place an item without free slots - action is cancelled
8. 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)
• NEW! /buyslots - Open the slot purchase GUI (available to all players, requires CoinsEngine)
• /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)
• NEW! Optional: CoinsEngine (for in-game slot purchases via /buyslots)

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

NEW! Slot Purchase System
The plugin now includes a complete in-game shop system:

1. Interactive GUI: Players use /buyslots to open a beautiful menu
2. Real-time balance checking: Automatically verifies player has enough coins
3. Two-stage confirmation: Prevents accidental purchases
4. Safe transactions: Double verification ensures no coins are lost
5. Visual feedback: Custom items, colors, and sound effects
6. Smart limits: Prevents purchasing beyond max-total-slots
7. Detailed information: Shows base slots, purchased slots, and remaining capacity

Default slot price: 250 coins (configurable in future updates)

Thank you for using EcBlock!