CustomWings [Opensource] - CustomWings - 自定义粒子翅膀

CustomWings

CustomWings 是一款允许玩家在游戏中装备华丽的粒子翅膀，向朋友展示个性的插件。它内置了预设翅膀，同时也支持你自由创建更多样式，甚至制作动态动画翅膀。所有翅膀均可通过配置文件创建，插件还提供了游戏内编辑器 GUI，让你可以实时调整翅膀的各项设置。

💡命令与权限

主要命令

• /customwings 或 /cw 或 /w - 打开翅膀选择 GUI。
• 所需权限: customwings.command

子命令

• /customwings setwing <玩家名> <翅膀ID> - 为指定玩家设置翅膀。
• 所需权限: customwings.setwing
• /customwings editor 或 /cw edit 或 /cw e - 打开翅膀编辑器 GUI。
• 所需权限: customwings.editor
• /customwings preview 或 /cw p - 将当前装备的翅膀从玩家身上分离，使其悬浮在空中。
• 所需权限: customwings.preview
• /customwings reload 或 /cw r - 重载 CustomWings 插件。
• 所需权限: customwings.reload
• /customwings takeawaywing <玩家名> <翅膀ID> - 收回玩家之前购买过的翅膀。
• 所需权限: customwings.takeawaywings

翅膀权限

• 每个翅膀的独立使用权限格式为：customwings.wing.WINGID

🎮创建翅膀

翅膀通过配置文件进行创建和定义。所有翅膀配置文件都必须放置在 wings 文件夹内，且配置文件的名称即为该翅膀的 ID（用于权限或 setwing 命令）。

配置示例与说明

以下是一个翅膀配置文件的示例（YAML 格式）。CustomWings 的标准配置中包含更多范例。

# 是否在玩家移动时显示翅膀。若为 false，则玩家开始移动时停止生成翅膀粒子。
showWhenMoving: true

# 允许装备此翅膀的世界列表。使用 "all" 表示所有世界。
whitelistedWorlds:
  - "all"
  - "world"
  - "world_nether"
  - "world_the_end"

# 经济系统设置（需要 Vault 插件，未找到 Vault 时将自动禁用）
economy:
  # 支付价格类型："economy"（Vault 经济）或 "token"（TokenManager）
  priceType: "economy"
  # 解锁翅膀的价格：-1 为不可购买，0 为免费
  price: 10

# 在菜单中显示的物品设置
menuItem:
  # 为 true 则不在翅膀选择菜单中显示（仍可通过 /wings setwing 命令装备）
  hideInMenu: false
  name: "&5Example Wing"
  material: DIRT
  slot: 0
  page: 1
  loreWhenEquipped:
    - "&6You have the &5Example Wing &6equipped"
  loreWhenUnequipped:
    - "&3You do not have the &5Example Wing &3equipped"
  loreWhenNoPermission:
    - "&cYou do not own the &5Example Wing"
  loreWhenCanBuy:
    - "&eYou can buy this for ${PRICE}"

# 翅膀粒子效果的核心设置
wing:
  startVertical: -0.1
  startHorizontalOffset: 0
  startDistanceToPlayer: 0.3
  distanceBetweenParticles: 0.1
  timer: 2
  flapAnimation: true
  flapSpeed: 4
  startOffset: 30
  stopOffset: 70
  onlyOneSide: false

  # 粒子布局网格。使用 '-' 表示不生成粒子，其他字符必须在下面的 `particles` 部分有对应定义。
  # 只需设计翅膀的右侧，它会自动镜像到左侧。
  particleLayout:
    1: "-,-,-,-,x,x,x,-,-,-"
    2: "-,-,-,x,x,x,x,x,-,-"
    3: "-,-,x,x,x,x,x,x,x,-"
    # ... (更多行)

  # 定义在 particleLayout 中使用的字符所对应的粒子效果
  particles:
    x:
      particle: "CRIT_MAGIC"
      distance: 0
      height: 0
      angle: 0
      speed: 0
      color: 0xFFFFFF
      noteColor: 6
      blockType: DIRT

配置管理提示

• 修改主配置或翅膀配置后，可使用 /customwings reload 命令重载。
• 删除翅膀或更改配置文件名称后，需要重启服务器。
• 粒子名称参考：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html。如果使用了无效的粒子名称，将使用 Barrier 粒子替代。

🔧相关工具

NoahOrtega 开发了一个辅助程序，可以将 PNG 像素画图像转换为适用于 CustomWings 配置的文本格式，方便翅膀创作。

• 程序地址：https://github.com/NoahOrtega/PixToText
• 请注意：CustomWings 插件本身与此程序无关联。

❓支持与联系

• 请勿在评论区域寻求技术支持。
• 如需帮助，请在讨论帖中留言或加入 Discord 服务器：https://discord.gg/G8nG65S

> 注意：部分网络上的演示视频基于旧版 CustomWings 录制，某些功能可能已发生变化。