MagicBlock

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<player>[times] - Give a magic block to a player
• /mb getfood<food>[times] - Get magic food
• /mb settimes<times> - Set uses for held magic block
• /mb addtimes<times> - 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<player>[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<times>
• magicblock.addtimes
• Allows adding magic block uses
• Default: OP only
• Command:/mb addtimes<times>

Feature Permissions

• magicblock.food
• Allows using magic food
• Default: All players
• Command:/mb getfood<food>[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.

Read the full description on Hangar →