Insights - Super configurable (region) Limits + Asynchronous Scans - Insights - 超强区域限制与异步扫描

Insights 是一款强大的区块扫描与限制插件，它采用异步扫描技术，能高效分析世界中的方块与实体，并允许你为每个区块或区域（如领地、岛屿）设置精细的数量限制，从而优化服务器性能并维持游戏平衡。

💡版本支持

Insights 主要支持最新的 Minecraft 版本。请根据你的服务器版本选择对应的 Insights 插件版本：

• MC 1.19.2：最新版 *
• MC 1.18.2：v6.11.0 **
• MC 1.18.1：v6.10.1 ***
• MC 1.17.1：v6.8.2 ***
• MC 1.15 - 1.16.5：v6.3.1 ***

说明

• * 受支持版本
• ** 仅接收错误修复，直至下一个主要更新
• *** 不受支持版本

✨核心特性

高性能异步扫描

• 不使用常规的区块加载系统，避免产生内存垃圾。
• 采用并行扫描的 MapReduce 设计模式，大幅提升效率。
• 所有性能参数均可在配置文件中按需调整。

灵活的限制配置

• 可按 区块 为单位设置方块数量上限。
• 限制规则可通过 权限组、玩家权限 或 全局配置 进行管理。
• 支持对静态实体进行限制，包括：
• 物品展示框（含发光变种）
• 盔甲架
• 末地水晶
• 画

强大的扫描功能

• 全局扫描：扫描整个已加载世界中的特定方块。
• 半径扫描：使用查询命令扫描玩家周围最多 25 个区块半径内的所有方块。
• 自定义查询：支持使用自定义条件进行扫描。

区域插件支持

除了区块限制，Insights 还支持与流行的领地/岛屿插件联动，将限制应用于整个区域（例如，限制单个玩家领地内最多只能有 500 个红石方块）。

安装区域插件扩展非常简单：只需将对应的 Addon 文件放入插件目录下的 addons 文件夹，然后重启服务器即可。

当前支持的区域插件扩展包括

• BentoBoxWorldAddon
• GriefPreventionAddon
• USkyBlockAddon
• IridiumSkyblockAddon
• PlotSquaredAddon
• SuperiorSkyblock2Addon
• LandsAddon
• TownyAddon
• GriefDefenderAddon (由 galexrt 开发)

其他集成功能

• WorldEdit 支持：可配置用于替换超限方块的替代方块。
• 现代化消息系统：使用 MiniMessage 格式发送插件消息，支持创建精美的交互式文本组件。

🔧安装与配置

安装区域扩展

• 下载所需插件的 Addon 文件。
• 将其放入 plugins/Insights/addons/ 目录。
• 重启服务器。

配置 FAWE 兼容性

如果你使用 FAWE (FastAsyncWorldEdit)，并在聊天栏看到关于 Insights 的“不安全访问”提示，请按以下步骤操作：

• 打开 FAWE 的 config.yml。
• 将 Insights 添加到 allowed-plugins 列表中。

❓常见问题

Insights 会限制生物等实体吗？

不会。Insights 专为限制静态方块和实体设计，不支持限制可移动的实体（如生物）。盔甲架是个例外，因为可以在 Paper 服务器的 paper.yml 中通过设置 armor-stands-tick 使其变为静态。

如何获取更多信息？

• 完整的扫描命令与权限列表，请查阅 Wiki。
• 如何制作自己的 Addon，请查阅 Wiki。
• 详细的配置说明，请查阅 Wiki。

🎮支持与帮助

如果你需要帮助，可以通过以下方式获取支持

• 加入 Discord 服务器
• 发送私信
• 访问 GitHub
• 在本插件的 讨论帖 中留言

⭐致谢

特别感谢以下朋友对本项目的赞助

• @BiGUNMAN €15.00
• @SirKillian €15.00
• @Luky584 €2.00
• @SlimeDog $10.00
• @DarthEdard €2.75

希望 Insights 能为你带来出色的管理体验！

Insights 插件文档

Insights 是一款高级数据分析和监控插件，专为需要深入了解服务器性能、玩家行为和实体状态的管理员设计。它通过收集和分析游戏内数据，帮助管理员识别性能瓶颈、异常行为或潜在问题，从而优化服务器运行和玩家体验。

💡核心功能

