Advent Calendar - 圣诞日历

用这个可自定义的圣诞倒数日历为你的 Minecraft 服务器增添节日氛围吧！你可以为玩家发放有趣奖励，打造独特的节日体验。

✨功能

• 完全自定义玩家领取礼物时执行的命令
• 基础命令可自定义别名
• 每一天可运行任意数量的命令
• 可自定义时区、领取提示、过期礼物材质、GUI 名称、填充物品等
• 使用 SQLite 数据存储
• 命令现在支持 PlaceholderAPI 占位符

⭐命令

• /ac - 打开 advent calendar
• /adventcalendar，/advent - /ac 的别名
• /ac force <player> - 允许管理员为指定玩家打开日历
• /ac admin preview - 打开日历 GUI 预览，方便管理员测试命令和 GUI 自定义，不会影响正式日历
• /ac admin reload - 允许管理员在不重启服务器的情况下重载配置
• /ac admin viewclaims <player> - 在聊天中显示指定玩家已领取了日历中的哪些天
• /ac admin removeclaim <player> <day> - 删除指定玩家在指定日期的领取记录
• /ac admin removeallclaims <player> - 删除指定玩家的全部领取记录
• /ac help - 显示每个命令说明的帮助窗口

🎮权限

• adventcalendar.open - 允许玩家为自己打开 advent calendar，日历仍会在十二月开始前显示倒计时
• adventcalendar.admin - 管理员权限总入口
• adventcalendar.admin.reload - 允许重载配置文件
• adventcalendar.admin.preview - 允许打开预览日历进行测试
• adventcalendar.admin.viewclaims - 允许查看指定玩家的领取记录
• adventcalendar.admin.removeclaim - 允许删除指定玩家的某个领取记录
• adventcalendar.admin.removeclaimall - 允许删除指定玩家的全部领取记录

🔧配置说明

`config.yml`

• config-version：用于判断配置是否为最新版本，便于在控制台打印更新警告
• time-zone：日历判断当前日期所使用的时区
• calendar-month：日历作为领取月份使用的月份，日历只能在该月份内打开
• allow-expired-claims：是否允许领取过期日期的礼物
• max-claims-per-ip：每个唯一 IP 最多允许领取的数量，用于防止小号刷奖励；设为 -1 可关闭限制
• display-numbers-on-gifts：礼物显示数量是否与日期数字一致，或每一天都只显示 1 个
• 25-day：日历显示为 24 天或 25 天模式
• title：Advent Calendar GUI 标题
• gift-name：每个礼物上显示的名称，可在这里或下方 days-material 中分别设置颜色代码
• claimed-name：已领取礼物上显示的名称，可在这里或下方 days-material 中分别设置颜色代码
• close-name：关闭按钮名称
• filler-material：围绕 GUI 外圈的填充物品材质
• close-material：关闭按钮使用的材质
• days-material：为每一天设置礼物外观
• color：礼物名称显示的颜色
• material：物品材质
• texture：如果 material 是 PLAYER_HEAD，则使用这里指定的头颅纹理
• custom-model-data：用于资源包自定义模型；设为 0 时忽略
• claimed-color / claimed-material / claimed-texture / claimed-custom-model-data：已领取或过期状态下的对应设置
• 注意：texture 字段必须使用 textures.minecraft.net 链接，否则日历会报错
• rewards：每一天领取后执行的命令
• slots-required：用于发放物品时，确保玩家有足够背包空间
• commands：该日期执行的命令列表

`strings.yml`

• 支持所有 Minecraft 颜色代码，使用 & 符号即可
• 此版本也支持渐变颜色，语法请参考：https://github.com/Iridium-Development/IridiumColorAPI/blob/master/README.md
• 可使用 %player% 表示玩家用户名，使用 %day% 表示领取的日期
• %prefix% 会被替换为 prefix 的内容
• prefix：插件前缀
• claim-message：玩家成功领取礼物后显示的消息
• error-expired-message：礼物已过期时显示的消息
• error-ip-message：达到 IP 领取上限时显示的消息
• error-claimed-message：礼物已被领取时显示的消息
• error-inventory-message：玩家背包空间不足时显示的消息
• error-calendar-message：日历尚未解锁时显示的消息
• %s 会自动填充时间，请不要随意修改，除非你知道自己在做什么
• error-gift-message：礼物尚未解锁时显示的消息
• %s 会自动填充时间，请不要随意修改，除非你知道自己在做什么
• reload-message：配置重载成功时显示的消息
• claimed-today-true：当 %adventcalendar_claimed_today% 为 true 时显示的消息
• claimed-today-false：当 %adventcalendar_claimed_today% 为 false 时显示的消息

❓注意事项

• 输入命令时，不要加上 /
• 使用玩家作为占位符时，请用 %player%
• 例如：give %player% minecraft:diamond 10
• 如果要给玩家游戏货币，并且你使用了 Essentials，可以使用：eco give %player% <amount>
• slots-required 用于发放物品时检查背包空间
• 如果不是发放物品，请设为 0
• 如果要一次发放 3 组物品，请设为 3
• 新选项不会自动添加到现有配置文件中
• 如果配置中找不到某个选项，插件可能会出错
• 最新配置版本可通过以下链接获取：
• https://www.spigotmc.org/resources/advent-calendar.105930/
• https://modrinth.com/plugin/adventcalendar

✨支持与反馈

如果你遇到任何问题，不要留下差评，请加入开发 Discord：

https://discord.gg/GMkjWd2Kun

如果你有任何改进 advent calendar 的建议，也非常欢迎提出。