️ChunkLimiter ️
适用于现代 Minecraft 服务器的终极、轻量级且高性能的方块/实体放置限制器。
关于 ChunkLimiter
红石装置、刷怪塔、盔甲架或充满潜影盒的区块是否拖垮了您服务器的 TPS?ChunkLimiter 是一款最先进的解决方案,旨在跟踪、控制并限制玩家在单个区块内可以放置的性能消耗型方块和实体的数量。
与旧版未优化的插件不同,ChunkLimiter 专为运行 Paper、Purpur 或 Folia 的现代服务器(Minecraft 1.20+ 至 26.1+)从头构建。它采用非阻塞异步架构,配备专用的工作线程队列,即使在负载沉重的情况下也能保证对服务器刻(TPS)零影响。
✨ 功能特性
多种限制模式:
按玩家限制 (per-player):每位玩家在区块内拥有独立的配额(例如,每个区块每位玩家最多放置 5 个漏斗)。
按区块总量限制 (per-chunk-total):玩家共享区块内的集体限额(例如,一个区块内总共最多 20 个刷怪笼,无论由谁放置)。
智能方块跟踪:针对任何类型的方块提供细粒度的限制(例如 HOPPER、SPAWNER、BEACON、OBSERVER)。
自动分组:在配置中指定 SHULKER_BOX,ChunkLimiter 会自动将其扩展以覆盖所有 16 种染色变体!
️实体放置跟踪:跟踪并限制基于实体的放置,如物品展示框、发光物品展示框、盔甲架和画作。
️基于权限的层级:通过权限节点授予更高的限额以奖励 VIP 或工作人员(例如 chunklimiter.tier.vip)。
双存储后端:
SQLite:简单的零设置本地文件存储(data.db)。
MySQL:用于多服务器设置的高速 HikariCP 连接池数据库后端。
⚡ 对 TPS 友好的异步架构:
所有数据库任务(区块加载、区块卸载、刷新、绕过/覆盖修改)均在单线程后台执行器上顺序管理。
无锁、无延迟、无竞态条件。
Adventure API 集成:利用干净的 MiniMessage/Legacy 格式,在聊天栏、操作栏或标题中提供清晰、现代的反馈消息。
️ 命令与权限
使用命令补全功能即时管理一切!
命令 描述 权限
/chunklimiter bypass <player> <true/false> 授予/撤销玩家的放置限制绕过权限。 chunklimiter.admin
/chunklimiter limit <player> <material> <limit> 设置按玩家的限额覆盖。 chunklimiter.admin
/chunklimiter reset <player> [current_chunk] 重置玩家的放置计数器。 chunklimiter.admin
/chunklimiter info 查看当前区块的计数器和限制。 chunklimiter.admin
/chunklimiter reload 重新加载配置并重启服务。 chunklimiter.admin
⚙️ 配置
在整洁的 config.yml 中自定义限额、消息风格和存储设置:
代码 (文本):
storage:
type: "sqlite" # "sqlite" 或 "mysql"
mysql:
host: "localhost"
port: 3306
database: "chunklimiter"
username: "root"
password: ""
flush-interval-seconds: 60
limits:
mode: "per-chunk-total" # 选项: "per-player", "per-chunk-total"
decrement-on-break: true
override-scope: "global"
受跟踪的方块限额
tracked-blocks:
HOPPER: 10
SPAWNER: 5
BEACON: 2
SHULKER_BOX: 8 # 自动扩展至所有染色变体
受跟踪的实体限额
track-entities: true
tracked-entities:
ARMOR_STAND: 10
ITEM_FRAME: 15
GLOW_ITEM_FRAME: 15
为特定权限节点授予更高限额
permission-tiers:
chunklimiter.tier.vip:
HOPPER: 15
SPAWNER: 8
chunklimiter.tier.mvp:
HOPPER: 20
SPAWNER: 12
messages:
feedback-type: "actionbar" # 选项: "actionbar", "chat", "title", "none"
progress: "<yellow>区块限制: <white>{count}/{limit} 已放置方块 <gray>(剩余 {remaining})"
denied: "<red>您已达到此区块中受跟踪方块的放置限制 ({limit})!"
为何选择 ChunkLimiter?
许多方块限制器存在数据库竞态条件问题,即快速加载和卸载区块会导致玩家的方块计数器重置为零,从而允许他们无限制地放置方块。
ChunkLimiter 通过在后台线程上顺序序列化数据库操作彻底解决了这一问题。此外,它在启用时动态扫描并加载所有预先存在的区块,确保从服务器启动的那一秒起,您的出生点区块和已加载区域都能得到准确统计。
支持与社区
需要帮助配置 ChunkLimiter 或想要报告错误?加入我们的官方支持频道:
加入我的 Discord 社区
Discord 邀请
FastStats:

