AxCalendar - 自定义圣诞日历

💡AxCalendar

AxCalendar 是一款高度可定制的免费 Minecraft 插件，它将现实中的圣诞降临日历（Advent Calendar）带入了游戏。你可以在十二月（或任意你指定的月份）里，每天为玩家提供独特的奖励，打造一个充满惊喜的每日签到系统。

💡核心特性

• 数据库支持：支持 SQLite、H2、MySQL 和 PostgreSQL 多种数据库。
• 不止是日历：你可以将其设置为任意月份，并用作一个常规的每日奖励系统。
• 易于使用：插件易于上手，且所有内容均可完全自定义。
• 随处可用：无需重启服务器即可更改所使用的时区。
• IP 限制功能：有效防止玩家使用小号（Alt Account）进行滥用。
• 高度可定制：你可以添加任意数量的奖励，并按照你的偏好设置一切。
• 轻量级：插件性能高效，对服务器负担小。

🎮技术信息

• 支持的 Minecraft 版本：1.20.2 - 1.21.11
• 必需的 Java 版本：21 或更高
• 源代码：https://github.com/Artillex-Studios/AxCalendar/

💡简介

AxCalendar 是一款功能强大的 Minecraft 日历插件，它允许服务器管理员创建自定义的、基于真实世界时间的活动日历。通过它，你可以轻松安排每日、每周、每月或每年重复的活动，并在活动开始、结束或进行时，向玩家发送通知、执行命令或给予奖励。

🎮主要特性

• 灵活的活动安排：支持创建每日、每周、每月或每年重复的活动。
• 多种触发器：可在活动开始、结束或进行期间（可配置间隔）触发动作。
• 丰富的动作类型：

- 向玩家发送标题、副标题、聊天消息或动作栏文本。

- 向全服或特定权限组广播消息。

- 执行控制台或玩家命令。

- 给予玩家物品或经济奖励。

• 可视化日历界面：玩家可以使用 /calendar 命令查看即将到来的活动。
• 高度可配置：支持修改消息、GUI 界面和日期显示格式。
• 多语言支持：内置多种语言文件。
• Hooks 支持：可与 PlaceholderAPI 集成，在消息中使用占位符。

🔧命令与权限

玩家命令

• /calendar - 打开日历界面查看活动。

- 权限：`axcalendar.use` (默认所有玩家拥有)

管理员命令

• /axcalendar reload - 重载插件的配置和语言文件。

- 权限：`axcalendar.admin`

• /axcalendar list - 列出所有已配置的活动。

- 权限：`axcalendar.admin`

• /axcalendar test <活动名称> - 立即触发指定活动的“开始”动作，用于测试。

- 权限：`axcalendar.admin`

✨安装与配置

安装步骤

• 将 AxCalendar.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据你的需求编辑 plugins/AxCalendar/config.yml 和 activities.yml 文件。
• 使用 /axcalendar reload 命令应用更改。

创建活动

活动在 plugins/AxCalendar/activities.yml 文件中配置。每个活动都是一个独立的配置部分。

基本结构示例：

weekly_boss_event: # 活动ID
  name: "&6每周首领战" # 活动显示名称
  description: # 活动描述（列表，显示在日历GUI中）
    - "&7击败强大的世界首领！"
    - "&7丰厚奖励等你来拿。"
  start-date: "14:00" # 活动开始时间（每周）
  duration: 1h # 活动持续时间（1小时）
  schedule: # 日程安排
    type: "weekly" # 类型：weekly（每周）
    days: # 每周的哪几天触发
      - "MONDAY"
  actions: # 触发动作
    on-start: # 活动开始时执行
      - "[CONSOLE] say 每周首领战现已开始！"
      - "[BROADCAST] &6[活动] &e每周首领战已经开始，请前往竞技场参与！"
    on-end: # 活动结束时执行
      - "[CONSOLE] say 每周首领战已结束。"

日程安排（Schedule）类型：

• daily：每天在 start-date 时间触发。
• weekly：在指定星期几（days）触发。
• monthly：在每月指定日期（dates，例如 [1, 15]）触发。
• yearly：在每年指定日期（格式 MM-dd，例如 12-25）触发。

动作（Actions）格式：

动作行以 [类型] 开头，后接参数。

• [CONSOLE] <命令>：以控制台身份执行命令。
• [PLAYER] <命令>：以在线玩家身份执行命令（可使用 %player%）。
• [BROADCAST] <消息>：向全服广播消息。
• [BROADCASTPERM] <权限> <消息>：向拥有指定权限的玩家广播消息。
• [TITLE] <标题>;<副标题>;<淡入>;<停留>;<淡出>：向玩家发送标题。
• [ACTIONBAR] <消息>：向玩家发送动作栏消息。
• [MESSAGE] <消息>：向玩家发送聊天消息。
• [GIVE] <材料>;<数量>;<元数据>：给予玩家物品。
• [GIVEMONEY] <金额>：给予玩家经济奖励（需Vault）。

❓常见问题

如何让活动只在特定世界生效？

在活动配置中，可以使用 worlds: 列表来指定生效的世界。只有玩家在这些世界时，相关的玩家触发动作（如 [PLAYER]、[TITLE]）才会执行。控制台命令和广播不受影响。

活动时间是基于哪个时区？

默认使用服务器系统的时区。你可以在 config.yml 中通过 timezone 设置来指定其他时区（例如 "America/New_York"）。

可以给活动添加图标吗？

可以。在活动配置中，使用 material: 设置来指定在日历GUI中显示的物品（例如 "DIAMOND_SWORD"）。

支持 PlaceholderAPI 吗？

支持。在 config.yml 中启用 hooks.placeholderapi 后，就可以在活动的消息、描述等文本中使用 PlaceholderAPI 的占位符（例如 %player_name%）。

⭐依赖与兼容性

• 必需依赖：无。
• 可选依赖：

- **Vault**：用于 `[GIVEMONEY]` 动作提供经济奖励。

- **PlaceholderAPI**：用于在消息中使用丰富的变量占位符。

• 支持版本：请查看官方页面获取最新的支持 Minecraft 版本信息。
• 数据存储：使用 YAML 文件存储配置，无数据库依赖。