Olympus 服务器优化插件文档

共计 3077 个字符，预计需要花费 8 分钟才能阅读完成。

Olympus就像你服务器的低调小助手。它能清理杂物、管理红石、堆叠物品，还能监控服务器性能。特别适合大型服务器或需要稍加维护以保持流畅的史诗级项目。下面详细介绍一下它的功能和用法！

功能详解 & 配置指南

实体清理
功能：阻止生物、物品和实体过度堆积拖慢服务器。当单个区块内实体过多时，自动禁止新实体生成，或在预警后清理冗余实体。
运作机制：围绕出生点扫描区块。若实体数量达到阈值（通过 cleanup.yml 设置），插件会立即禁止新生成或启动倒计时清理，并向管理员发送警告。
配置方法：编辑 cleanup.yml 文件：
调整全局默认值：

default-max-entities-per-type: 50 # 每类实体上限（默认50）

自定义特定实体上限，例如：

entity-spawn-limits.ZOMBIE: 30 # 僵尸最多生成30只

修改预警倒计时（默认60秒）：

cleanup-countdown: 60s # 清理前等待时间

高级技巧：船只、玩家等受保护实体不会被清理。如需添加其他例外，可查阅插件代码自定义保护名单！

–

2. 物品自动堆叠
功能：自动整理散落物品为整齐堆叠，大幅减少实体卡顿。
运作原理：当物品掉落时，插件会检测周围默认2格半径内的同类物品，自动合并堆叠，并添加悬浮名称提示（如“铁锭 x64”）。
配置方法：编辑 optimization.yml 文件：

item-stacking.radius: 2 # 检测合并半径（单位：格）

自定义悬浮名称格式（支持颜色代码）：

item-stacking.format: “&e%item% x%amount%” # 示例：黄色文本显示物品名和数量

在 lang/ 目录下创建语言文件（如 en_us.yml），可自定义物品显示名称。

高阶技巧：若想保留物品散落的原生态感，可通过以下配置关闭此功能：

item-stacking.enabled: false # 关闭物品堆叠

–

3. 区块优化
功能：自动卸载闲置区块并限制区块内实体数量，确保服务器轻量运行。
运作原理：实时监控已加载区块。若附近无玩家且无活动迹象，将在倒计时后卸载该区块；若实体数量超出限制，则自动触发清理。
配置方法：编辑 optimization.yml 文件：

设置单个区块最大实体数（默认100）：

chunk-limits.max-entities: 100 # 单个区块允许的最大实体总数

调整区块卸载延迟时间（默认600 tick，约30秒）：

chunk-unload-delay: 600 # 单位：游戏刻（20 tick=1秒）

通过开关控制闲置区块卸载功能：

unload-inactive-chunks: true # true=启用自动卸载

高阶技巧：若无需频繁扫描，可调大 chunk-optimization-interval（默认1200 tick，约1分钟），降低性能消耗：

chunk-optimization-interval: 1200 # 优化任务执行间隔（单位：tick）

–

4. TPS 实时监控
功能：持续追踪服务器 TPS（每秒运算次数）。当 TPS 过低时，自动通知管理员并触发性能优化清理。
运作原理：每 30 秒检测一次 TPS。若数值跌破阈值（默认 16），立即向管理员发送警报，并自动执行区块与实体清理任务。

配置方法：

调整触发阈值（optimization.yml）：

tps.threshold: 16 # TPS 告警阈值（默认16，20为满值）

自定义告警信息（messages.yml）：

tps-alert: “&c警告：TPS 降至 %tps%！” # %tps% 会被实际数值替换

高阶技巧：若服务器性能敏感（如大型红石机器），可将阈值设为 18 以更早触发优化：

tps.threshold: 18 # 更严格卡顿控制（TPS≤18即触发）

–

5. 红石优化管理
功能：智能监控区块内的红石装置，当附近无玩家时自动暂停运行，显著降低资源消耗。
运作原理：实时追踪活塞、中继器、红石线等元件。若红石活跃度低于阈值且范围内无玩家，插件将冻结红石电路；当玩家重新进入区域时立即恢复运作。
配置方法：编辑 optimization.yml 文件：

设置红石检测频率（默认200 tick，约10秒）：

redstone.check-interval: 200 # 检测间隔（单位：游戏刻）

定义红石活跃度阈值（默认5次变化/周期）：

redstone.activity-threshold: 5 # 低于此值判定为”低活跃”

调整玩家检测范围（默认2个区块）：

redstone.player-detection-range: 2 # 单位：区块（1区块=16×16格）

高阶技巧：开启调试模式可实时查看红石控制日志（控制台输入）：

redstone.debug: true # 显示冻结/恢复操作的详细日志

–

深度探索：红石扫描器
功能：大范围扫描活跃红石装置，堪称排查卡顿红石设备的终极利器，助你快速定位问题建筑。
运作原理：玩家输入指令 /olympus scanredstoner，插件将以你为中心扫描半径180格（约11个区块）内的所有激活态红石元件（线路、活塞等），并返回活跃区块坐标、元件总数及具体位置。
核心特性：

自动扫描全服在线玩家（每人60秒冷却），服务器负载近乎零
结果通过简洁摘要直接发送给请求者
扫描范围覆盖红石线、活塞等全部可激活元件
配置方法：
无需额外配置，但可在 messages.yml 中自定义扫描提示，例如：

redstone-scan-result: “&a发现 %active% 处活跃红石！” 

在 config.yml 中禁用此功能：

features.redstone-scanner: false # 关闭红石扫描器 

示例输出：

红石扫描结果：共检测到50个元件，3处活跃区块位于 (x,z)。坐标详情：(100,64,200)

–

配置文件 – 佛系管理工具箱
Olympus 会在服务器 plugins/ 目录生成以下配置，轻松掌控全局：

config.yml：功能总开关（如 features.cleanup: true 开启实体清理）。
cleanup.yml：实体数量限制、清理频率与倒计时设置。
optimization.yml：红石控制、区块优化、物品堆叠、TPS监控等核心参数。
messages.yml：自定义游戏内提示与控制台消息（支持 & 颜色代码，如 &a绿色文字）。
lang/ 语言目录：
放置 .yml 文件（如 zh_cn.yml）可自定义物品堆叠名称。
重要：该目录仅允许存在一个语言文件。若已有文件，需删除旧文件再替换重启生效。
未提供语言文件时，默认使用 en_us.yml。
️ 指令大全

/olympus scanredstoner
玩家指令，扫描周围180格内活跃红石。无需权限，在线即可执行。
/olympus chunk
管理员/控制台指令，查看各世界已加载/未加载区块状态统计。
终极佛系指南

先躺平后微调：先用默认配置找感觉，再按需微调。
控制台监控术：控制台日志无颜色渲染，重要动态盯这里更稳。
防手滑清理：若插件清理太积极，可拉长检测间隔或调高实体上限。

记住，这只是个帮你控场的工具，服务器节奏由你定义！

文档原文链接