TheTime - 自定义RPG日历

💡TheTime：自定义日历

TheTime 是一款强大的自定义日历插件，让你可以为服务器创建独特的时间系统和历史纪元，为你的故事和世界构建提供专属的时间参照。它完全独立于 Minecraft 原版时间系统，仅在需要时计算日期，确保极低的资源占用。

🎮主要特性

• 完全自定义的时间系统：自由定义年、月、日、时、分、秒的长度。例如，创建一个拥有 30 个月份的年份也毫无问题。
• 纪元系统：通过自定义的纪元来构建宏大的历史叙事，为你的世界设定不同的时代。
• 可自定义的 GUI 皮肤：通过配置文件更改日历界面中使用的物品，轻松营造中世纪或其他主题氛围。
• 多时间系统支持：可同时创建并运行多个独立的时间系统，用于模拟不同的时区或平行时间线。
• 被动时间计算：插件不会干扰 Minecraft 原版时间系统，仅在执行命令时计算日期，最大程度降低资源消耗。
• 易于配置：提供清晰的配置文件，设置过程简单直观。

🔧命令与权限

• /calendar

- 描述：打开默认时间系统（`default`）的日历。

- 权限：`TheTime.calendar.default`

• /calendar [TimeSystem]

- 描述：打开指定时间系统（如 `rome`）的日历。

- 权限：`TheTime.calendar.TimeSystem`（将 `TimeSystem` 替换为具体名称）

• /TheTime reload

- 描述：重新加载所有配置文件。

- 权限：`TheTime.reload`

• /TheTime

- 描述：显示插件信息。

- 权限：无

✨配置时间系统

时间系统是插件的核心，它定义了所有时间单位的长度、纪元信息以及日、月的名称。

开始配置

• 启动服务器，确保插件生成配置文件。
• 在插件数据文件夹中找到并打开 TimeConfig.yml 文件。
• 在文件顶部的 Time-Systems: 部分，你可以看到预配置的时间系统，如 default 和 rome。我们将以修改 default 为例。

配置时间单位

在时间系统（如 default:）下，你可以看到从 second: 开始的一系列时间单位。每个单位下的 ticksPerSecond 等值定义了该单位的长度。

• 示例：定义秒

    default:
      second:
        ticksPerSecond: 20 # 表示 20 个游戏刻为 1 秒

配置日与周

在 day: 部分，你需要定义每日的小时数 (hoursPerDay) 和每日的名称 (dayNames)。week: 部分中的 daysPerWeek 定义了每周的天数，必须与 dayNames 中定义的天数数量一致，且最大值受 GUI 大小限制为 8。

• 示例：定义一周七天

    day:
      hoursPerDay: 24
      dayNames:
        '1': {name: Monday}
        '2': {name: Tuesday}
        '3': {name: Wednesday}
        '4': {name: Thursday}
        '5': {name: Friday}
        '6': {name: Saturday}
        '7': {name: Sunday}
    week:
      daysPerWeek: 7

配置月与年

在 month: 部分，你需要为每个月定义名称 (name) 和天数 (days)。月份数量由 year: 部分中的 monthsPerYear 决定。

• 示例：定义月份

    month:
      daysPerMonth:
        '1': {name: January, days: 31}
        '2': {name: February, days: 28}
        # ... 其他月份
    year:
      zero: 0 # 纪元的起始年份
      monthsPerYear: 12

配置纪元

在 era: 部分，你可以定义不同的历史纪元。每个纪元需要设置其名称 (name)、开始年份 (startYear) 和结束年份 (endYear)。

• 示例：定义纪元

    era:
      eras:
        '1':
          name: default
          startYear: 0
          endYear: 1
        '2':
          name: '你的纪元'
          startYear: 10
          endYear: 40

⭐PlaceholderAPI 支持

安装 PlaceholderAPI 后，你可以在其他插件中使用以下占位符来显示时间信息：

• %TheTime_date_tick%
• %TheTime_date_second%
• %TheTime_date_minute%
• %TheTime_date_hour%
• %TheTime_date_day%
• %TheTime_date_day_name%
• %TheTime_date_dayOfWeek%
• %TheTime_date_week%
• %TheTime_date_month%
• %TheTime_date_month_name%
• %TheTime_date_year%
• %TheTime_date_era%
• %TheTime_date_era_name%

❓其他说明

• 更多界面和命令的详细设置，请查阅 CalendarConfig.yml 和 CommandConfig.yml 文件中的说明。
• 发现漏洞或有建议？请在插件讨论区报告。
• 项目仓库：请访问插件发布页获取链接。
• 图标来源：感谢来自 www.flaticon.com 的各位作者。

感谢阅读！别忘了为插件评分！

~Joshua