[MD]
# 🎉 NationalDay —— 国庆节主题插件
> 一款为 Minecraft 服务器打造的国庆节主题插件,添加了可合成的自定义物品「国庆旗帜」,右键即可打开配置界面,为范围内玩家持续释放药水效果。
---
## 📖 简介
**NationalDay** 是一款节日主题插件。它在游戏中加入了一件特殊的自定义物品——**国庆旗帜**,玩家可以通过合成或击杀监守者获得。将旗帜放置在地上并右键,就能打开一个GUI,自由组合药水、时长、范围与等级,为周围玩家持续施加药水效果,效果类似于信标,但可完全自定义效果。
插件还内置了**国庆节时间段**管理:只有在配置指定的日期范围内,监守者才会掉落国庆旗帜,并有开始/结束倒计时,让节日氛围拉满。
---
## ✨ 主要功能
### 🚩 国庆旗帜
- 物品材质使用**国旗样式旗帜**,外观独特。
- 通过 `PersistentDataContainer` 标记,铁砧改名也不会影响识别。
### 🛠️ 获取方式
| 方式 | 说明 |
|---|---|
| **工作台合成** | 8 个红色羊毛围成一圈 + 1 个下界之星 |
| **击杀监守者** | 仅在国庆节期间掉落,掉落概率可在 `config.yml` 中配置(默认 100%) |
### 🖥️ GUI 界面
右键已放置的国庆旗帜即可打开一个箱子GUI界面:
| 槽位 | 可放入物品 | 作用 |
|---|---|---|
| **药水** | 普通药水(喷溅/滞留不可放入) | 决定释放的效果类型 |
| **时间** | 铁锭 / 金锭 / 钻石 / 绿宝石 / 下界合金锭 | 决定效果持续时间 |
| **范围** | 下界之星 | 每颗扩大 8 格,最多升级 8 次 |
| **等级** | 凋零骷髅头颅 | 每颗提升 1 级,最高升级 10 级 |
| **确认** | 绿色头颅按钮 | 应用配置 |
| **取消** | 红色头颅按钮 | 返还物品并关闭 |
### ⏱️ 时间材料对照
| 材料 | 增加时长 |
|---|---|
| 铁锭 | 2 分钟 |
| 金锭 | 5 分钟 |
| 钻石 | 10 分钟 |
| 绿宝石 | 13 分钟 |
| 下界合金锭 | 20 分钟 |
| **上限** | **60 分钟** |
### 🎯 效果释放
- 激活后,旗帜每秒向范围内所有**玩家**(不影响其他生物)施加药水效果。
- 药水中携带的原版效果时长会被忽略,实际时长完全由时间材料决定。
- 药水若含多种效果,将全部释放。
- 效果等级 = 药水基础等级 + 等级加成,上限 10 级。
- 破坏旗帜时效果立即停止,并掉落完整的国庆旗帜。
### 🗓️ 国庆节时间段
在 `config.yml` 中配置国庆节时间段和旗帜掉落概率:
```yaml
# 国庆节时间段,格式:yy.M.d.HH:mm-yy.M.d.HH:mm
# 年份使用 2000 年后的两位数,例如 26 表示 2026 年
# 时间段内监守者才会掉落国庆旗帜,时间段外不掉落
national-day-period: "26.10.1.00:00-26.10.7.23:59"
# 击败监守者掉落国庆旗帜的概率
# 取值 0-100 的整数,100 表示一定掉落,0 表示永不掉落
warden-drop-chance: 100
```
---
## 📃 关于
- 插件作者是 **xiaomian124**。
- 这个插件最初只为 **BDWL 服务器** 而打造,现在公开到资源站上,欢迎访问此服务器 [官网](https://bdwlmc.xiao-blog.top/) 。
- 插件是开源的,源代码在 [Github](https://github.com/xiaomian124/NationalDay) 。
- 运行中发现插件问题请打开 [Issue](https://github.com/xiaomian124/NationalDay/issues) 告诉我。
- 感谢你喜欢并游玩我的插件,可以在 [Github](https://github.com/xiaomian124/NationalDay) 点个 **Star** 吗,谢谢!
[/MD]