原创 娱乐 CustomRaids —— 让玩家在领地里防御更强的袭击吧！[免费版] 2.0.0

2.0.0（2026-08-13）​

新增功能​

• 计划袭击新增两种目标模式：定时定点、定时全服。
• 计划袭击新增从一组预设中随机挑选一个开始袭击。
• 新增袭击预设配置 <span>global.participation.lands_members_only</span>（默认关闭）：Lands 城镇开启后，仅该城镇 owner / trusted 成员造成的伤害会进入排行，胜利时也只有结算时仍属于该城镇的在线成员可领取参与及前三名奖励；其他插件不受影响。该开关也可在管理 GUI 的袭击详情页调整。
• 新增全局配置 <span>defaults.enable_world</span>，可限制袭击只在指定世界启动；空列表表示所有世界启用。
• 新增原版怪物 ID 支持，袭击预设可使用 <span>source: vanilla</span> 生成 Bukkit <span>Monster</span> 类原版实体。
• 新增怪物来源字段 <span>source: auto|vanilla|mythic</span>：
  • <span>auto</span> 为默认值，保留旧配置兼容。
  • <span>vanilla</span> 只使用原版怪物 ID，例如 <span>zombie</span>、<span>minecraft:zombie</span> 或 <span>ZOMBIE</span>。
  • <span>mythic</span> 只使用 MythicMobs 怪物 ID。
• 新增原版示例预设：
  • <span>examples/raids/example_vanilla_border_patrol.yml</span>
  • <span>examples/raids/example_vanilla_challenge_trial.yml</span>
• 新增外部领地的玩家触发袭击的资格校验：<span>Lands</span> / <span>Towny</span> 要求玩家属于对应领地，<span>Residence</span> 要求玩家拥有该领地 <span>build</span> 权限，内置 <span>Custom</span> 区域不额外限制；该规则适用于 Omen 自动触发和玩家执行 <span>/raids startpreset &lt;name&gt;</span>。
• 新增刷怪点自然地表检查 <span>global.spawn.natural_ground_only</span>（默认关闭，需手动开启）：开启后要求刷怪地面必须是自然地表方块，避免怪物生成在木板、地毯、玻璃、砖块、楼梯、台阶、栅栏、冰、树叶等人造或非陆地方块上；如果服务器安装了会大量改变地表方块的插件（例如自动种花），建议保持关闭，否则可能导致大量刷怪点被判定为不安全。
• 新增刷怪点天空遮挡检查 <span>global.spawn.require_sky_access</span>（默认开启）：要求刷怪点正上方能直接看到天空，避免建筑物屋顶破损或有天窗时，怪物生成到房子内部。

功能改进​

• 明确免费版不会加载或触发 <span>CHALLENGE_RAID</span>；挑战袭击及其 GUI 编辑功能仅在进阶版可用。
• MythicMobs 从必需依赖调整为可选集成；仅使用 MythicMobs 怪物 ID 或 MythicMobs 自定义 Omen 掉落时需要安装。
• 管理 GUI 的波次怪物、挑战怪物和挑战 Boss 编辑器新增怪物来源显示与切换。
• 默认内置示例改为原版怪物，示例包中的 MythicMobs 预设显式标注 <span>source: mythic</span>。
• 更新 <span>examples/</span> 全功能示例包，补齐世界白名单、Lands 成员限制、刷怪安全检查、两种计划袭击模式和加权预设池说明。
• 刷怪安全检查的脚下/头部判定改为"必须可通行"而不是"必须是空气"，允许花、草、告示牌等可通行装饰方块所在位置正常刷怪；同时统一了危险方块判定，额外排除火焰、凋灵玫瑰、细雪等本身可通行但会伤害生物的方块。

升级说明​

• 旧预设仍可继续使用；未配置 <span>source</span> 时按 <span>auto</span> 处理。
• 如果服务器未安装 MythicMobs，只能启动使用原版怪物 ID 的预设。
• 如果服务器向普通玩家开放 <span>/raids startpreset &lt;name&gt;</span>，玩家现在必须满足对应外部领地的触发资格。
• 旧预设未配置 <span>natural_ground_only</span> 时按关闭处理，未配置 <span>require_sky_access</span> 时按开启处理；如果服务器的袭击区域本身建在人造平台或室内场景，可在预设的 <span>global.spawn</span> 下将 <span>require_sky_access</span> 显式设为 <span>false</span> 恢复旧行为。
• 旧计划未配置 <span>mode</span> 时按 <span>ALL_OCCUPIED_REGIONS</span> 处理；旧 <span>preset</span> 字段继续有效，配置非空 <span>presets</span> 时优先使用候选池。
• <span>FIXED_REGION</span> 必须配置真实的 <span>region_id</span>；示例中的全零 UUID 仅为占位值，可在管理 GUI 中站到目标领地内自动写入。
• 旧袭击预设未配置 <span>global.participation.lands_members_only</span> 时默认关闭，保持原奖励和伤害记录行为。

