FarmControl - 农场管理

FarmControl 是一款用于管理服务器上生物农场（如动物养殖场、村民繁殖场）的插件，它可以控制农场的规模、生物行为等属性，以优化服务器性能并提供可定制的管理方案。

💡功能特性

• 禁用过度繁殖：在规模过大的动物农场或村民繁殖器中禁止生物繁殖。
• 减少随机移动：降低农场内生物不必要的随机移动，减轻服务器负担。
• 禁用生物AI：可完全冻结农场内生物的AI，使其停止所有自主行为。
• 限制农场容量：设定每个农场允许容纳的生物数量上限。
• 高度可配置：通过配置文件细致调整插件行为，满足不同服务器的需求。
• 低性能影响：插件的主要处理过程采用异步方式执行，对服务器性能影响极小。

🎮安装与要求

安装步骤

• 将下载的 FarmControl.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件。
• 根据需求，仔细配置 plugins/FarmControl/ 目录下的 config.yml 和 profiles.yml 文件。

系统要求

• Java 版本：需要 Java 17 或更高版本。

🔧配置文件详解

插件的行为主要通过两个配置文件控制。默认配置仅会移除动物农场内生物的随机移动能力并禁用其碰撞。

config.yml 核心设置

此文件控制插件的全局运行逻辑。

• cycle-period：插件执行检查与行动周期的频率（单位：游戏刻）。默认每600刻运行一次。
• start-up-delay：插件启动后，等待多少游戏刻再开始检查任务。在“响应式”模式下，可用于忽略服务器重启初期的性能波动。
• world-settings：可为每个世界单独指定设置。未指定的世界或选项将使用 default 下的配置。

- `profiles`：指定要运行的配置文件（来自profiles.yml）。

- `proactive`：持续运行的配置文件列表。

- `reactive`：仅在服务器性能不佳时触发的配置文件列表，性能恢复后会逐步撤销相关操作。

• reactive-mode-settings：响应式模式的触发设置。

- `trigger-mspt-threshold`：MSPT（每刻毫秒数）高于此值时触发响应式模式。默认 45.0。

- `untrigger-mspt-threshold`：MSPT低于此值时，撤销响应式模式下的操作。默认 35.0。

• exclusion-settings：设定哪些生物应被排除在插件操作之外。

- 可排除已驯服、已命名、处于求爱模式、被拴绳的生物等。

- 可通过 `metadata` 排除其他插件（如EliteMobs、Citizens、Shopkeepers）生成的特定生物。

profiles.yml 预设方案

此文件定义了具体的检测规则和要执行的操作。每个“方案”包含一个“组”条件和一个“行动”列表。

默认包含的方案示例：

• soft-nerf-animal-farms：在5格范围内，若同类动物数量≥15，则移除其随机移动并禁用碰撞。
• soft-limit-animal-farms：在5格范围内，若同类动物数量≥20，则禁用其繁殖能力。
• trim-animal-farms：在5格范围内，若同类动物数量>20，则清除多余生物。
• trim-villager-chunks：在同一区块内，若村民数量>10，则清除多余村民。

如需创建自定义方案，请参考官方 Wiki： https://github.com/froobynooby/FarmControl/wiki/Profiles

⭐命令与权限

所有基础命令都需要权限节点 farmcontrol.command.farmcontrol。

• /farmcontrol reload

- **描述**：重载插件的配置文件。

- **权限**：`farmcontrol.command.reload`

• /farmcontrol status <world>

- **描述**：显示指定世界的插件运行状态。

- **权限**：`farmcontrol.command.status`

• /farmcontrol history

- **描述**：显示插件近期执行的操作历史记录。

- **权限**：`farmcontrol.command.history`

• /farmcontrol notify

- **描述**：切换接收插件通知的开关。

- **权限**：`farmcontrol.command.notify`

❓其他信息

数据统计 (Metrics)

• 本插件使用 bStats 收集匿名的服务器运行数据，以帮助开发者改进插件。
• 您可以在 plugins/bStats/ 目录下的 config.yml 文件中选择退出数据收集。

重要提醒

• 配置修改后，请使用 /farmcontrol reload 命令或重启服务器以使更改生效。
• 合理使用“响应式”模式可以在服务器性能下降时自动采取限制措施，但最佳实践始终是提前规划，避免性能问题发生。