插件概览
===============
Cronus 是一个强大且适用于生产环境的 Minecraft 插件，可以自动加载自定义纹理包，当玩家从各种城市建设插件的特定区域进入时加载这些纹理包。它旨在与主要的城市建设插件的任何组合无缝协作，为您的服务器提供动态且身临其境的纹理包体验。
核心功能
==================
• 自动纹理包加载：当玩家进入一个区域（城镇、地块、帮派领地等）时，Cronus 会自动加载为该区域配置的纹理包。
• 通用插件兼容性：与 22 多个主要的城市建设插件兼容，包括 Towny、WorldGuard、GriefPrevention、Lands、PlotSquared、Factions 等。
• 智能区域检测：实时监控玩家移动并检测区域变化。
• 可配置的加载延迟：设置自定义加载延迟以确保平滑过渡。
• 哈希验证：使用 SHA-1 哈希进行安全性和性能优化。
支持的城市建设插件
============================
主要插件：
• Towny & TownyLands - 城镇和国家管理
• WorldGuard - 区域保护和管理
• GriefPrevention - 土地索赔保护
• Lands - 土地管理和保护
• PlotSquared - 地块管理系统
• Factions - 基于帮派的游戏玩法
• RedProtect - 区域保护
附加插件：
• Residence - 住宅管理
• CoreProtect - 块记录和回滚
• LocketteX - 箱子和门保护
• LWC - LocketteX 替代
• Citadel - 加固系统
• JukeAlert - 告密监控
• NameLayer - 群组管理
• ExilePearl - 玩家流放系统
• PrisonPearl - 玩家监禁
• CombatTagPlus - 战斗记录
• Essentials - 必备服务器命令
• Vault - 经济和权限桥梁
命令
========
/cronus set [delay] [owner]
为特定区域设置纹理包
• area: 区域名称（例如“spawn”、“town_center”）
• hash: 纹理包文件的 SHA-1 哈希值
• url: 纹理包的直接下载 URL
• delay: 加载延迟，以毫秒为单位（默认为 1000）
• owner: 区域所有者（默认为命令发送者）
/cronus list
列出所有已配置的区域及其纹理包信息
/cronus reload
从文件重新加载区域配置
/cronus remove
删除区域的纹理包配置
/cronus info
显示特定区域的详细信息
/cronus stats
显示全面的插件统计信息
/cronus validate
验证所有已配置区域是否存在错误
/cronus reloadall
为所有在线玩家重新加载纹理包
/cronus status
显示插件兼容性状态
/cronus help
显示帮助信息
权限
===========
• cronus.admin - 对 Cronus 命令的所有访问权限（默认为 op）
• cronus.user - 基本用户权限（默认为 true）
特性
========
高级控制台日志记录：
• 彩色控制台输出，带前缀
• 所有操作的进度指示器
• 成功/失败状态消息
• 详细日志记录的调试模式
• 加载时间跟踪和性能指标
增强的纹理包管理：
• 具有可配置延迟的自动纹理包加载
• 用于安全性和性能优化的哈希验证
• 玩家通知系统
• 纹理包状态跟踪
• 强制重新加载功能
• 基于区域的玩家计数
改进的区域管理：
• 输入验证和错误处理
• 区域统计信息和指标
• 自动区域验证
• 更好的文件处理和错误恢复
• 所有者跟踪和管理
性能与监控：
• 加载时间跟踪
• 插件兼容性摘要
• 区域验证系统
• 玩家分布跟踪
• 调试日志记录系统
技术规格
========================
• Minecraft 版本：1.21.8+
• Java 版本：21+
• 服务器软件：Paper（推荐）或 Spigot
• API 版本：1.21
• 依赖项：无（对城市建设插件的软依赖）
工作原理
============
1. 插件检测：启动时，Cronus 会自动检测安装并启用的城市建设插件。
2. 区域监控：插件监控玩家移动并检测来自城市建设插件的区域的进入/退出。
3. 纹理包加载：当玩家进入一个区域时，Cronus 会自动加载为该区域配置的纹理包。
4. 自动管理：纹理包可配置延迟应用，并且可以通过命令轻松管理。
安装说明
==================
1. 准备您的纹理包：
• 创建包含您的纹理包的 .zip 文件
• 将其上传到具有直接下载访问权限的 Web 服务器
• 获取文件的 SHA-1 哈希值
2. 安装插件：
• 下载 Cronus.jar 文件
• 将其放在服务器的插件文件夹中
• 重新启动您的服务器
3. 配置区域：
• 使用 /cronus set 配置每个区域
• 插件将自动检测玩家何时进入这些区域
4. 测试：
• 进入配置的区域
• 纹理包应自动加载
获取纹理包哈希值
===========================
WINDOWS:
certutil -hashfile texturepack.zip SHA1
MACOS/LINUX:
shasum -a 1 texturepack.zip
在线工具：
• 使用在线 SHA-1 计算器（上传您的文件）
配置文件的说明
==================
config.yml - 主要插件配置，包括：
• 一般设置
• 纹理包选项
• 区域检测设置
• 插件兼容性设置
• 可定制的消息
areas.yml - 存储区域纹理包配置（自动管理）
控制台输出示例
======================
当您启动服务器时，您将看到：
§6=== Cronus 插件启动 ===
§7版本：1.0.0
§7Minecraft 版本：1.21.8
§7初始化管理器...
§7注册命令...
§7注册监听器...
§7Hooking into city build plugins...
§7检测城市建设插件...
§a✓ Hooked into Towny v0.100.1.0
§a✓ Hooked into WorldGuard v7.0.9
§7加载区域配置...
§a✓ Cronus 插件已成功启用！
§7加载时间：245ms
§7已加载区域：3
§6=== 插件兼容性摘要 ===
§7已检查插件总数：22
§a兼容插件：8
§c不兼容插件：14
§a已成功 Hook 到 8 个城市建设插件！
故障排除
===============
纹理包未加载：
• 检查 URL 是否可访问
• 验证哈希是否正确
• 确保区域名称完全匹配
• 检查服务器控制台中的错误消息
插件无法正常工作：
• 验证您是否使用 Paper 1.21.8+
• 检查您的城市建设插件是否已启用
• 确保您拥有正确的权限
• 检查服务器控制台中的启动消息
性能问题：
• 增加 config.yml 中的 check_interval
• 减少正在监控的区域数量
• 使用适当的加载延迟
优点
==========
• 通用兼容性：与几乎任何城市建设插件兼容。
• 专业品质：全面的错误处理和日志记录。
• 易于使用：清晰的反馈和进度指示器。
• 可扩展性：易于添加新的插件兼容性。
• 性能：高效的区域检测和纹理包管理。
• 生产就绪：采用企业级质量标准构建。
使用案例
=========
• 城市建设服务器：自动为不同区域加载主题纹理包
• 角色扮演服务器：根据玩家位置和派系更改纹理
• 冒险地图：为不同区域加载不同的纹理包
• 小游戏服务器：在游戏模式之间切换纹理
• 任何服务器：创建可以增强玩家沉浸感和服务器氛围的基于位置的纹理包体验
License
========
该项目使用 MIT 许可证。
支持
========
如需支持，请：
1. 检查 README 和配置文件
2. 检查服务器控制台中的错误消息
3. 确保满足所有要求
4. 使用最小设置进行测试
贡献
============
欢迎贡献！您可以随时提交问题、功能请求或拉取请求。
版本历史
===============
1.0.0 - 初始版本，包含基本功能：
• 主要城市建设插件的区域检测
• 自动纹理包加载
• 可配置的延迟和设置
• 易于管理的命令
• 扩展的插件兼容性（22 多个插件）
• 专业的日志记录系统
• 增强的用户体验
• 生产就绪的质量
结论
==========
Cronus 是 Minecraft 服务器提供动态、基于位置的纹理包体验的最终解决方案。凭借其通用兼容性、专业品质和全面的功能集，它将您的服务器转变为一个身临其境的世界，其中每个区域都可以拥有自己独特的可视身份。
无论您运行城市建设服务器、角色扮演服务器还是任何其他类型的 Minecraft 服务器，Cronus 都为您提供了创建引人入胜、基于位置的纹理包体验所需的工具，从而增强了玩家的沉浸感和服务器氛围。