• 新增 挑战试炼袭击（CHALLENGE_RAID） 功能（Pro 专属功能）
• • 支持配置加权怪物池，袭击期间会围绕区域内玩家动态生成 MythicMobs 怪物
  • 支持目标击杀数、个人击杀数、玩家死亡数统计
  • 支持击杀阶段、Boss 阶段和波次兼容显示
  • 支持挑战胜利 / 失败指令、奖励结算和伤害排名
• 新增 挑战袭击 GUI 编辑器（Pro 专属功能）
  • 支持在游戏内创建 CHALLENGE_RAID 预设
  • 支持编辑挑战参数、加权怪物池、Boss 配置、胜利/失败指令
  • 支持 WAVE_RAID / CHALLENGE_RAID 类型切换
• 新增 领地指定刷怪区域功能
  • 支持通过 <span>/raids region setrange</span> 为任意受支持区域单独设置袭击刷怪范围
  • 支持通过 <span>/raids region viewrange</span> 查看当前区域刷怪范围
  • 支持通过 <span>/raids region clearrange</span> 清除当前区域刷怪范围
  • 支持 Custom、Lands、Residence、Towny 区域
  • 该范围只限制刷怪位置，不影响公告、BossBar、ActionBar、Title 和计分板显示范围
  • 新增运行时数据文件：raid_ranges.yml
• 袭击失败原因新增：
  • 新增失败原因 Hook：<span>defeat_empty_region</span>、<span>defeat_timeout</span>、<span>defeat_max_deaths</span>
  • 未配置具体失败原因 Hook 时，会自动回退到原来的 <span>defeat</span>
  • 新增失败原因占位符：<span>%defeat_reason%</span>、<span>%defeat_reason_raw%</span>、<span>%fail_after_empty_seconds%</span>、<span>%empty_seconds%</span>、<span>%time_limit%</span>
• 占位符系统增强：
  • 新增挑战阶段占位符 <span>%phase_raw%</span>
  • 新增 PlaceholderAPI 占位符 <span>%customraids_raid_phase_raw%</span>
  • <span>%phase%</span> 现在会显示语言文件中的阶段文本，方便服务器自定义显示内容
• API 完善：
  • 新增外部区域提供器支持，方便其他插件接入 CustomRaids 的区域系统
  • 支持外部插件通过 API 触发袭击
  • <span>CustomRaidHandle</span> 和 <span>CustomRaidFinishEvent</span> 增加挑战袭击与失败原因相关信息
• 袭击计划功能完善：
  • 支持每周指定时间段开启袭击活动
  • 进一步完善袭击计划 GUI 编辑体验
  • 袭击计划设置为进阶版功能
• Folia / 计分板兼容优化：
  • Folia 服务端计分板通过 ProtocolLib API 进行适配
  • 优化 TAB、ProtocolLib 和无兼容插件时的计分板 fallback 逻辑
• 修复与稳定性优化：
  • 修复挑战袭击开始 Hook 中 <span>%target_kills%</span> 等挑战占位符不生效的问题
  • 修复挑战袭击中玩家离开区域边界后不再显示 BossBar / ActionBar / 计分板的问题
  • 修复玩家死亡传送或区块卸载后袭击怪物可能消失，导致袭击卡住的问题
  • 运行中的袭击怪物现在会被追踪并保留所在区块，降低怪物消失概率
• 帮助文档和示例配置更新：
  • 更新中文 / 英文帮助文档
  • 更新袭击配置、计划袭击、API、PAPI 占位符和命令说明
  • 新增 / 更新挑战袭击示例配置
  • 更新完整示例配置和 MythicMobs 示例
• 本版本新增了语言文件栏目、挑战袭击示例和 raid_ranges.yml 运行时数据文件，升级前建议备份旧配置，并对照新文件合并配置。

1.0.6 更新​

• 添加了bstats插件数据统计
• 解决插件版本号显示错误的问题

1.0.4 更新​

• omen的配置文件中添加了新的选项：milk_clears_custom_omen，用于设置是否能通过牛奶消除不祥征兆。
• 帮助文档更新
• 示例配置文件更新

1.0.5 更新​

• 完善了不祥征兆的GUI配置

• stopall 逻辑增强：执行 /raids stopall 后会同时清除该批袭击生成的怪物。
• 袭击失败清怪：袭击结算为失败时会自动清除剩余怪物。
• 新增命令：/raids omen bottle <player> <omenId> [level]，可发放绑定自定义 Omen 的药水
• 版本兼容：低于 1.21.5 的服务端自动用普通药水作为 Omen 药水替代。
• GUI 增强：Omen 详情页新增“给予征兆药水”按钮（在“给予自己效果”下方）。
• TAB 计分板适配：
  • 引入 TAB API 依赖
  • 袭击排行显示时临时关闭 TAB 计分板，结束后恢复，缓解 Sidebar 冲突闪烁问题。
• Omen 药水增强：
  • 支持自定义显示名（语言文件 omen.bottle_item_name）
  • 支持 Lore 列表配置（omen.bottle_lore）
  • 饮用后按自定义 Omen 逻辑生效。

• 改进了插件袭击的生成逻辑，优化性能