BlockLimiter - The Ultimate Anti-Lag Block Management Plugin
Features
-
Anti-Lag Block Limits: Prevent server lag by limiting specific blocks per chunk (e.g., hoppers, beacons, spawners).
-
Dynamic Admin GUI: Modify block limits or add new block types directly in-game via an intuitive GUI.
-
Player Permissions: Different limits for normal players, VIPs, and those with "no limit" permissions.
-
BossBar Notifications: Players are shown real-time block usage in the chunk via BossBar.
-
Fully Customizable: All limits and messages can be configured in the `config.yml` file.
-
BossBar Color Indicators: BossBar dynamically changes color based on block usage levels—green when usage is low, yellow when nearing the limit, and red when approaching or exceeding the limit—providing players with an immediate visual cue. All color thresholds and formats, including percentages, are fully configurable in the config.yml file.
Commands & Permissions
/blocklimiter gui
- Opens the block limit management GUI for admins.
/blocklimiter reload
- Reloads the configuration without restarting the server.
-
blocklimiter.nolimit: Allows placing unlimited blocks.
-
blocklimiter.vip: Allows placing double the normal block limit.
-
blocklimiter.admin: Grants access to all admin commands and GUI.
-
Improve Server Performance: Prevent lag caused by overloading chunks with hoppers, spawners, etc.
-
Dynamic Administration: Modify block limits or add new blocks during gameplay—no file edits or restarts required!
-
Fair Gameplay: Balanced limits for all players, with perks for VIPs.
-
User-Friendly: Simple commands, intuitive GUI, and customizable configuration.
Installation
-
Download the plugin `.jar` file.
-
Place it in your `/plugins` folder.
-
Restart your server to generate the configuration files.
-
Use `/blocklimiter gui` to manage limits in-game.
-
Customize limits and messages in the `config.yml` file.
-
Use `/blocklimiter reload` to apply changes.
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
-
If a player places a monitored block, the BossBar updates in real-time.
-
Colors dynamically change as the limit is approached.