Plan项目5.6开发版2948构建技术解析

Plan是一款开源的玩家数据分析插件，主要用于Minecraft服务器。它能够收集和分析服务器上的各种数据，包括玩家活动、服务器性能等，并通过直观的Web界面展示给管理员。本次发布的5.6开发版2948构建带来了多项改进和修复，下面我们将详细解析这些技术更新。

权限系统优化

本次更新对命令权限系统进行了重要调整。/plan和/planproxy命令现在需要plan.command权限才能使用。这一改变主要是为了解决命令在Tab补全中显示的问题——即使玩家没有任何子命令的访问权限，命令也会出现在补全列表中。通过引入基础权限检查，可以更精确地控制命令的可见性。

平台兼容性增强

在平台适配方面，开发团队做了多项改进：

1. Fabric支持升级：现在使用1.21.3 API，同时保持对1.21.4的兼容性。需要注意的是，现在需要fabric-permissions-api 0.3.3版本。

2. Nukkit修复：解决了因EntityTameable类被移动到不同包导致的不兼容问题。

3. Folia优化：修复了与ping任务相关的ConcurrentModificationException问题，以及当其他插件在主线程使用Plan占位符时可能导致的区域tick线程崩溃。

数据可视化改进

Web界面中的日历组件得到了显著增强：

1. 时区问题修复：解决了当服务器时区设置为负GMT(如GMT-8)时，日历显示日期比实际晚一天的问题。

2. 多语言支持：日历现在能够响应UI中选择的语言设置，为国际化用户提供更好的体验。

3. 地图显示优化：修复了某些国家因缺少国家名称到ISO-3166 alpha-3转换而无法在地图上显示的问题。

数据库优化

在数据存储方面，本次更新包含以下改进：

1. 字符编码修复：CorrectWrongCharacterEncodingPatch现在只会应用于Plan自己的表，避免影响同一数据库中的其他表。

2. ping数据插入：修复了可能导致重复键错误的ping插入问题。

3. 数据保留策略：默认时间序列数据保留期从90天延长至10年(3650天)，但不会更改现有配置。

扩展功能增强

扩展系统获得了更强大的能力：

1. 字符串存储：StringProvider现在可以存储长达250个字符的值，然后才会进行截断处理。

2. 新扩展：新增了CMI扩展支持。

本地化改进

本地化支持方面：

1. 法语修复：解决了法语(FR)语言包导致网站加载问题的情况。

2. 日语更新：日语(JA)语言包得到了更新和完善。

占位符系统增强

占位符功能获得了多项改进：

1. 异常处理：现在会捕获占位符请求期间发生的任何异常，避免影响其他使用Plan占位符的插件。

2. 原始值支持：新增了%plan_top_{category}_{n}_value_raw%占位符，提供未格式化的原始值，便于实现自定义时间格式等需求。

3. 在线玩家数据：新增了%plan_server_players_online%和%plan_network_players_online%占位符，显示数据库中最新数据(约1分钟精度)。

配置调整

默认配置有两项重要调整：

1. MySQL连接：移除了默认MySQL启动选项中的&useSSL=false参数。

2. 数据保留：如前所述，时间序列数据的默认保留期从90天延长至10年。

这次更新体现了Plan项目对稳定性、兼容性和用户体验的持续关注。从底层的数据库优化到用户界面的改进，再到扩展系统的增强，都展示了项目团队对细节的关注和对社区反馈的积极响应。对于服务器管理员来说，这些改进将带来更稳定、更灵活的数据分析体验。