# **FunTraps – 自定义牢笼**
使用完整的区域和保护支持，为您的服务器添加有趣和战术陷阱。
一个轻量级的 Spigot/Paper 1.21+ 插件，允许您创建自定义牢笼/陷阱结构，具有可配置的皮肤和药水效果，完全集成 WorldGuard 和 ProtectionStones。
---
---
## 🧠 描述
FunTraps 允许服务器管理员配置在玩家激活的自定义陷阱。
陷阱可以是牢笼或监狱，具有可配置的方块和效果。
---
## ✨ 功能：
- 选择工具（金色斧头）用于定义区域。
- 牢笼的自定义皮肤，可在 `config.yml` 中配置。
- 每个陷阱的药水效果（支持无限和限时效果）。
- 与保护系统的集成：
- **WorldGuard**: 在被阻止的世界/区域中限制陷阱，允许它们在允许的区域中使用。
- **ProtectionStones**: 只有区域的所有者或成员才能在区域内使用陷阱。
- 高级效果管理器：处理临时和无限效果，而不会出现配置错误。
- 轻量级和模块化：没有强制性依赖项，开箱即用。
- 非常适合：
- 玩家可以互相陷阱的小游戏。
- 具有可触发陷阱的冒险地图。
- 希望添加战术技巧的生存服务器。
---
## ⚙️ 安装
1. 下载最新版本的 `FunTraps.jar`。
2. 将其放置在服务器的 `plugins/` 文件夹中。
3. （可选）安装 WorldGuard 和/或 ProtectionStones 以进行区域限制。
4. 启动或重新加载您的服务器。
---
## 🛠 配置
所有设置都位于：
```
plugins/FunTraps/config.yml.
```
### 皮肤
您可以定义具有方块和效果的多个牢笼皮肤。
示例：
```
skins:
default:
# 该皮肤的陷阱持续时间（以秒为单位）
duration: 15
# 该皮肤的陷阱冷却时间（以秒为单位）
cooldown: 15
# 动画类型：“球形”，更多即将推出...
animation: sphere
# ────────────────
# 陷阱内的物品冷却时间
# ────────────────
item-cooldowns:
ENDER_PEARL: 8 # 秒
CHORUS_FRUIT: 12
ENCHANTED_GOLDEN_APPLE: 30
GOLDEN_APPLE: 15
# ────────────────
# 放置或移除陷阱时的声音
# ────────────────
sounds:
place:
- name: minecraft:ui.toast.challenge_complete
volume: 1.0
pitch: 1.0
range: 24
category: master
- name: minecraft:entity.wither.break_block
volume: 1.0
pitch: 1.0
range: 24
category: master
remove:
- name: minecraft:block.beacon.power_select
volume: 1.0
pitch: 1.0
range: 24
category: master
- name: minecraft:block.end_portal.spawn
volume: 1.0
pitch: 1.0
range: 24
category: master
```
---
# 📜 FunTraps 命令
主命令是 **`/trap`**，包含许多子命令，分为 **管理员** 和 **玩家**。
---
## 🔧 管理员 (`trapsfun.admin`)
- **`/trap give `**
将陷阱激活物品给玩家、所有玩家或你自己。
- **`/trap tool`**
获取选择工具（金色斧头）以定义结构区域。
- **`/trap save `**
使用所选位置保存具有给定名称的结构。
- **`/trap delete `**
按名称删除保存的结构。
- **`/trap rename `**
重命名保存的结构。
- **`/trap remove `**
从玩家、所有人或你自己身上移除活动陷阱。
- **`/trap reload`**
重新加载配置和消息系统。
---
## 👤 玩家 (`trapsfun.user`)
- **`/trap skin `**
选择陷阱皮肤（如果您有使用它的权限）。
- **`/trap skins`**
列出服务器上所有可用的皮肤。
---
## 🔑 权限
- `trapsfun.admin` → 访问管理命令的完全权限。
- `trapsfun.user` → 访问与皮肤相关的命令。
- `traps.skin.` → 使用特定皮肤的权限。
- `traps.skin.*` → 使用所有皮肤的权限。
---
## 📌 注意事项
- **陷阱激活物品** 在 `config.yml` (`trap.activation-item`) 中定义。
- 选择工具标记 **位置 1 和 2** 以创建结构。
- 反馈消息在 `lang.yml` 中管理，并且可以完全自定义。
---
## 🧱 依赖项
- [✅] Spigot / Paper 1.21+
- [✅] (可选) WorldGuard (区域/世界限制)
- [✅] (可选) ProtectionStones (玩家区域支持)
---
[](https://discord.gg/Fk3Ce3eSfm)
[](https://www.paypal.com/paypalme/nmmswe)