文档
[MD][/CENTER] # 横扫之刃系统使用手册 ## 功能介绍 本插件为基岩版实现 Java 版的「横扫之刃」附魔效果。由于基岩版没有横扫之刃附魔，本插件将「抢夺」附魔的等级映射为横扫之刃等级。 **核心机制：** - 手持剑攻击时，会对主目标周围的实体造成范围伤害 - 抢夺附魔等级 = 横扫之刃等级 - 无抢夺附魔时也可触发横扫，但伤害固定为1点 - 完全模拟 Java 版的攻击冷却机制 ## 触发条件 1. 手持剑类武器 2. 玩家站在地面上（可配置） 3. 玩家移动速度低于阈值（可配置） 4. 攻击冷却完成（默认6ms） ## 伤害计算 **Java 版公式：** - 无附魔：固定 1 点伤害 - 有附魔：`1 + 等级 × (武器伤害 × 0.5 + 1) / (等级 + 1)` **示例（钻石剑 7 点伤害）：** | 横扫等级 | 横扫伤害 | |---------|---------| | 0级(无附魔) | 1.00 | | 1级 | 3.25 | | 2级 | 4.00 | | 3级 | 4.375 | ## 文件路径 - 配置文件：`./Meowdata/sweepingEdge/config.json` - 日志文件：`./Meowdata/sweepingEdge/logs/debug.log` ## 配置文件说明 ```json { // 主开关 "enabled": true, // 抢夺附魔ID（基岩版为14） "lootingEnchantId": 14, // 横扫攻击范围 "sweepRange": { "horizontal": 1.0, // 水平范围（格） "vertical": 0.25 // 垂直范围（格） }, // 触发条件 "triggerConditions": { "requireOnGround": true, // 是否需要在地面上 "maxSpeedForSweep": 0.11, // 最大移动速度阈值 "checkMoveSpeed": true // 是否检查移动速度 }, // 伤害配置 "damageSettings": { "damageType": 1, // 伤害类型（1 = 实体攻击） "damageMultiplier": 1.0 // 伤害倍率 }, // 冷却配置 "cooldownSettings": { "sweepCooldown": 625, // 横扫冷却时间（毫秒） "enableCooldown": true // 是否启用冷却 }, // 粒子效果配置 "particleSettings": { "enabled": true, "particleType": "minecraft:basic_crit_particle", "arcRadius": 1.0, // 弧形半径 "arcAngle": 120, // 弧形角度（度） "arcParticleCount": 8, // 粒子数量 "sweepDelay": 15 // 粒子延迟（毫秒） }, // 剑类物品列表 "swordItems": [ "minecraft:wooden_sword", "minecraft:stone_sword", "minecraft:iron_sword", "minecraft:golden_sword", "minecraft:diamond_sword", "minecraft:netherite_sword" ], // 剑的基础攻击伤害 "swordDamageMap": { "minecraft:wooden_sword": 4, "minecraft:stone_sword": 5, "minecraft:iron_sword": 6, "minecraft:golden_sword": 4, "minecraft:diamond_sword": 7, "minecraft:netherite_sword": 8 }, // 免疫横扫攻击的实体类型 "immuneEntities": [ "minecraft:item", "minecraft:xp_orb", "minecraft:arrow", "minecraft:thrown_trident", "minecraft:snowball", "minecraft:egg", "minecraft:ender_pearl", "minecraft:fireball", "minecraft:small_fireball", "minecraft:wither_skull", "minecraft:fishing_hook", "minecraft:lightning_bolt", "minecraft:area_effect_cloud", "minecraft:evocation_fang", "minecraft:falling_block", "minecraft:tnt" ], // 位置追踪间隔（毫秒） "positionTrackInterval": 100 } ``` ## 配置说明 ### 范围调整 - `sweepRange.horizontal`：增大可扩大横扫水平范围 - `sweepRange.vertical`：增大可扩大横扫垂直范围 ### 触发条件调整 - 设置 `requireOnGround: false` 可在空中触发横扫 - 设置 `checkMoveSpeed: false` 可在移动时触发横扫 - 调整 `maxSpeedForSweep` 可改变速度阈值 ### 冷却调整 - `sweepCooldown`：Java 版默认 625ms，可调整 - 设置 `enableCooldown: false` 可禁用冷却 ### 伤害调整 - `damageMultiplier`：设为 1.5 则伤害提升 50% ### 粒子效果 - 设置 `particleSettings.enabled: false` 可关闭粒子 - 可更换 `particleType` 为其他粒子类型 ### 添加自定义剑 在 `swordItems` 数组中添加物品ID，并在 `swordDamageMap` 中设置对应伤害值。 ## 注意事项 1. 抢夺附魔会被用作横扫之刃，不影响原有掉落加成 2. 连续快速攻击会重置冷却，无法触发横扫 3. 日志文件可用于调试，生产环境建议关闭 debug 日志 --- > 技术支持：伊希娅 QQ3529832433 [/MD]
[MD][/CENTER] # 横扫之刃系统使用手册 ## 功能介绍 本插件为基岩版实现 Java 版的「横扫之刃」附魔效果。由于基岩版没有横扫之刃附魔，本插件将「抢夺」附魔的等级映射为横扫之刃等级。 **核心机制：** - 手持剑攻击时，会对主目标周围的实体造成范围伤害 - 抢夺附魔等级 = 横扫之刃等级 - 无抢夺附魔时也可触发横扫，但伤害固定为1点 - 完全模拟 Java 版的攻击冷却机制 ## 触发条件 1. 手持剑类武器 2. 玩家站在地面上（可配置） 3. 玩家移动速度低于阈值（可配置） 4. 攻击冷却完成（默认6ms） ## 伤害计算 **Java 版公式：** - 无附魔：固定 1 点伤害 - 有附魔：`1 + 等级 × (武器伤害 × 0.5 + 1) / (等级 + 1)` **示例（钻石剑 7 点伤害）：** | 横扫等级 | 横扫伤害 | |---------|---------| | 0级(无附魔) | 1.00 | | 1级 | 3.25 | | 2级 | 4.00 | | 3级 | 4.375 | ## 文件路径 - 配置文件：`./Meowdata/sweepingEdge/config.json` - 日志文件：`./Meowdata/sweepingEdge/logs/debug.log` ## 配置文件说明 ```json { // 主开关 "enabled": true, // 抢夺附魔ID（基岩版为14） "lootingEnchantId": 14, // 横扫攻击范围 "sweepRange": { "horizontal": 1.0, // 水平范围（格） "vertical": 0.25 // 垂直范围（格） }, // 触发条件 "triggerConditions": { "requireOnGround": true, // 是否需要在地面上 "maxSpeedForSweep": 0.11, // 最大移动速度阈值 "checkMoveSpeed": true // 是否检查移动速度 }, // 伤害配置 "damageSettings": { "damageType": 1, // 伤害类型（1 = 实体攻击） "damageMultiplier": 1.0 // 伤害倍率 }, // 冷却配置 "cooldownSettings": { "sweepCooldown": 625, // 横扫冷却时间（毫秒） "enableCooldown": true // 是否启用冷却 }, // 粒子效果配置 "particleSettings": { "enabled": true, "particleType": "minecraft:basic_crit_particle", "arcRadius": 1.0, // 弧形半径 "arcAngle": 120, // 弧形角度（度） "arcParticleCount": 8, // 粒子数量 "sweepDelay": 15 // 粒子延迟（毫秒） }, // 剑类物品列表 "swordItems": [ "minecraft:wooden_sword", "minecraft:stone_sword", "minecraft:iron_sword", "minecraft:golden_sword", "minecraft:diamond_sword", "minecraft:netherite_sword" ], // 剑的基础攻击伤害 "swordDamageMap": { "minecraft:wooden_sword": 4, "minecraft:stone_sword": 5, "minecraft:iron_sword": 6, "minecraft:golden_sword": 4, "minecraft:diamond_sword": 7, "minecraft:netherite_sword": 8 }, // 免疫横扫攻击的实体类型 "immuneEntities": [ "minecraft:item", "minecraft:xp_orb", "minecraft:arrow", "minecraft:thrown_trident", "minecraft:snowball", "minecraft:egg", "minecraft:ender_pearl", "minecraft:fireball", "minecraft:small_fireball", "minecraft:wither_skull", "minecraft:fishing_hook", "minecraft:lightning_bolt", "minecraft:area_effect_cloud", "minecraft:evocation_fang", "minecraft:falling_block", "minecraft:tnt" ], // 位置追踪间隔（毫秒） "positionTrackInterval": 100 } ``` ## 配置说明 ### 范围调整 - `sweepRange.horizontal`：增大可扩大横扫水平范围 - `sweepRange.vertical`：增大可扩大横扫垂直范围 ### 触发条件调整 - 设置 `requireOnGround: false` 可在空中触发横扫 - 设置 `checkMoveSpeed: false` 可在移动时触发横扫 - 调整 `maxSpeedForSweep` 可改变速度阈值 ### 冷却调整 - `sweepCooldown`：Java 版默认 625ms，可调整 - 设置 `enableCooldown: false` 可禁用冷却 ### 伤害调整 - `damageMultiplier`：设为 1.5 则伤害提升 50% ### 粒子效果 - 设置 `particleSettings.enabled: false` 可关闭粒子 - 可更换 `particleType` 为其他粒子类型 ### 添加自定义剑 在 `swordItems` 数组中添加物品ID，并在 `swordDamageMap` 中设置对应伤害值。 ## 注意事项 1. 抢夺附魔会被用作横扫之刃，不影响原有掉落加成 2. 连续快速攻击会重置冷却，无法触发横扫 3. 日志文件可用于调试，生产环境建议关闭 debug 日志 --- > 技术支持：伊希娅 QQ3529832433 [/MD]
