原创 娱乐 AdventureEffect 新版本3.0.0支持全版本 — ⚔️击败特效与攻击粒子效果插件✨ 3.0.0

[MD] # AdventureEffect Minecraft 战斗特效与方块短音效插件。 > 版本：3.0.0 > 游戏版本：1.20.1-1.20.6、1.21-1.21.11、26.1-26.2 > 核心：Spigot、Paper、Purpur、Leaf 兼容核心 > 插件字节码：Java 17 > 可选依赖：PlaceholderAPI、LuckPerms AdventureEffect 提供击败特效、攻击特效、击败音效以及破坏和放置方块音效。玩家通过 GUI 选择效果，每个效果均可使用独立权限控制。 [/MD]


[MD] ## 功能 | 分类 | 数量 | 说明 | |---|---:|---| | 击败特效 | 69 | 击杀玩家后在死亡位置播放粒子、闪电或附带声音 | | 攻击特效 | 40 | 攻击实体时播放粒子，支持近战和投射物 | | 击败音效 | 45 | 支持低、中、高三档声调 | | 方块短音效 | 50 | 破坏和放置分别选择、分别授权 | 其他功能： - GUI 分页、试听、权限锁定、取消选择和全部重置 - 创造模式不触发方块音效 - 方块类型黑名单 - 破坏和放置音效可分别设置仅本人或附近玩家可听 - 材质与 Lore 关键词触发效果 - 本地数据保存或 MySQL、Redis 跨服同步 - PlaceholderAPI 占位符 - bStats 匿名统计 - 管理员上线版本与联系信息推送 跳跃和 Shift 音效已取消，旧配置或数据库中的相关字段不会再触发。 ## 安装 1. 将 `AdventureEffect-3.0.0-universal.jar` 放入服务端的 `plugins` 目录。 2. 按服务端核心要求配置 Java。26.1 及以上服务端需要 Java 25。 3. 重启服务端生成默认配置。 4. 输入 `/ae` 打开 GUI。 PlaceholderAPI 为可选依赖。`/ae grant` 和 `/ae revoke` 需要 LuckPerms；也可以使用其他权限插件直接设置权限节点。 ## 支持环境 | Minecraft | 核心 | 服务端 Java | |---|---|---:| | 1.20.1-1.20.6 | Spigot、Paper、Purpur、Leaf | 按核心要求 | | 1.21-1.21.11 | Spigot、Paper、Purpur、Leaf | 按核心要求 | | 26.1、26.1.1、26.1.2、26.2 | Paper、Purpur、Leaf 及兼容 Bukkit 核心 | Java 25 及以上 | 发行版只有一个 Universal JAR，不需要为不同游戏版本更换插件文件。 Leaf 按 Paper 插件兼容核心处理，建议在目标构建上先测试。DeerFoliaPlus 使用 Folia 区域线程模型，3.0.0 暂未正式支持。 ## 命令 | 命令 | 权限 | 说明 | |---|---|---| | `/ae`、`/ae open` | `adventureeffect.use` | 打开 GUI | | `/ae reload` | `adventureeffect.admin` | 重载配置 | | `/ae list` | `adventureeffect.admin` | 列出全部效果和音效 ID | | `/ae grant <玩家> <类型> <ID>` | `adventureeffect.admin` | 通过 LuckPerms 授权 | | `/ae revoke <玩家> <类型> <ID>` | `adventureeffect.admin` | 撤销权限并清除对应选择 | | `/ae help` | 无 | 显示帮助 | 可用类型：`kill`、`attack`、`sound`、`break`、`place`。 ```text /ae grant Steve kill lightning /ae grant Steve attack flame_trail /ae grant Steve sound bell_toll /ae grant Steve break stone_button /ae grant Steve place arrow_tick /ae revoke Steve break stone_button /ae reload ``` ## 权限 | 权限 | 默认 | 说明 | |---|---|---| | `adventureeffect.use` | 所有玩家 | 打开和使用 GUI | | `adventureeffect.admin` | OP | 管理命令和上线推送 | | `adventureeffect.kill.<ID>` | 无 | 解锁击败特效 | | `adventureeffect.attack.<ID>` | 无 | 解锁攻击特效 | | `adventureeffect.sound.<ID>` | 无 | 解锁击败音效 | | `adventureeffect.block-break.<ID>` | 无 | 解锁破坏方块音效 | | `adventureeffect.block-place.<ID>` | 无 | 解锁放置方块音效 | LuckPerms 权限组示例： ```text lp group vip permission set adventureeffect.kill.lightning true lp group vip permission set adventureeffect.attack.* true lp group vip permission set adventureeffect.sound.* true lp group vip permission set adventureeffect.block-break.* true lp group vip permission set adventureeffect.block-place.* true ``` ## GUI 主菜单为 27 格： | 槽位 | 功能 | |---:|---| | 10 | 击败特效 | | 12 | 攻击特效 | | 14 | 击败音效 | | 16 | 方块音效 | | 22 | 重置全部 | 方块音效分类菜单： | 槽位 | 功能 | |---:|---| | 11 | 破坏方块音效 | | 15 | 放置方块音效 | | 22 | 返回主菜单 | 选择菜单为 54 格，每页显示 28 个项目。导航槽位为返回 45、上一页 46、取消 49、下一页 52；击败音效使用 53 切换声调。 GUI 标题、大小和槽位均可在 `menus/gui-layout.yml` 修改。 ## 效果库 效果定义位于以下文件： | 文件 | 内容 | 数量 | |---|---|---:| | `ae/effects-kill.yml` | 击败特效 | 69 | | `ae/effects-attack.yml` | 攻击特效 | 40 | | `ae/effects-sound.yml` | 击败音效 | 45 | | `ae/action-sounds.yml` | 破坏和放置方块音效 | 50 | 使用 `/ae list` 可查看当前加载的全部 ID。每个项目的名称、说明、图标、粒子、声音、音量和音调均可在对应 YAML 文件中调整。 ## 攻击特效 攻击特效在实体受击位置播放，支持玩家直接攻击以及箭矢等投射物。默认包含元素、自然、彩色尘埃和特殊粒子四类，共 40 个。 高频战斗服务器应控制单次粒子数量，通常建议每次 5-15 个。 ## 击败音效 击败音效共 45 个，玩家可以在 GUI 中切换低、中、高三档声调。各音效的 `volume`、`pitch-low`、`pitch-mid` 和 `pitch-high` 可在 `ae/effects-sound.yml` 修改。 ## 方块短音效 破坏和放置共用 50 个短音效定义，但玩家选择和权限互相独立。默认包含 30 个 Note Block 音符和 20 个短促交互音。 ### 创造模式和方块黑名单 ```yaml settings: action-sound-ignore-creative: true action-sound-block-blacklist: - BEDROCK - BARRIER - COMMAND_BLOCK ``` 黑名单使用 Bukkit Material 名称，不区分大小写，也支持 `minecraft:stone` 写法。被其他插件取消的方块事件不会播放音效。 ### 个人和附近模式 ```yaml settings: action-sound-playback: block-break: mode: PERSONAL radius: 16.0 block-place: mode: NEARBY radius: 12.0 ``` - `PERSONAL`：仅操作者听到。 - `NEARBY`：指定半径内的玩家可以听到。 - `radius`：仅在 `NEARBY` 下生效，有效范围为 1-64 格。 附近模式使用方块中心作为音源，不会向全服广播。 ## Lore 效果 `ae/lore-effects.yml` 可以根据物品材质和 Lore 关键词绑定击败、攻击或击败音效。主手优先，副手补充主手没有提供的类型；Lore 效果优先于玩家的全局选择。 ```yaml lore-effects: DIAMOND_SWORD: - lore: "击败效果-雷电" kill-type: lightning - lore: "攻击效果-火焰" attack-type: flame_trail - lore: "雷霆之怒" kill-type: lightning attack-type: electric_shock sound-type: explosion_pop ``` 玩家手持匹配物品时输入 `/ae`，可以进入物品效果设置，分别控制 Lore 击败、攻击、音效开关及 Lore 音量。 ## 配置目录 ```text plugins/AdventureEffect/ ├── config.yml ├── messages.yml ├── playerdata.yml ├── .license-cache.yml ├── ae/ │ ├── effects-kill.yml │ ├── effects-attack.yml │ ├── effects-sound.yml │ ├── action-sounds.yml │ └── lore-effects.yml └── menus/ └── gui-layout.yml ``` 默认消息前缀为 `&f[&f&l!&f]`。大多数配置修改后执行 `/ae reload` 即可生效；MySQL、Redis、同步开关和服务器 ID 变更后需要重启。 ### 自定义击败特效 ```yaml kill-effects: my_custom_effect: name: "&a自定义特效" description: - "&7在死亡位置产生火焰粒子" icon: DIAMOND icon-glow: true particles: - type: FLAME count: 30 offset-x: 0.5 offset-y: 1.0 offset-z: 0.5 speed: 0.05 lightning-strike: false sound: ENTITY_ENDER_DRAGON_GROWL sound-volume: 1.0 sound-pitch: 1.0 ``` ### 自定义攻击特效 ```yaml attack-effects: my_attack: name: "&c自定义攻击" description: - "&7自定义攻击粒子" icon: BLAZE_POWDER particle-type: FLAME particle-count: 8 offset-x: 0.3 offset-y: 0.5 offset-z: 0.3 ``` ### 自定义击败音效 ```yaml kill-sounds: my_custom_sound: name: "&e自定义音效" description: - "&7自定义的击败音效" icon: NOTE_BLOCK sound: BLOCK_NOTE_BLOCK_PLING volume: 1.0 pitch-low: 0.5 pitch-mid: 1.0 pitch-high: 2.0 ``` ## PlaceholderAPI | 占位符 | 内容 | |---|---| | `%ae_kill%` | 当前击败特效名称 | | `%ae_attack%` | 当前攻击特效名称 | | `%ae_sound%` | 当前击败音效名称 | | `%ae_break%` | 当前破坏方块音效名称 | | `%ae_place%` | 当前放置方块音效名称 | ## 数据保存与跨服同步 默认使用 `playerdata.yml` 保存玩家的效果选择、声调、Lore 设置以及破坏和放置音效选择。 启用 `sync.enabled` 后： - MySQL 保存玩家数据 - Redis 提供缓存和 Pub/Sub 更新通知 - 每个子服应设置不同的 `sync.server-id` 跨服部署前应备份本地数据和数据库，并保证所有子服使用相同版本及效果配置。 ## bStats 插件已集成 bStats Bukkit Metrics 3.2.1，项目 ID 为 `30987`。服务器管理员可以在 `plugins/bStats/config.yml` 中关闭统计。 ## 常见问题 ### 效果不生效 确认玩家拥有对应权限，并使用 `/ae list` 检查 ID 是否已经加载。击败特效仅在玩家击杀玩家时触发。 ### 修改配置后没有变化 执行 `/ae reload`。修改数据库连接、Redis、`sync.enabled` 或 `sync.server-id` 时需要重启服务端。 ### 如何批量授权 使用权限插件设置通配符节点，例如： ```text lp group vip permission set adventureeffect.kill.* true ``` ### 如何停用某个效果 在对应 YAML 文件中删除或注释该效果配置，然后执行 `/ae reload`。 ### 玩家数据是否需要备份 需要。单服应备份 `playerdata.yml`，跨服模式应同时备份 MySQL 数据。 ## 3.0.0 更新内容 - 破坏和放置音效可独立设置 `PERSONAL` 或 `NEARBY` - 附近模式支持 1-64 格半径 - 单一 Universal JAR 支持 1.20.x、1.21.x 和 26.x - 创造模式不触发方块音效 - 方块类型黑名单 - 破坏和放置分别提供 GUI、权限及玩家选择 - 击败特效扩充至 69 个 - 击败音效扩充至 45 个 - 方块短音效扩充至 50 个 - 默认消息前缀调整为 `&f[&f&l!&f]` ## 联系信息 - 作者 QQ：823959438 - Wiki：<https://mcziyuan.com> - 感谢铁墓真赞助 16.66￥ [/MD]