YinwuRaid — Yinwu灾厄袭击

YinwuRaid — Raid System

最新版本：v1.2.3 | 下载 Release

Multi-wave calamity raid system triggered by high-level Bad Omen effects.

基于高等级不祥之兆触发的多波次灾厄袭击系统，包含信标、种子强化、村民奖励等完整机制。

⚡ 完全兼容 Folia 区域线程调度，全部事件驱动。

---

Features | 功能概览

模块	说明
🗿 倒置信标	自定义多层信标结构检测，触发灾厄效果
🌱 灾厄之种	升级装备已有附魔等级，突破原版上限
👹 多波次袭击	每波含幻术师，支持精英怪、Boss 机制
🎁 村民奖励	职业绑定奖励池（14 职业 + 默认），英雄等级越高越好
🌫️ 灾厄效果	粒子迷雾（白/绿）、BossBar、音效
🧟 MythicMobs	软依赖，支持自定义生物生成

---

Quick Start | 快速开始

1. 将 YinwuRaid-1.2.3.jar 放入 plugins/ 目录
2. 重启服务器
3. 搭建倒置信标结构，右键信标消耗材料（下界之星 / 不祥之瓶）激活
4. 获得高等级不祥之兆效果（6-10 级）→ 进入村庄自动触发灾厄袭击

---

Commands | 命令

主命令 /yinwuraid，别名 /yr。

命令	说明	权限
/yinwuraid help	查看帮助	yinwu.raid.use
/yinwuraid reload	重载配置	yinwu.raid.admin
/yinwuraid give <玩家> <物品ID> [数量]	给予测试物品（SEED1 / SEED2 灾厄之种）	yinwu.raid.admin
/yinwuraid debug <子命令>	调试命令（info / config / stats / beacon / spawn / trigger / reloadbeacon）	yinwu.raid.admin

debug trigger [level] 可手动触发指定等级（7-10）的灾厄袭击；debug spawn <生物> [数量] 可生成测试怪物。give 支持的物品 ID：SEED1、SEED2（灾厄之种 I / II）。

---

Architecture | 架构

YinwuRaid
├── beacon/              # 倒置信标（结构检测 / 交互 / 灾厄强化）
├── raid/                # 袭击核心（调度/刷怪/BossBar/迷雾/Buff）
├── reward/              # 村民赠礼奖励
├── effect/              # 灾厄效果
├── gui/                 # 信标 / 强化 GUI
├── command/             # 命令处理
├── api/                 # RaidAPI 服务实现
├── config/              # 26 个配置类
└── YinwuRaidPlugin      # 主类

---

Build | 构建

git clone https://github.com/YinwuPotato/YinwuRaid.git
cd YinwuRaid
mvn clean package

产出：target/YinwuRaid-1.2.3.jar

前置步骤（首次构建必需）：本插件依赖共享库 YinwuPluginLib，而它不在 Maven 中央仓库。 首次构建前先克隆并安装一次：

git clone https://github.com/YinwuPotato/YinwuPluginLib.git
cd YinwuPluginLib && mvn clean install

之后回到本仓库 mvn clean package 即可。父 POM（net.yinwu:YinwuPlugins:1.0.1） 已随仓库提供在 parent/pom.xml，无需额外操作。

---

Dependencies | 依赖

• YinwuPluginLib（构建期前置 —— 构建产物已把该库 shade 进 jar，服务器上不需要单独安装它）
• Paper API 1.21+（provided）
• YinwuForge（可选，袭击掉落可锻造材料）
• YinwuEnchant（可选，袭击奖励含自定义附魔书）
• MythicMobs（可选，自定义生物生成）

---

Design Principles | 设计原则

• 事件驱动 — 无轮询，全部通过事件监听触发
• Folia 安全 — 全部跨区域操作正确路由
• 配置化 — 26 个配置类，全部可热重载

---

License | 许可证

LGPL-3.0 —— 见 LICENSE。

---

Links | 链接

• 仓库：github.com/YinwuPotato/YinwuRaid
• 关联：YinwuForge | YinwuEnchant
• 作者：Qumingjam