BuilderMode
一款 Minecraft 插件,通过可配置的限制条件临时提升玩家的渲染距离,以防止滥用。
? 概述
BuilderMode 允许玩家为了建造和探索而临时增加渲染距离,并内置了防止滥用的安全措施。非常适合建筑服务器、创造世界或任何需要玩家在短时间内获得更好视野的服务器。
✨ 功能特性
核心功能
- 临时渲染距离提升 - 每个维度均可配置持续时间和渲染距离
- 按维度设置 - 主世界、下界和末地拥有不同的渲染距离
- 冷却系统 - 通过可配置的离线持久化冷却时间防止刷屏滥用
- 自动禁用 - 切换维度或登出时自动停用
安全与反作弊
- 周期性安全检查 - 自动重置渲染距离以防止绕过检测
- 维度变化检测 - 手动检查系统以兼容 Folia
- 离线冷却追踪 - 即使玩家离线,冷却时间也会继续计算
- 无绕过漏洞 - 多层防护机制,防止对渲染距离进行恶意操纵
可选限制
管理员功能
- 独立功能开关 - 分别启用或禁用鞘翅和实体限制
- 完全自定义消息 - 所有插件消息均支持颜色代码和占位符
- 详细日志记录 - 可选的详细控制台日志用于调试
- 热重载 - 无需重启服务器即可重新加载配置
- Tab 补全 - 用户友好的命令界面
? 命令
| 命令 |
描述 |
权限 |
/buildermode 或 /bm |
显示可用命令 |
无 |
/buildermode on |
激活 BuilderMode |
无 |
/buildermode off |
手动停用 BuilderMode |
无 |
/buildermode info |
检查活跃时间或冷却状态 |
无 |
/bmr |
重新加载插件配置 |
buildermode.reload |
? 权限
| 权限 |
描述 |
默认值 |
buildermode.reload |
允许重新加载配置 |
OP |
buildermode.* |
授予所有权限 |
OP |
注意: 默认情况下使用 BuilderMode 不需要任何权限——所有玩家均可访问!
⚙️ 配置
点击查看完整 config.yml
# BuilderMode Configuration
# Enable or disable the entire plugin
enabled: true
# Enable verbose logging for debugging and monitoring
verbose: true
# Default render distance to restore after BuilderMode expires
default-render-distance: 8
# How often (in seconds) to check and reset render distance
# This is a safety feature to prevent bypasses
safety-check-interval: 30
# Feature Restrictions
restrictions:
# Prevent players from using elytra while BuilderMode is active
disable-elytra: true
# Prevent players from riding entities while BuilderMode is active
disable-entity-riding: true
# How often (in seconds) to check if players are mounted
# Set to 0 to disable repeating check
mount-check-interval: 5
# Dimension-specific settings
dimensions:
overworld:
render-distance: 18 # Chunks
duration: 1200 # Seconds (20 minutes)
cooldown: 1200 # Seconds (20 minutes)
nether:
render-distance: 12
duration: 900 # 15 minutes
cooldown: 1200
the_end:
render-distance: 18
duration: 900
cooldown: 1200
# Customizable Messages (supports & color codes)
# Placeholders: {time}, {distance}, {duration}
messages:
activated: "&aBuilderMode activated! Render distance set to {distance} chunks for {duration} seconds."
expired: "&eBuilderMode has expired. Render distance restored."
on-cooldown: "&cYou must wait {time} seconds before using BuilderMode again!"
# ... and many more!
关键配置选项
渲染距离设置:
- 为每个维度配置不同的距离
- 为每个维度设置自定义持续时间和冷却时间
- 推荐:12-18 区块以获得最佳性能
限制项:
disable-elytra: true/false - 切换鞘翅禁用
disable-entity-riding: true/false - 切换实体骑乘预防
mount-check-interval: 5 - 检查玩家是否骑乘实体的频率(秒)
安全功能:
safety-check-interval: 30 - 验证渲染距离的频率(秒)
verbose: true/false - 启用详细的控制台日志记录
? 工作原理
- 玩家使用
/buildermode on 激活 BuilderMode
- 如果正在骑乘实体(且启用了限制),玩家将自动下马
- 如果穿着鞘翅(且启用了限制),需要双重确认
- 保存当前的渲染距离
- 当前维度的渲染距离增加到配置的值
- 应用限制(如果启用):
- 经过配置的持续时间后,渲染距离自动重置
- 开始冷却时间(即使玩家登出也会继续)
- 如果玩家切换维度,BuilderMode 将禁用并开始冷却
?️ 安全功能
防绕过保护
- 基于事件的防护 - 通过事件拦截骑乘和鞘翅使用行为
- 定期验证 - 重复任务检测并捕获任何绕过行为
- 维度检查 - 针对 Folia 的手动维度变更检测
- 安全检查 - 定期检查所有玩家的渲染距离
- 离线追踪 - 冷却时间在登出后依然保留
Folia 兼容性
- 自动检测服务器类型(Paper 与 Folia)
- 在 Folia 上使用区域调度器
- 在 Paper 上使用标准 Bukkit 调度器
- 支持区域化线程的安全操作
? 性能
BuilderMode 设计为轻量级:
- 周期性检查带来的 CPU 占用极低
- 高效的事件处理机制
- 智能缓存玩家状态
- 可配置的检查间隔,以平衡安全性与性能
最佳性能推荐设置:
safety-check-interval: 60(1 分钟),适用于小型服务器
safety-check-interval: 30(30 秒),适用于大型服务器
mount-check-interval: 5(5 秒)- 良好的平衡点
BuilderMode
A Minecraft plugin that temporarily boosts player render distance with configurable restrictions to prevent exploits.
? Overview
BuilderMode allows players to temporarily increase their render distance for building and exploring, with built-in safeguards to prevent abuse. Perfect for building servers, creative worlds, or any server where players need better visibility for short periods.
✨ Features
Core Functionality
- Temporary Render Distance Boost - Configurable duration and distance per dimension
- Per-Dimension Settings - Different render distances for Overworld, Nether, and The End
- Cooldown System - Prevents spam with configurable cooldowns that persist offline
- Automatic Disable - Deactivates when changing dimensions or logging out
Security & Anti-Exploit
- Periodic Safety Checks - Automatically resets render distances to prevent bypasses
- Dimension Change Detection - Manual checking system for Folia compatibility
- Offline Cooldown Tracking - Cooldowns continue even when players are offline
- No Bypass Exploits - Multiple layers of protection against render distance manipulation
Optional Restrictions
Admin Features
- Individual Feature Toggles - Enable/disable elytra and entity restrictions separately
- Fully Customizable Messages - All plugin messages support color codes and placeholders
- Verbose Logging - Optional detailed console logging for debugging
- Hot Reload - Reload configuration without restarting the server
- Tab Completion - User-friendly command interface
? Commands
| Command |
Description |
Permission |
/buildermode or /bm |
Show available commands |
None |
/buildermode on |
Activate BuilderMode |
None |
/buildermode off |
Manually deactivate BuilderMode |
None |
/buildermode info |
Check active time or cooldown status |
None |
/bmr |
Reload plugin configuration |
buildermode.reload |
? Permissions
| Permission |
Description |
Default |
buildermode.reload |
Allows reloading the configuration |
OP |
buildermode.* |
Grants all permissions |
OP |
Note: No permission is required to use BuilderMode by default - all players have access!
⚙️ Configuration
Click to view full config.yml
# BuilderMode Configuration
# Enable or disable the entire plugin
enabled: true
# Enable verbose logging for debugging and monitoring
verbose: true
# Default render distance to restore after BuilderMode expires
default-render-distance: 8
# How often (in seconds) to check and reset render distance
# This is a safety feature to prevent bypasses
safety-check-interval: 30
# Feature Restrictions
restrictions:
# Prevent players from using elytra while BuilderMode is active
disable-elytra: true
# Prevent players from riding entities while BuilderMode is active
disable-entity-riding: true
# How often (in seconds) to check if players are mounted
# Set to 0 to disable repeating check
mount-check-interval: 5
# Dimension-specific settings
dimensions:
overworld:
render-distance: 18 # Chunks
duration: 1200 # Seconds (20 minutes)
cooldown: 1200 # Seconds (20 minutes)
nether:
render-distance: 12
duration: 900 # 15 minutes
cooldown: 1200
the_end:
render-distance: 18
duration: 900
cooldown: 1200
# Customizable Messages (supports & color codes)
# Placeholders: {time}, {distance}, {duration}
messages:
activated: "&aBuilderMode activated! Render distance set to {distance} chunks for {duration} seconds."
expired: "&eBuilderMode has expired. Render distance restored."
on-cooldown: "&cYou must wait {time} seconds before using BuilderMode again!"
# ... and many more!
Key Configuration Options
Render Distance Settings:
- Configure different distances for each dimension
- Set custom durations and cooldowns per dimension
- Recommended: 12-18 chunks for best performance
Restrictions:
disable-elytra: true/false - Toggle elytra blocking
disable-entity-riding: true/false - Toggle entity riding prevention
mount-check-interval: 5 - How often to check for mounted players (seconds)
Safety Features:
safety-check-interval: 30 - How often to verify render distances (seconds)
verbose: true/false - Enable detailed console logging
? How It Works
- Player activates BuilderMode with
/buildermode on
- If riding an entity (and restriction enabled), player is dismounted
- If wearing elytra (and restriction enabled), requires double-confirmation
- Current render distance is saved
- Render distance increases to configured value for current dimension
- Restrictions are applied (if enabled):
- Cannot ride any entities/vehicles
- Cannot use or equip elytra
- After configured duration, render distance automatically resets
- Cooldown begins (continues even if player logs out)
- If player changes dimensions, BuilderMode disables and cooldown starts
?️ Security Features
Anti-Bypass Protection
- Event-based prevention - Blocks mounting and elytra usage via events
- Periodic verification - Repeating tasks catch any bypasses
- Dimension checks - Manual dimension change detection for Folia
- Safety checks - Regular verification of all player render distances
- Offline tracking - Cooldowns persist through logouts
Folia Compatibility
- Automatic server type detection (Paper vs Folia)
- Uses region schedulers on Folia
- Uses standard Bukkit scheduler on Paper
- Thread-safe for regionized threading
? Performance
BuilderMode is designed to be lightweight:
- Minimal CPU usage from periodic checks
- Efficient event handling
- Smart caching of player states
- Configurable check intervals to balance security vs performance
Recommended Settings for Best Performance:
safety-check-interval: 60 (1 minute) for small servers
safety-check-interval: 30 (30 seconds) for larger servers
mount-check-interval: 5 (5 seconds) - good balance
评论 0
登录后参与评分
还没有评论,来抢沙发吧