• 性能监控：实时跟踪服务器TPS（每秒刻数）、内存使用情况、实体数量等关键性能指标。
• 实体分析：扫描并统计世界中的实体（如生物、掉落物、矿车等），识别可能造成卡顿的实体聚集区域。
• 区块分析：检查区块的加载状态、实体负载和方块实体（如箱子、熔炉）数量，帮助定位高负载区块。
• 玩家追踪：监控玩家活动，包括移动模式、交互行为和潜在的可疑操作。
• 自定义报告：生成可定制的数据报告，支持按时间范围、世界、实体类型等条件筛选。
• 低开销：设计为在后台高效运行，对服务器性能影响极小。

🎮命令与权限

主要命令

• /insights - 显示插件主菜单或帮助信息。
• /insights scan <世界名> - 对指定世界执行实体扫描。
• /insights tps - 显示当前服务器TPS和性能概况。
• /insights chunk [世界名] [x] [z] - 分析特定区块的详细信息。
• /insights report generate [类型] - 生成指定类型的分析报告。
• /insights reload - 重载插件配置文件。

常用权限节点

• insights.use - 允许使用基础命令和查看菜单。
• insights.scan - 允许执行扫描命令。
• insights.tps - 允许查看TPS信息。
• insights.report - 允许生成和查看报告。
• insights.admin - 授予所有管理权限（包括reload）。

🔧安装与配置

安装步骤

• 确保服务器运行 Paper、Spigot 或兼容的衍生服务端（推荐Paper以获得最佳性能）。
• 从官方发布页面下载最新版本的 Insights.jar。
• 将JAR文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 根据需要编辑生成的 plugins/Insights/config.yml 文件。

基础配置

首次安装后，插件会生成默认配置文件。建议查看并调整以下部分：

• 数据收集间隔：设置性能数据采样的频率。
• 扫描设置：配置自动实体扫描的世界、时间间隔和阈值。
• 报告存储：定义生成报告的保存路径和格式。
• 通知权限：设置哪些管理员在检测到问题时接收告警。

✨使用指南

进行首次实体扫描

• 在游戏内或控制台输入：/insights scan world

（将 world 替换为你要扫描的世界名称，如 world_nether）。

• 插件将开始分析该世界所有已加载区块中的实体。
• 扫描完成后，你会收到一份摘要，显示实体总数、各类实体数量以及任何超过预设阈值的“热点”区域。

生成性能报告

• 使用命令：/insights report generate performance
• 指定时间范围（例如最近24小时）。
• 报告将包含TPS图表、内存使用趋势和实体数量变化。
• 报告可以保存为文本文件或在游戏内预览。

排查卡顿问题

如果服务器出现卡顿，可以按以下步骤使用Insights：

• 立即检查TPS：/insights tps
• 若TPS较低，快速扫描主世界：/insights scan world
• 查看扫描结果，重点关注：
• 异常数量的掉落物或经验球。
• 大量聚集的被动生物或敌对生物。
• 存在大量方块实体（如漏斗、标记牌）的区块。
• 使用 /insights chunk 命令深入检查可疑的高负载区块。

❓常见问题

• Q: 扫描会影响服务器性能吗？
• A: 扫描过程经过优化，影响很小。但建议在玩家较少时执行全面扫描。

• Q: 数据存储在哪里？会占用大量空间吗？
• A: 数据默认存储在 plugins/Insights/data/。占用空间取决于数据收集频率和保存时长，通常很小。

• Q: 支持Minecraft什么版本？
• A: Insights支持多个Minecraft版本。请查看官方页面获取具体的版本兼容信息。

• Q: 可以与其他监控插件共存吗？
• A: 可以，Insights不会与其他主流监控插件（如CoreProtect、Plan）冲突。

• Q: 如何更新插件？
• A: 下载新版JAR文件，替换旧文件，然后重启服务器。配置和数据的兼容性通常会在更新日志中说明。

⭐注意事项

• 定期生成报告有助于发现长期趋势，建议每周至少生成一次完整报告。
• 实体扫描的范围仅限于已加载的区块。要扫描整个世界，需要确保目标区域已加载（例如有玩家在该世界活动）。
• 插件的某些高级功能（如实时警报）可能需要额外的配置。
• 始终在测试环境中试用新配置，再应用到生产服务器。

---

**官方资源**

• 下载与更新：请访问 GitHub Releases
• 问题反馈：请使用 GitHub Issues
• 详细文档：请查看 项目Wiki