TWINGS - 粒子翅膀装饰插件

💡TWINGS — 粒子翅膀插件

TWINGS 是一款简洁而强大的粒子特效装饰插件，适用于 Minecraft 1.16+ 服务器。它的核心功能是为玩家在背后生成精美的粒子翅膀，同时提供了丰富的自定义选项，让你可以设计独特的图案、动画，并通过直观的 GUI 进行管理。

---

🎮主要特性

• 自定义翅膀图案：使用像素画风格创建专属的翅膀样式。
• 翅膀 GUI 菜单：在游戏内浏览并选择所有已创建的翅膀。
• 创作者署名：每个翅膀均可标注设计者。
• 独立权限节点：为每款翅膀设置使用权限。
• 开发者 API：方便开发者进行功能集成与扩展。
• 动态动画翅膀：支持创建带有动画效果的翅膀。
• 多粒子同时装备：可同时装备多个粒子效果。
• 限时或永久翅膀：可为玩家授予持续到死亡或指定时长的翅膀效果。
• Discord 支持社区：需要帮助？请加入 Discord。

---

🔧命令列表

• /twings – 打开翅膀选择 GUI。
• /twings list – 列出所有可用的翅膀。
• /twings equip [twing] – 装备指定的翅膀。
• /twings unequip – 卸下当前装备的所有翅膀。
• /twings add [twing] – 在不卸下现有翅膀的情况下，额外装备一个翅膀。
• /twings give [玩家名] [twing] [时间] – 给予指定玩家一个翅膀，持续时间可为具体时长或 untildeath（直到死亡）。
• /twings preview – 打开预览 GUI，可在当前位置预览所有翅膀效果。
• /twings create – 打开创建 GUI，将 pictures 文件夹中的图片（最大 70x70 像素）转换为翅膀配置文件。

关于 `/twings create` 命令

此命令会读取 plugins/TWINGS/pictures/ 目录下的图片文件，并通过 GUI 将其转换为翅膀配置。这是创建自定义翅膀最快捷的方式。

---

✨内容示例

TWINGS 支持创建多种类型的粒子装饰，不仅限于翅膀：

• 翅膀 (Wings)
• 披风 (Capes)
• 表情 (Emotes)
• 天使光环 (Angel Halo)
• 动画效果 (Animated)
• 动画示例：https://strace.dev/winggif.gif
• 人体模型 (Mannequin)

---

⭐开发者 API

TWINGS 提供了易于集成的 API，供开发者调用其核心功能，实现自定义扩展或与其他插件联动。

---

❓配置文件详解

config.yml (主配置)

Prefix: '&7[ &e&lTWINGS&7 ] '
Wings:
  showwithperms: false
  updaterate: 3
Menu:
  title: '%prefix% &9Choose your Wings!'
  symbol: ⏹
  creator: '&c&lCreator:&f %creator%'
  permissions: '&7unlocked: [ %perms%&7]'
  preview: true
  haspermission: '&aYES'
  nopermission: '&cNO'
  max equipped twings: 2

主要配置项说明：

• max equipped twings：玩家可同时装备的最大翅膀数量。
• updaterate：粒子效果的更新频率（刻数）。

vampire.yml (翅膀配置示例)

此文件展示了如何定义一个名为“吸血鬼翅膀”的粒子效果。

# 在此定义你的粒子代码。在图案（Pattern）中使用这些代码。
# “x”代表空气（无粒子），请勿将“X”用作粒子代码。
# 对于彩色粒子（如 REDSTONE），使用格式：`粒子代码:(R,G,B):大小` 或 `粒子代码:速度`
Particles:
  B: REDSTONE:(24,24,24)
  G: REDSTONE:(128,128,128)
  S: REDSTONE:(48,48,48)
Item:
  Material: MAP
  Name: '&cVampire wings'
  permission: twings.vampire # 删除此行表示无需权限
  category: wings
  creator: PixelStrace
DegreeAddition: 10
SneakingDegreeAddition: 20
ShowWhenRunning: false
tilt: 0
rotation: 0
moveback: 0
moveup: 0.3
mirrow: true
Animated: false
spacing: 0.07
exclude:
  - x
pattern: # 这是定义翅膀形状的像素图案
  - B,B,x,x,x,x,x,x,x,x,x,x
  - x,B,B,B,x,x,x,x,x,x,x,x
  # ... 更多图案行

lang.yml (语言文件)

插件支持多语言。以下是英文和中文（繁体，由 @cherry6201 翻译）示例配置。

show messages: true
equip: '%prefix% &9you have equipped %WingName%!'
unequip: '%prefix% &9you have unequipped %WingName%!'
no such command: '%prefix% &cSorry, there is no such command.'
# 更多消息...

中文（繁体）翻译节选：

equip: '%prefix% &9你已經套用 %WingName%!'
unequip: '%prefix% &9你沒有套用 %WingName%!'
no such command: '%prefix% &c無效指令.'

CategoryGUI.yml (分类GUI配置)

此文件用于配置翅膀选择菜单中的分类界面。

enabled: true
title: '&bChoose the category!'
rows: 5
category:
  wings:
    displayname: '&d&lWINGS'
    lore:
      - '&8Here you can find all wing particles!'
      - '&e&oLeftclick to open!'
    material: ELYTRA
    glow: false
    slot: 13
  # 可继续添加 logos, flags 等分类

---

🔧教程与资源

• 如何创建新翅膀：详细教程请访问 https://strace.dev/index.php/create_wing_tutorial/。
• 插件演示视频：由 Produktecheck 制作。

---

💡最后的话

希望你喜欢这款插件！如果你在创建自己的翅膀时遇到任何问题，或者有任何建议，欢迎通过 Discord 联系我。也别忘了留下你的评价！