A Minecraft plugin offering an infinitely placeable magic block with customizable features for enhan
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.