MWEPS - 自定义武器制作器

MWEPs 是一款允许你在 Minecraft 中创建自定义武器和工具的插件！无论是能发射 500 支三叉戟的木棍，还是消耗弹药的自动机枪，亦或是召唤箭雨的榴弹，MWEPs 都能 100% 实现。

视频演示：https://streamable.com/mhrhcq

💡核心特性

• 包含 2 款默认武器，用于展示插件的强大功能。
• 内置游戏内编辑器，用于创建、修改和删除 MWEPs。
• 提供游戏内说明书，指导你如何使用编辑器。
• 可生成任意实体，并支持 NBT、速度、数量等详细设置。
• 为武器添加音效。
• 弹药消耗系统。
• 武器后坐力，甚至可以将使用者弹飞。
• 在范围内对玩家施加效果，并带有粒子轨迹。
• 对自己施加效果。
• 向玩家发射带有效果的光线。
• 使用追踪器效果追踪玩家。
• 投掷带有榴弹效果的物品。

🎮命令列表

• /mweps generate <mwep> <count> - 生成指定数量的 MWEP 物品。
• /mweps give <player> <mwep> <count> - 给予玩家指定数量的 MWEP 物品。
• /mweps reload - 重新加载 weapons.yml 和 config.yml 配置文件。
• /mweps editor help - 获取编辑器使用说明书。
• /mweps editor new <name> - 创建一个新的 MWEP 模板。
• /mweps editor modify <path> <data> - 修改现有 MWEP 的指定路径值。
• /mweps editor list - 列出所有 MWEPs。
• /mweps editor delete <path> - 删除一个 MWEP 或其子路径。
• /mweps editor inject <path> <value> - 向 weapons.yml 中注入新的路径和值。
• /mweps editor view <mwep> - 查看指定 MWEP 的所有路径值。
• /mweps editor copy <old> <new> - 将旧路径下的所有配置复制到新路径。

🔧使用教程

MWEPs 的配置存储在 MWEPs 文件夹下的 weapons.yml 文件中，基本结构如下：

ATrident:
  Data: '{Enchantments:[{id:"loyalty",lvl:3}]}'
  Weapon: TRIDENT
  Consumable: false
  RightClick:
    UseTime: 0
    Ammo: ARROW
    AmmoUse: 0
    AmmoName: trident
    Sound:
      Name: ENTITY_ARROW_SHOOT
      Pitch: 1
      Volume: 1
    Spawn:
      Spread: 5
      Count: 50
      Name: SPECTRAL_ARROW
      Velocity: 5
      Data: '{damage:10,life:1180,PierceLevel:100,pickup:2}'

配置项说明

• ASign 和 ATrident：MWEP 的名称。
• Consumable：决定 MWEP 使用时是否会消耗。
• Data：附加到 MWEP 物品上的 NBT 数据。
• Weapon：生成 MWEP 所基于的物品类型。
• UseTime：使用武器的冷却时间（单位：游戏刻）。
• RightClick 和 LeftClick：定义玩家右键或左键点击时的行为。
• Ammo：指定消耗的弹药类型（需持于副手）。
• AmmoUse：每次射击消耗的弹药数量。
• AmmoName：弹药必须具有的名称才能被使用。

编辑器使用

使用命令 /mweps editor <子命令> 访问游戏内编辑器。

• help - 获取说明书。
• new <name> - 创建一个空白的 MWEP 模板。
• modify <path> <data> - 修改 MWEP 中已存在的值。对于不存在的值，请使用 inject。
• delete <name/path> - 删除整个 MWEP 或特定路径。
• 例如：/mweps editor delete ATrident 删除整个 ATrident。
• /mweps editor delete ATrident.Data 仅删除其 Data 值。
• list - 列出所有 MWEPs。
• inject <path> <data> - 向 weapons.yml 中任意位置注入新值。
• view <name> - 查看指定 MWEP 的所有值。
• copy <existing> <new> - 复制一个路径或整个 MWEP 的配置。

⭐权限节点