️ChunkLimiter ️
The ultimate, lightweight, and high-performance block/entity placement limiter for modern Minecraft servers.
About ChunkLimiter
Are redstone contraptions, mob farms, armor stands, or shulker-filled chunks tanking your server’s TPS? ChunkLimiter is a state-of-the-art solution designed to track, control, and limit how many performance-heavy blocks and entities players can place inside a single chunk.
Unlike older, unoptimized plugins, ChunkLimiter is built from the ground up for modern servers running Paper, Purpur, or Folia (Minecraft 1.20+ through 26.1+). It utilizes a non-blocking asynchronous architecture with a dedicated worker thread queue to guarantee zero impact on server ticks (TPS), even under heavy load.
✨ Features
Multiple Limit Modes:
Per Player (per-player): Every player gets their own independent allocation per chunk (e.g., maximum 5 hoppers per player, per chunk).
Per Chunk Total (per-chunk-total): Players share a collective limit in a chunk (e.g., maximum 20 spawners total in a chunk, regardless of who placed them).
Smart Block Tracking: Fine-grained limits for any block type (e.g., HOPPER, SPAWNER, BEACON, OBSERVER).
Automatic Grouping: Specify SHULKER_BOX in the configuration, and ChunkLimiter automatically expands it to cover all 16 colored variants!
️Entity Placement Tracking: Track and limit entity-based placements such as Item Frames, Glow Item Frames, Armor Stands, and Paintings.
️ Permission-Based Tiers: Reward VIPs or staff by granting higher limits via permission nodes (e.g., chunklimiter.tier.vip).
Dual Storage Backends:
SQLite: Simple, zero-setup local file storage (data.db).
MySQL: High-speed, HikariCP-pooled database backend for multi-server setups.
⚡ TPS-Friendly Async Architecture:
All database tasks (chunk load, chunk unload, flush, bypass/override modifications) are managed sequentially on a single-threaded background executor.
No locks, no lag, and no race conditions.
Adventure API Integration: Crisp, modern feedback messages utilizing clean MiniMessage/Legacy formatting in chat, action bars, or titles.
️ Commands & Permissions
Manage everything on the fly with command tab-completion!
Command Description Permission
/chunklimiter bypass <player> <true/false> Grants/revokes placement limits bypass for a player. chunklimiter.admin
/chunklimiter limit <player> <material> <limit> Sets a per-player limit override. chunklimiter.admin
/chunklimiter reset <player> [current_chunk] Resets a player's placement counters. chunklimiter.admin
/chunklimiter info Views the current chunk's counters and limits. chunklimiter.admin
/chunklimiter reload Reloads the configuration and restarts services. chunklimiter.admin
⚙️ Configuration
Customize limits, messaging style, and storage settings inside a clean config.yml:
Code (Text):
storage:
type: "sqlite" # "sqlite" or "mysql"
mysql:
host: "localhost"
port: 3306
database: "chunklimiter"
username: "root"
password: ""
flush-interval-seconds: 60
limits:
mode: "per-chunk-total" # Options: "per-player", "per-chunk-total"
decrement-on-break: true
override-scope: "global"
Tracked block limits
tracked-blocks:
HOPPER: 10
SPAWNER: 5
BEACON: 2
SHULKER_BOX: 8 # Automatically expands to all colored variants
Tracked entity limits
track-entities: true
tracked-entities:
ARMOR_STAND: 10
ITEM_FRAME: 15
GLOW_ITEM_FRAME: 15
Grant higher limits to specific permission nodes
permission-tiers:
chunklimiter.tier.vip:
HOPPER: 15
SPAWNER: 8
chunklimiter.tier.mvp:
HOPPER: 20
SPAWNER: 12
messages:
feedback-type: "actionbar" # Options: "actionbar", "chat", "title", "none"
progress: "<yellow>Chunk limit: <white>{count}/{limit} blocks placed <gray>({remaining} remaining)"
denied: "<red>You've reached the placement limit ({limit}) for tracked blocks in this chunk!"
Why ChunkLimiter?
Many block limiters suffer from database race conditions where rapidly loading and unloading chunks leads to players' block counters resetting back to zero, allowing them to place unlimited blocks.
ChunkLimiter completely resolves this by serializing database operations sequentially on a background thread. Plus, it dynamically scans and loads all pre-existing chunks upon enabling, ensuring your spawn chunks and already-loaded areas are always accurately accounted for from the second the server starts.
Support & Community
Need help configuring ChunkLimiter or want to report a bug? Join our official support channel:
Join my Discord Community
Discord Invite
FastStats:

评论 0
登录后参与评分
还没有评论,来抢沙发吧