TurboClean ⚡
适用于 Minecraft Paper 服务器的超高性能优化插件
? 功能特性
⚡ 闪电般的性能
- 即时清理 - 操作在毫秒级内完成
- 极致轻量 - 资源占用极低
- 异步处理 - 非阻塞操作,线程安全
- 智能缓存 - 优化的数据访问
- 2倍性能提升 - 显著提升服务器速度
- 网络优化 - 减少数据包泛滥和网络延迟
? 超智能清理系统
- 实体管理 - 移除导致卡顿的实体(物品、箭矢、经验球、TNT、烟花、矿车、船、盔甲架)
- 内存优化 - 自动垃圾回收和 RAM 管理
- 区块优化 - 卸载未使用的区块以节省内存
- CPU 优化 - 限制 AI 处理并优化红石/漏斗逻辑
- 怪物清理 - 移除过多的导致卡顿的生物
- 网络清理 - 批量移除实体以减少网络负载
⚙️ 灵活配置
- 基于命令的设置 -
/turboclean settings <setting> <value>
- YAML 配置文件 - 编辑
config.yml 进行详细自定义
- 热重载 - 无需重启服务器即可更新设置
- 验证机制 - 自动配置验证与修正
- 智能默认值 - 针对所有规模的服务器进行了优化(1.20+)
? 高级监控
- 实时 TPS 监控 - 跟踪服务器性能
- 内存使用警报 - 在高内存使用时收到通知
- 性能阈值 - 需要时自动执行清理
- 可视化统计面板 - 显示 RAM、CPU、磁盘、网络的 ASCII 图表
- 历史数据追踪 - 查看随时间变化的性能趋势
? 智能自动化
- 自动清理间隔 - 可配置的清理计划
- 紧急清理 - 性能下降时自动清理
- 感知玩家 - 保留玩家附近的实体,移除远处的实体
- 命名实体保护 - 排除命名实体不被清理
? 要求
- Minecraft 版本: 1.20+ (Paper/Purpur/Folia) - 完全支持
- Java 版本: 17 或更高(支持 Java 21)
- 服务器软件: Paper MC(或其分支如 Purpur, Folia)
- 兼容性: 适用于所有类型的服务器(低端、中端、高端)
? 安装
- 从 Releases 下载最新的
TurboClean.jar
- 将 jar 文件放入服务器的
plugins 文件夹
- 重启服务器
- 在
plugins/TurboClean/config.yml 中配置插件
- 使用
/turboclean reload 应用更改
? 命令
| 命令 |
描述 |
权限 |
/turboclean clean |
执行完整清理 |
turboclean.use |
/turboclean quick |
快速实体清理 |
turboclean.use |
/turboclean network |
网络优化清理 |
turboclean.use |
/turboclean stats |
显示带有图表的性能统计 |
turboclean.use |
/turboclean reload |
重新加载配置 |
turboclean.admin |
/turboclean settings <setting> <value> |
更新设置 |
turboclean.admin |
命令示例
# 执行完整清理
/turboclean clean
# 快速清理以获得即时性能提升
/turboclean quick
# 网络优化清理(减少由数据包引起的卡顿)
/turboclean network
# 使用酷炫的 ASCII 图表检查服务器性能
/turboclean stats
# 将清理间隔更新为 2 分钟(平衡模式)
/turboclean settings auto-cleanup.interval 120
# 启用智能实体清理
/turboclean settings entities.enabled true
/turboclean settings entities.player-distance 32
?️ 权限
| 权限 |
描述 |
默认值 |
turboclean.* |
所有权限 |
OP |
turboclean.use |
基本使用 |
OP |
turboclean.admin |
管理员命令 |
OP |
turboclean.notify |
接收通知 |
OP |
⚙️ 配置
通过命令快速设置
# 你可以通过命令更改的基本设置:
/turboclean settings auto-cleanup.enabled true
/turboclean settings auto-cleanup.interval 60
/turboclean settings entities.enabled true
/turboclean settings memory.enabled true
/turboclean settings monitoring.enabled true
配置文件 (config.yml)
点击查看完整配置
# TurboClean 配置
general:
enabled: true
debug: false
auto-cleanup:
enabled: true
interval: 120 # 2 分钟,平衡性能
cleanup-on-start: true
cleanup-on-save: true
entities:
enabled: true
max-per-chunk: 20 # 智能限制
cleanup-types:
- "DROPPED_ITEM"
- "ARROW"
- "EXPERIENCE_ORB"
- "PRIMED_TNT"
- "FIREWORK"
- "ITEM_FRAME"
- "ARMOR_STAND"
- "MINECART"
- "BOAT"
- "FALLING_BLOCK"
exclude-named: true
player-distance: 32 # 优化距离
memory:
enabled: true
force-gc: true
gc-interval: 300
cleanup-threshold: 70 # 智能阈值
clear-unused-chunks: true
# 网络优化以减少卡顿
advanced:
network-optimization:
batch-packets: true
batch-size: 50
batch-delay: 1
monitoring:
enabled: true
tps-alert-threshold: 18.0
memory-alert-threshold: 90
? 性能影响
使用 TurboClean 之前
- ❌ 200+ 个实体导致卡顿
- ❌ 90%+ 的内存使用率
- ❌ 高峰时段 15-17 TPS
- ❌ 频繁的卡顿波动
使用 TurboClean 之后
- ✅ 实体数量控制在合理范围
- ✅ 60-70% 的内存使用率
- ✅ 稳定的 19-20 TPS
- ✅ 流畅的游戏体验
? 高级功能
智能实体管理
- 基于距离清理 - 仅移除远离玩家的实体
- 按类型过滤 - 精确选择要清理的实体类型
- 保留 NBT 数据 - 保留具有自定义数据的实体
- 区块限制 - 防止每个区块内实体过载
内存优化
- 智能垃圾回收 - 智能的垃圾回收时机
- 区块管理 - 自动卸载未使用的区块
- 内存监控 - 实时使用量跟踪
- 紧急清理 - 在高内存使用时自动清理
CPU 优化
- AI 限制 - 减少实体 AI 处理负载
- 红石优化 - 优化红石计算
- 漏斗优化 - 提升漏斗性能
- 异步处理 - 非阻塞操作
? 监控与警报
TurboClean 提供全面的监控功能:
- TPS 监控 - 实时服务器刻率跟踪
- 内存警报 - 当内存使用过高时发送通知
- 性能阈值 - 根据性能自动执行操作
- 可视化仪表盘 - 酷炫的 ASCII 图表和图形
- 历史趋势 - 显示随时间变化的性能迷你图(Sparkline)
? 酷炫视觉统计仪表盘
运行 /turboclean stats 查看精美的 ASCII 仪表盘:
╭─────────────────────────────────────────╮
│ TURBOCLEAN STATS │
├─────────────────────────────────────────┤
│ RAM Usage: │
│ ████████████████████░ 85% (3.2GB/4GB) │
│ Trend: ▁▂▃▄▅▆▇█▇▆▅▄▃▂▁ (15min history) │
├─────────────────────────────────────────┤
│ CPU & Performance: │
│ ██████████████░░░░░░ 70% CPU Usage │
│ 19.8 TPS (1,247 entities) │
│ TPS Trend: ▇▇▆▅▄▅▆▇▇█ │
├─────────────────────────────────────────┤
│ Disk Storage: │
│ ████████████░░░░░░░░ 60% (120GB/200GB) │
├─────────────────────────────────────────┤
│ Network Status: │
│ ████████████████████ 100% Optimal │
│ Packets: Optimized • Lag: Minimal │
├─────────────────────────────────────────┤
│ Overall Status: EXCELLENT │
╰─────────────────────────────────────────╯
- 彩色进度条 - 根据使用情况显示绿色/黄色/橙色/红色
- 实时数据 - 实时显示 RAM、CPU、磁盘和网络状态
- 迷你图表 - 显示趋势的 Sparkline 图表
- 性能建议 - 在需要时自动提供建议
? 使用场景
低配服务器(RAM/CPU 受限)
- 将清理间隔设置为 60-90 秒
- 启用网络优化清理
- 使用 60-70% 的内存阈值
- 启用所有优化项
- 定期使用
/turboclean network 命令
高配服务器(专用硬件)
- 将清理间隔设置为 120-180 秒
- 启用带监控的标准清理
- 使用 75-85% 的内存阈值
- 专注于实体管理
- 使用
/turboclean clean 进行综合清理
中配服务器(VPS/共享主机)
- 将清理间隔设置为 90-120 秒
- 在网络清理和快速清理之间取得平衡
- 使用 70-80% 的内存阈值
- 启用智能监控
- 使用
/turboclean quick 进行常规维护
? 故障排除
内存使用过高
- 将
memory.cleanup-threshold 降低至 70-80
- 将
auto-cleanup.interval 减少至 180 秒
- 启用
memory.clear-unused-chunks
- 检查
entities.max-per-chunk 设置
TPS 过低
- 定期启用
turboclean quick 命令
- 将
entities.player-distance 降低至 32-48
- 增加清理频率
- 启用 CPU 优化
插件无法工作
- 检查控制台是否有错误
- 验证是否为 Paper/Purpur 服务器(而非 Spigot)
- 确保已安装 Java 17 或更高版本
- 检查权限设置是否正确
命令无响应
- 使用
/turboclean settings 而不是 /turboclean:settings
- 确保拥有正确的权限
- 通过
/plugins 检查插件是否加载正确
- 必要时重启服务器
线程安全错误
- 插件现在在主线程上运行所有清理操作
- 不再出现 "Chunk getEntities call" 异步错误
- 所有操作均具备线程安全性
- 提升了稳定性和性能
? 支持
? 许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 支持该项目
如果 TurboClean 帮助您的服务器平稳运行,请考虑:
- ⭐ 在 GitHub 上给项目加星
- ? 在 Modrinth 上留下评论
- ? 与其他服务器所有者分享
- ? 支持开发工作
为 Minecraft 社区 ❤️ 制作
TurboClean - 因为性能至关重要!
TurboClean ⚡
Ultra-fast performance optimization plugin for Minecraft Paper servers
? Features
⚡ Lightning-Fast Performance
- Instant cleanup - Operations complete in milliseconds
- Ultra-lightweight - Minimal resource usage
- Async processing - Non-blocking operations with thread safety
- Smart caching - Optimized data access
- 2x Performance Boost - Dramatically improves server speed
- Network optimization - Reduces packet spam and network lag
? Ultra-Smart Cleanup System
- Entity management - Remove lag-causing entities (items, arrows, experience orbs, TNT, fireworks, minecarts, boats, armor stands)
- Memory optimization - Automatic garbage collection and RAM management
- Chunk optimization - Unload unused chunks to save memory
- CPU optimization - Limit AI processing and optimize redstone/hoppers
- Monster cleanup - Remove excessive mobs that cause lag
- Network cleanup - Batched entity removal to reduce network load
⚙️ Flexible Configuration
- Command-based settings -
/turboclean settings <setting> <value>
- YAML configuration - Edit
config.yml for detailed customization
- Live reload - Update settings without server restart
- Validation - Automatic config validation and correction
- Smart defaults - Optimized for all server sizes (1.20+)
? Advanced Monitoring
- Real-time TPS monitoring - Track server performance
- Memory usage alerts - Get notified of high memory usage
- Performance thresholds - Automatic cleanup when needed
- Visual stats dashboard - ASCII graphs showing RAM, CPU, Disk, Network
- Historical data tracking - See performance trends over time
? Smart Automation
- Auto-cleanup intervals - Configurable cleanup schedules
- Emergency cleanup - Automatic cleanup during performance drops
- Player-aware - Keep entities near players, remove distant ones
- Named entity protection - Exclude named entities from cleanup
? Requirements
- Minecraft Version: 1.20+ (Paper/Purpur/Folia) - FULLY SUPPORTED
- Java Version: 17 or higher (supports Java 21)
- Server Software: Paper MC (or forks like Purpur, Folia)
- Compatibility: Works on all server types (low-end, medium-end, high-end)
? Installation
- Download the latest
TurboClean.jar from Releases
- Place the jar file in your server's
plugins folder
- Restart your server
- Configure the plugin in
plugins/TurboClean/config.yml
- Use
/turboclean reload to apply changes
? Commands
| Command |
Description |
Permission |
/turboclean clean |
Perform full cleanup |
turboclean.use |
/turboclean quick |
Quick entity cleanup |
turboclean.use |
/turboclean network |
Network-optimized cleanup |
turboclean.use |
/turboclean stats |
Show performance stats with graphs |
turboclean.use |
/turboclean reload |
Reload configuration |
turboclean.admin |
/turboclean settings <setting> <value> |
Update settings |
turboclean.admin |
Command Examples
# Perform a full cleanup
/turboclean clean
# Quick cleanup for immediate performance boost
/turboclean quick
# Network-optimized cleanup (reduces lag from packets)
/turboclean network
# Check server performance with cool ASCII graphs
/turboclean stats
# Update cleanup interval to 2 minutes (balanced)
/turboclean settings auto-cleanup.interval 120
# Enable smart entity cleanup
/turboclean settings entities.enabled true
/turboclean settings entities.player-distance 32
?️ Permissions
| Permission |
Description |
Default |
turboclean.* |
All permissions |
OP |
turboclean.use |
Basic usage |
OP |
turboclean.admin |
Admin commands |
OP |
turboclean.notify |
Receive notifications |
OP |
⚙️ Configuration
Quick Settings via Commands
# Essential settings you can change via commands:
/turboclean settings auto-cleanup.enabled true
/turboclean settings auto-cleanup.interval 60
/turboclean settings entities.enabled true
/turboclean settings memory.enabled true
/turboclean settings monitoring.enabled true
Configuration File (config.yml)
Click to view full configuration
# TurboClean Configuration
general:
enabled: true
debug: false
auto-cleanup:
enabled: true
interval: 120 # 2 minutes for balanced performance
cleanup-on-start: true
cleanup-on-save: true
entities:
enabled: true
max-per-chunk: 20 # Smart limit
cleanup-types:
- "DROPPED_ITEM"
- "ARROW"
- "EXPERIENCE_ORB"
- "PRIMED_TNT"
- "FIREWORK"
- "ITEM_FRAME"
- "ARMOR_STAND"
- "MINECART"
- "BOAT"
- "FALLING_BLOCK"
exclude-named: true
player-distance: 32 # Optimized distance
memory:
enabled: true
force-gc: true
gc-interval: 300
cleanup-threshold: 70 # Smart threshold
clear-unused-chunks: true
# Network optimization for reduced lag
advanced:
network-optimization:
batch-packets: true
batch-size: 50
batch-delay: 1
monitoring:
enabled: true
tps-alert-threshold: 18.0
memory-alert-threshold: 90
? Performance Impact
Before TurboClean
- ❌ 200+ entities causing lag
- ❌ 90%+ memory usage
- ❌ 15-17 TPS during peak hours
- ❌ Frequent lag spikes
After TurboClean
- ✅ Entities kept under control
- ✅ 60-70% memory usage
- ✅ Stable 19-20 TPS
- ✅ Smooth gameplay experience
? Advanced Features
Smart Entity Management
- Distance-based cleanup - Only removes entities far from players
- Type-specific filtering - Choose exactly which entities to clean
- NBT preservation - Keeps entities with custom data
- Chunk-based limits - Prevent entity overload per chunk
Memory Optimization
- Intelligent GC - Smart garbage collection timing
- Chunk management - Automatic unused chunk unloading
- Memory monitoring - Real-time usage tracking
- Emergency cleanup - Automatic cleanup at high memory usage
CPU Optimization
- AI limiting - Reduce entity AI processing load
- Redstone optimization - Optimize redstone calculations
- Hopper optimization - Improve hopper performance
- Async processing - Non-blocking operations
? Monitoring & Alerts
TurboClean provides comprehensive monitoring:
- TPS Monitoring - Real-time server tick rate tracking
- Memory Alerts - Notifications when memory usage is high
- Performance Thresholds - Automatic actions based on performance
- Visual Dashboard - Cool ASCII graphs and charts
- Historical Trends - Sparkline graphs showing performance over time
? Cool Visual Stats Dashboard
Run /turboclean stats to see a beautiful ASCII dashboard with:
╭─────────────────────────────────────────╮
│ TURBOCLEAN STATS │
├─────────────────────────────────────────┤
│ RAM Usage: │
│ ████████████████████░ 85% (3.2GB/4GB) │
│ Trend: ▁▂▃▄▅▆▇█▇▆▅▄▃▂▁ (15min history) │
├─────────────────────────────────────────┤
│ CPU & Performance: │
│ ██████████████░░░░░░ 70% CPU Usage │
│ 19.8 TPS (1,247 entities) │
│ TPS Trend: ▇▇▆▅▄▅▆▇▇█ │
├─────────────────────────────────────────┤
│ Disk Storage: │
│ ████████████░░░░░░░░ 60% (120GB/200GB) │
├─────────────────────────────────────────┤
│ Network Status: │
│ ████████████████████ 100% Optimal │
│ Packets: Optimized • Lag: Minimal │
├─────────────────────────────────────────┤
│ Overall Status: EXCELLENT │
╰─────────────────────────────────────────╯
- Colorized bars - Green/Yellow/Orange/Red based on usage
- Real-time data - Live RAM, CPU, Disk, and Network status
- Mini graphs - Sparkline charts showing trends
- Performance tips - Automatic suggestions when needed
? Use Cases
Low-End Servers (Limited RAM/CPU)
- Set cleanup interval to 60-90 seconds
- Enable network-optimized cleanup
- Use memory threshold of 60-70%
- Enable all optimizations
- Use
/turboclean network command regularly
High-End Servers (Dedicated Hardware)
- Set cleanup interval to 120-180 seconds
- Enable standard cleanup with monitoring
- Use memory threshold of 75-85%
- Focus on entity management
- Use
/turboclean clean for comprehensive cleanup
Medium-End Servers (VPS/Shared)
- Set cleanup interval to 90-120 seconds
- Balance between network and quick cleanup
- Use memory threshold of 70-80%
- Enable smart monitoring
- Use
/turboclean quick for regular maintenance
? Troubleshooting
High Memory Usage
- Lower
memory.cleanup-threshold to 70-80
- Reduce
auto-cleanup.interval to 180 seconds
- Enable
memory.clear-unused-chunks
- Check
entities.max-per-chunk setting
Low TPS
- Enable
turboclean quick command regularly
- Lower
entities.player-distance to 32-48
- Increase cleanup frequency
- Enable CPU optimizations
Plugin Not Working
- Check console for errors
- Verify Paper/Purpur server (not Spigot)
- Ensure Java 17+ is installed
- Check permissions are set correctly
Commands Not Responding
- Use
/turboclean settings instead of /turboclean:settings
- Make sure you have proper permissions
- Check if plugin loaded correctly with
/plugins
- Restart server if needed
Thread Safety Errors
- Plugin now runs all cleanup on main thread
- No more "Chunk getEntities call" async errors
- All operations are thread-safe
- Improved stability and performance
? Support
? License
This project is licensed under the MIT License - see the LICENSE file for details.
? Support the Project
If TurboClean helps your server run smoothly, consider:
- ⭐ Starring the project on GitHub
- ? Leaving a review on Modrinth
- ? Sharing with other server owners
- ? Supporting development
Made with ❤️ for the Minecraft community
TurboClean - Because performance matters!
评论 0
登录后参与评分
还没有评论,来抢沙发吧