• cato.mweps.generate - 允许使用 /mweps generate 命令。
• cato.mweps.give - 允许使用 /mweps give 命令。
• cato.mweps.editor - 允许使用 /mweps editor 命令。
• cato.mweps.editor.new - 允许使用 /mweps editor new。
• cato.mweps.editor.modify - 允许使用 /mweps editor modify。
• cato.mweps.editor.delete - 允许使用 /mweps editor delete。
• cato.mweps.editor.list - 允许使用 /mweps editor list。
• cato.mweps.editor.inject - 允许使用 /mweps editor inject。
• cato.mweps.editor.view - 允许使用 /mweps editor view。
• cato.mweps.editor.copy - 允许使用 /mweps editor copy。
• cato.mweps.reload - 允许使用 /mweps reload。
• cato.mweps.weapon.[Weapon Name] - 授予玩家使用特定 MWEP 的权限（需在配置中启用）。

✨配置文件

Disable-IFrames: true
Require-Perms-to-Use-MWEP: false
Add-Owner-to-Projectiles: true
Disable-Projectiles-Breaking-Hanging-Entities: true

配置说明

• Disable-IFrames：移除被 MWEP 伤害的实体的无敌时间，使其可以被连续击中（类似零刻 PVP）。
• Require-Perms-to-Use-MWEP：要求玩家拥有 cato.mweps.weapon.[Name] 权限才能使用对应的 MWEP。
• Add-Owner-to-Projectiles：将 MWEP 的使用者设为其发射的弹射物的所有者。
• Disable-Projectiles-Breaking-Hanging-Entities：防止 MWEP 的弹射物破坏物品展示框等悬挂实体。

❓效果功能示例 (1.5 版本)

以下配置展示了效果（Effect）功能的应用，例如激光和范围效果：

Laser-Pistol:
  Data: ''
  Weapon: GOLDEN_SHOVEL
  Consumable: false
  RightClick:
    UseTime: 10.0
    Ammo:
      Type: ARROW
      Use: 1
      Name: Fusion-Cell
    Sound:
      Name: ENTITY_FIREWORK_ROCKET_BLAST
      Pitch: 4
      Volume: 3
    Effect:
      Other:
        Aim:
          Type: HARM
          Amplifier: 1.0
          Duration: 1
          Icon: false
          Particles: false
          Range: 100.0
        Ray:
          Particle: TOTEM
          Density: 1
        Hit:
          Particle: FLASH
          Density: 1.0

❓追踪器/丢弃/冷却显示示例 (1.6 版本)

以下配置展示了追踪（Track）、丢弃（Drop）和冷却显示（DisplayCooldown）功能：

Player-Finder:
  Data: ''
  Weapon: SCUTE
  Consumable: false
  Drop: false
  DisplayCooldown: true
  RightClick:
    Track:
      Type: PLAYER
      Range: 2000
    Ray:
      Particle: DRIPPING_OBSIDIAN_TEAR
      Density: 25.0
      Range: 2
    UseTime: 200.0

❓榴弹示例 (1.7 版本)

以下配置展示了榴弹（Grenade）和爆炸（Explosion）效果：

Grenade:
  Data: ''
  Weapon: SHEARS
  Consumable: true
  RightClick:
    Sound:
      Name: ENTITY_ARROW_SHOOT
      Pitch: 1
      Volume: 1
    Spawn:
      Count: 1.0
      Name: DROPPED_ITEM
      Velocity: 1.0
      Data: '{PickupDelay:32767,Item:{id:"minecraft:shears",Count:1b}}'
      Spread: 0.1
    Grenade:
      Count: 300.0
      Name: ARROW
      Velocity: 5.0
      Data: '{damage:2,pickup:0,life:1180}'
      Spread: 1.0
      Timer: 200.0
    Explosion:
      Power: 2.0
      Fire: false
      Break: false
    UseTime: 3

🔧参考链接

• 完整示例配置：https://pastebin.com/bKenqyWE
• 实体类型列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
• 音效列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
• 物品材料列表：https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
• 药水效果列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffect.html
• 粒子效果列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html

欢迎提出任何建议或报告 Bug！这是我的第一个公开插件！