# 🔱 [Vaulted] Item Flex
**Item Flex** 是一个时尚、动态的化身插件，让玩家可以**炫耀他们手中的物品**。它支持动态全息图、粒子和音效，非常适合 RPG、PvP 和希望增添一些特色的社交服务器。
---
## ✨ 特点
- ⚔️ `/itemflex` 命令来炫耀你手中的物品
- 📜 带物品和可自定义文本行的动画全息图
- 🎨 完整的 PlaceholderAPI 和十六进制颜色支持
- 🧊 适用于物品和方块
- 🌈 可自定义的粒子、音效和动画设置
- 🧱 可调节的比例、偏移量、广告牌类型、文本阴影等
- 📦 通过 `%item_lore%` 支持多行 Lore，并可控制行数限制
- 🔄 内置冷却时间和权限系统
- 🧠 干净、详细的 `config.yml` 文件，包含行内注释
---
## 🛠️ 配置亮点
- 自定义玩家周围的生成距离和偏移量
- 使用任何 PlaceholderAPI 占位符添加全息图行。
- 控制动画时长、旋转速度和缩放行为
- 配置环境和结束效果：粒子、音效、频率
- 设置文本外观，包括亮度、背景颜色、广告牌风格等
- 设置文本阴影、透明度等
---
## 📦 默认配置
查看详情
```yaml
Settings:
Permissions:
Enabled: true
Use: "itemflex.use"
Bypass-Cooldown: "itemflex.cooldownbypass"
Reload: "itemflex.reload"
Use-Cooldown: "1m"
Lore-Line-Limit: 3
Ignore-Empty-Lore-Lines: true
Line-Spacing: 0.17
Lines:
- "&6&lFLEXING"
- "%item_name%"
Spawn-Location:
Distance: 1.5
Offset:
X: 0
Y: 1.5
Z: 0
Item-Offset:
X: 0
Y: -0.17
Z: 0
Display-Transform: GUI
Item-Display-Scale: 0.75
Block-Display-Scale: 0.5
Billboard-Type: "VERTICAL"
Background-Color:
Opacity: 0
Red: 0
Green: 0
Blue: 0
Brightness:
Block: 15
Sky: 15
Text-Shadow: true
Spawn-Particle:
Particle: "GLOW"
Count: 20
Offset:
X: 0.1
Y: 0.2
Z: 0.1
Speed: 0.01
Spawn-Sound:
Sound: "ENTITY_EVOKER_CAST_SPELL"
Volume: 1.2
Pitch: 1.5
Scale-Settings:
Starting-Scale: 0.01
Scale-Increment: 0.06
Rotate-Speed: 7
Animation-Duration: 80
Disappear-Particle:
Particle: "FIREWORK"
Count: 15
Offset:
X: 0.2
Y: 0.2
Z: 0.2
Speed: 0.05
Disappear-Sound:
Sound: "BLOCK_AMETHYST_BLOCK_BREAK"
Volume: 0.8
Pitch: 1.7
Ambient-Particle:
Frequency: 10
Particle: "ENCHANT"
Count: 3
Offset:
X: 0.1
Y: 0.1
Z: 0.1
Speed: 0
Ambient-Sound:
Frequency: 20
Sound: "BLOCK_BEACON_AMBIENT"
Volume: 0.3
Pitch: 1.2
Messages:
No-Permission: "#FF5555你没有权限使用此命令。"
Must-Hold-Item: "#FFA500你必须拿着一个物品才能炫耀它！"
Flex-Active: "#FFA500你已经在使用炫耀物品了！"
Cooldown-Active: "#FFD700你还在冷却期！请等待 #FF5555%time%#FFD700 再次炫耀。"
Player-Only: "#FF4444此命令只能由玩家使用。"
Config-Reloaded: "#55FF55✔ 配置文件已成功重新加载。"
```
---
## 🔐 权限
| 节点 | 描述 |
|------|-------------|
| `itemflex.use` | 允许使用 `/itemflex` |
| `itemflex.cooldownbypass` | 跳过使用冷却时间 |
| `itemflex.reload` | 允许重新加载配置文件 |
---
## 🧩 依赖项
- ✅ 需要 **Paper 1.20+**
- 🔌 可选：[PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) 以支持动态占位符
---
## 📸 截图 / 演示
---
## 💬 需要帮助？
在 Discord @BitByLogic 处联系我，或在 GitHub 上打开一个 issue 以获取支持和建议！
