Examples
Dynamic In-Game Block Management:
- Admin opens the GUI with `/blocklimiter gui`.
- Views current limits:
- Hopper: 16
- Spawner: 4
- Updates the hopper limit to 20 with a single click.
- Adds a new block type (e.g., `smoker`) and sets its limit to 5.
When a Player Places Too Many Blocks:
- Message: `"You cannot place more than 16 hoppers in one chunk!"`
- BossBar: `"Hopper: 16/16"`
VIP Player Limit:
- Standard player: 16 hoppers per chunk.
- VIP player: 32 hoppers per chunk.
Block Limits
Define the maximum number of specific blocks that can be placed in a single chunk.
Code (YAML):
block-limits:
hopper
: 16
# Maximum 16 hoppers per chunk
spawner
: 4
# Maximum 4 spawners per chunk
beacon
: 1
# Maximum 1 beacon per chunk
chest
: 20
# Maximum 20 chests per chunk
furnace
: 10
# Maximum 10 furnaces per chunk
- If a player tries to place a block beyond the limit, the placement is blocked, and they receive a warning.
Customizable Messages
All plugin messages can be customized to match your server’s style.
Code (YAML):
messages:
gui-title
:
"Edit Block Limits"
add-block-gui-title
:
"Add New Block"
block-name
:
"§e{block}"
block-limit
:
"§aLimit: §f{limit}"
edit-instruction
:
"§7Click to edit the limit."
input-new-limit
:
"§aEnter a new limit for the block: {block}"
limit-updated
:
"§aThe limit for {block} has been updated to {limit}."
invalid-number
:
"§cPlease enter a valid number."
limit-reached
:
"§cYou cannot place more than {limit} {block} in one chunk!"
bossbar-title
:
"§e{block}: {current}/{limit}"
command-only-for-players
:
"§cThis command can only be executed by a player!"
no-permission
:
"§cYou do not have permission to execute this command!"
config-reloaded
:
"§aConfiguration has been reloaded!"
command-usage
:
"§eUsage: /blocklimiter <gui|reload>"
add-new-block
:
"§aAdd New Block"
add-new-block-lore
:
"§7Click to add a new block to the limit list."
- `{block}` → Block name
- `{limit}` → Maximum allowed
- `{current}` → How many blocks are placed
- `{percent}` → Percentage of the limit
BossBar Notifications
Enable a dynamic BossBar to track block usage in real-time.
Code (YAML):
bossbar:
enabled
: true
title
:
"&7{block}:&f {current}/{limit} &7({percent}&7)"
color-thresholds:
green
: 0.6
orange
: 0.9
red
: 1.0
percent-colors:
green
:
"&a"
orange
:
"&e"
red
:
"&c"
style
: SEGMENTED_10
display-time
: 5