## **MagicBlock Plugin** MagicBlock is a feature-rich Minecraft plugin that enables players to use magic blocks and magic food items with limited usage counts. These special items can be bound to specific players and managed through an intuitive GUI interface. ### **Features** * Magic Block System * Configurable usage counts for blocks * Block binding system * Intuitive GUI interface * Block search functionality * Magic Food System * Reusable food items * Custom food effects * Multi-language Support * English (en) * Simplified Chinese (zh_CN) * PlaceholderAPI Support * Detailed Usage Statistics * Permission System ### **Requirements** * Minecraft Server Version: 1.19+ * Optional Dependency: PlaceholderAPI ### **Commands** Main Command: * /magicblock or/mb - Main plugin command Subcommands: * /mb help - Show help information * /mbget[times] - Get a magic block (use -1 for infinite uses) * /mb give[times] - Give a magic block to a player * /mb getfood[times] - Get magic food * /mb settimes - Set uses for held magic block * /mb addtimes - Add uses to held magic block * /mb list - View bound blocks * /mb reload - Reload plugin configuration ### **Permissions** **Administrator Permission** * magicblock.admin * Includes all permissions * Default: OP only * Includes sub-permissions: * magicblock.use * magicblock.give * magicblock.reload * magicblock.settimes * magicblock.addtimes * magicblock.food **Basic Permissions** * magicblock.use * Allows basic magic block functionality * Default: All players * Command:/mbget **Management Permissions** * magicblock.give * Allows giving magic blocks to others * Default: OP only * Command:/mb give[times] * magicblock.reload * Allows reloading plugin configuration * Default: OP only * Command:/mb reload * magicblock.settimes * Allows setting magic block uses * Default: OP only * Command:/mb settimes * magicblock.addtimes * Allows adding magic block uses * Default: OP only * Command:/mb addtimes **Feature Permissions** * magicblock.food * Allows using magic food * Default: All players * Command:/mb getfood[times] * magicblock.list * Allows viewing bound block list * Default: All players * Command:/mb list **Special Block Permissions** * magicblock.vip - Allows using VIP-exclusive blocks * magicblock.mvp - Allows using MVP-exclusive blocks ### **Basic Usage** **Magic Block Usage** * Get magic block: Use/mbget command * Bind block: Sneak + Right-click * Place block: Place normally * Change block type: Sneak + Left-click to open GUI * View bound blocks: Use/mb list command **GUI Operations** * Left-click: Select block type * Search button: Search for specific blocks * Page buttons: Browse more block options **Bound List Operations** * Left-click: Retrieve bound block * Double right-click: Hide block from list (doesn't unbind) ### **Configuration Files** **config.yml Main Settings** # * Debug mode * debug-mode: false # * Language setting # * language: "en" Options: "en" or "zh_CN" # * Default usage count * default-block-times: 1000000000 # * Blacklisted worlds * blacklisted-worlds: * - world_nether * - world_the_end **foodconf.yml Food Configuration** # * Food configuration example * foods: * GOLDEN_APPLE: * heal: 4 * saturation: 9.6 * effects: * REGENERATION: * duration: 100 * amplifier: 1 ### **Usage Examples** * Basic player permissions: * permissions: * - magicblock.use * - magicblock.food * - magicblock.list * VIP player permissions: * permissions: * - magicblock.use * - magicblock.food * - magicblock.list * - magicblock.vip * Administrator permissions: * permissions: * - magicblock.admin ### **PlaceholderAPI Variables** Supported variables: * %magicblock_block_uses% - Total magic block uses * %magicblock_food_uses% - Total magic food uses * %magicblock_remaining_uses% - Remaining uses of held magic block * %magicblock_has_block% - Whether player has magic block * %magicblock_has_food% - Whether player has magic food * %magicblock_max_uses% - Maximum uses of held magic block * %magicblock_uses_progress% - Usage progress (percentage) ### **Customization** **Item Group Permissions** Configure available block types for different permission groups: * group: * vip-material: * - DIAMOND_BLOCK * - EMERALD_BLOCK * mvp-material: * - BEACON * - DRAGON_EGG **Statistics** * Plugin automatically records magic block and food usage * Supports displaying statistics via PlaceholderAPI ### **Important Notes** * Magic blocks disappear when uses are depleted * Bound blocks can only be used/broken by the binding player * Blocks cannot be used in blacklisted worlds * Blocks are unaffected by pistons * Explosions don't destroy magic blocks * Binding system requires no extra permissions beyondmagicblock.use * Infinite use blocks requiremagicblock.give ormagicblock.settimes * VIP/MVP blocks need configured block lists ### **Troubleshooting** Common issues: * Cannot use commands: Check permission nodes * Cannot place blocks: Check blacklisted worlds * GUI won't open: Verify holding magic block * Cannot bind block: Check if already bound ### **License** Modified MIT License: * Free Use * Use on any server * Modify source code * Distribute modified versions * Restrictions * No commercial use * No selling plugin/modifications * Must retain original author information * Disclaimer * Provided "as is" without warranty * Author not liable for any damages ### **Support** For issues or suggestions: * GitHub Issues (Include reproducible steps for bugs) * QQ Group: [134484522] ### **Changelog** v3.0 * Enhanced multilingual support * Optimized GUI display * Improved block binding * Code cleanup * Performance improvements * Complete restructure * Many more changes... * Note: Backup config before updating from 2.X © 2024 MagicBlock. All Rights Reserved. ## **Donate** [WeSif正在创作奇奇怪怪的各类工具 | 爱发电 (afdian.net)](https://afdian.net/a/sunfun)

MagicBlock

3.0.2