Paper/Purpur 1.21+ 的自定义笼子、陷阱与 Plast 墙壁
FunTraps 为 Minecraft 服务器添加了临时的战术结构。玩家可以使用可配置的激活物品、结构、皮肤、药水效果、声音和视觉反馈来部署自定义的笼子、陷阱和方向性 Plast 墙壁。
使用 .schem 或 YAML 结构创建您自己的陷阱和 Plast 设计,配置其行为,分配皮肤,管理有限或无限的使用次数,并精确控制玩家可以在何处使用它们。
FunTraps 专为快节奏的战斗机制而设计,不会在世界中留下永久性破坏。
- 生命窃取 (Lifesteal)
- 生存模式
- 阵营战 (Factions)
- 练习模式
- KitPvP
- 监狱模式
- PvP 活动
- 小游戏
- 自定义战斗竞技场
兼容性
- 服务器软件: Paper / Purpur 1.21+
- Java: 推荐 Java 21
- 存储: YAML、SQLite 或 MySQL
- 语言: 英语、西班牙语和俄语
依赖项与可选集成
FunTraps 的核心陷阱、Plast、皮肤、存储和恢复系统无需额外插件即可运行。
- WorldEdit / FAWE: 创建、保存和管理自定义
.schem 结构。
- WorldGuard: 世界和区域限制、自定义标志和保护规则。
- ProtectionStones: 基于认领(Claim)的所有者、成员、管理员和访客权限。
- PlaceholderAPI: 在菜单、需求、消息和自定义物品文本中使用占位符。
皮肤商店要求
内置的皮肤购买菜单配置为使用 PlayerPoints。
要完全按照内置方式运行默认商店,请安装:
-
PlaceholderAPI
-
PlayerPoints
-
PlaceholderAPI 解析菜单中的 %playerpoints_points_formatted%。
-
PlayerPoints 提供玩家余额和 /points take <player> <amount> 扣费命令。
-
默认确认菜单在购买完成前会检查玩家的余额。
-
FunTraps 即使没有这些插件也能正常工作,但内置的 PlayerPoints 商店必须在启用前重新配置。
主要功能
自定义陷阱与笼子
- 使用自定义
.schem 或 YAML 结构创建临时笼子。
- 配置持续时间、冷却时间、激活物品、声音、操作栏和 Boss 栏。
- 对拥有者和被困玩家应用可配置的药水效果。
- 配置玩家在处于活跃陷阱内时的物品冷却时间。
- 自动计算中心点以保存陷阱结构。
- 配置每个玩家活跃结构的数量限制。
- 使用自定义放置、移除和环境音效。
Plast 墙壁
- 使用专用激活物品部署临时定向墙壁。
- 为每种皮肤和方向创建独立的 Plast 结构。
- 支持水平、对角线和垂直墙壁变体。
- 配置独立的持续时间和冷却设置。
- 使用单独的工具、保存命令、皮肤和移除命令。
可用的 Plast 方向:
north
northeast
east
southeast
south
southwest
west
northwest
up
down
示例:
/plast save cruel northeast
这将保存如下变体:
cruel_northeast.yml
皮肤与使用次数
- 自定义陷阱和 Plast 皮肤。
- 无限、有限和虚拟皮肤使用次数。
- 可选的物理令牌可转换为虚拟使用次数。
- 内置皮肤浏览器、购买菜单和确认菜单。
- 已购买的皮肤可直接授予为虚拟使用次数。
- 在菜单中显示选定的皮肤状态和剩余使用次数。
- Shift + 右键点击激活物品可快捷打开皮肤菜单。
- 使用
funtraps.skin.<skinId> 实现按皮肤权限控制。
安全恢复与回收
- 当结构过期或被移除时,临时方块会自动恢复。
- 当拥有者死亡或断开连接时,陷阱和 Plast 墙壁会被移除。
- 在替换临时方块之前,会存储原始方块信息。
- 恢复数据可以在意外关机后恢复待处理的結構。
- 容器、刷怪笼和特殊方块状态会得到安全处理。
- 管理员可以检查、验证和恢复待处理的恢复数据。
重叠与交叉系统
FunTraps 支持以下结构之间的交叉:
-
陷阱 ↔ 陷阱
-
陷阱 ↔ Plast
-
Plast ↔ Plast
-
self: 同一玩家拥有的结构之间的规则。
-
others: 不同玩家拥有的结构之间的规则。
-
allow: 允许或阻止交叉。
-
SAFE: 仅恢复已完成的结构层,同时保留交叉的结构。
-
LEGACY: 使用遗留的恢复行为。
-
FORCE: 将共享方块恢复到其原始状态,并可能导致交叉结构在视觉上损坏。
-
preserve-first-structure: 控制在共享方块位置处哪个结构保持可见。
重叠配置示例
trap:
overlap:
preserve-first-structure: true
self:
allow: true
restore-mode: FORCE
others:
allow: true
restore-mode: FORCE
- 首先放置的陷阱或 Plast 将在共享位置保持可见。
- 后续结构在内部保持活跃。
- 当一个交叉结构结束时,共享方块将被强制恢复。
- 剩余的结构可能会在共享区域丢失方块。
材质保护规则
FunTraps 将结构放置保护与内部清理保护分开处理。
trap:
ignore-blocks:
- BARRIER
- BEDROCK
- BEACON
- DIRT_PATH
cancel-on-materials:
- CHEST
- BARREL
- ".*shulker_box"
clear-inside:
ignore-blocks:
- BARRIER
- BEDROCK
- BEACON
- ".*shulker_box"
- ignore-blocks: 匹配的方块不会被陷阱或 Plast 结构替换。
- cancel-on-materials: 当结构区域内存在匹配材质时,取消整个放置操作。
- clear-inside.ignore-blocks: 定义必须永远不移除的方块。
- 支持精确的 Minecraft 材质名称和正则表达式规则。
正则表达式示例
cancel-on-materials:
- SHULKER_BOX
- ".*shulker_box"
- ".*_shulker_box"
- ".*_bed"
- ".*_chest"
SHULKER_BOX 仅匹配普通潜影盒。
.*shulker_box 匹配普通和染色潜影盒。
.*_shulker_box 仅匹配染色潜影盒。
.*_bed 匹配所有颜色的床。
.*_chest 匹配与箱子相关的材质。
世界、区域和领地保护
FunTraps 为 WorldGuard 区域和 ProtectionStones 领地提供了针对世界的灵活限制。
- 按世界允许或阻止结构放置。
- 按 WorldGuard 区域允许或阻止结构放置。
- 在被禁止的世界中创建局部允许区域例外。
- 限制在出生点区域、市场或受保护区域内的放置。
- 使用可选的 WorldGuard 自定义标志以实现高级控制。
- 使用 ProtectionStones 角色规则管理所有者、成员、管理员和非成员。
- 当管理员需要自定义标志绕过时,请使用
funtraps.worldguard.bypass。
ProtectionStones 角色配置
trap:
protectionstones:
placement:
allow-owners: true
allow-members: true
allow-administrators: false
allow-non-members: false
- allow-owners: 允许领地所有者部署结构。
- allow-members: 允许列出的领地成员部署结构。
- allow-administrators: 允许拥有领地管理员权限的玩家部署结构。
- allow-non-members: 允许没有领地成员身份的访客部署结构。
- 角色权限是累积的。只要至少有一个启用的角色适用,玩家即被允许。
内部清理系统
Clear-inside(内部清理)会在尊重配置的材质规则、世界、WorldGuard 区域和 ProtectionStones 领地的前提下,移除陷阱内的符合条件的方块。
trap:
clear-inside:
enabled: true
default-behavior: DENY
allowed-worlds: []
allowed-regions: []
allowed-match: ANY
blocked-worlds: []
blocked-regions: []
protectionstones:
enabled: true
- 设置为
DENY 时,在未配置的允许世界或区域之外,内部清理功能将被禁用。
- 当启用 ProtectionStones 支持时,授权的 ProtectionStones 领地成员仍可使用内部清理。
- 设置
protectionstones.enabled: false 以阻止在所有 ProtectionStones 领地内使用内部清理。
- 使用
allowed-worlds 和 allowed-regions 以在选定的 PvP 世界和竞技场中启用内部清理。
- 使用
blocked-worlds 和 blocked-regions 以保护重要地点。
性能与稳定性
- 延迟结构预加载,以减少首次使用时的卡顿。
- Trap 结构和 Plast 结构使用独立的缓存。
- 事件驱动的菜单更新,无需强制的一刻刷新任务。
- 粒子查看器缓存,以减少重复的玩家扫描。
- 可配置的 MySQL 连接池。
- 临时世界更改前写入恢复日志。
- 在玩家死亡、断开连接和插件关闭时自动清理。
- 支持临时结构和内部清理更改的崩溃恢复。
- 模块化系统,涵盖 Traps、Plast 墙壁、皮肤、菜单、粒子、存储、保护和恢复模块。
命令
Trap 管理
/trap give <player|all> <amount>
/trap giveuses <player> <skin> <amount>
/trap takeuses <player> <skin> <amount>
/trap setuses <player> <skin> <amount>
/trap tool
/trap pos1
/trap pos2
/trap save <skin>
/trap delete <skin>
/trap rename <old> <new>
/trap remove <player|all> [resetcooldown]
/trap recovery <status|restore [world]|verify>
/trap reload
Plast 管理
/plast give <player> <amount>
/plast tool
/plast pos1
/plast pos2
/plast save <skin> [direction]
/plast delete <skin>
/plast rename <old> <new>
/plast remove <all|here|player|me|id> [resetcooldown]
/plast removehere [resetcooldown]
/plast reload
玩家命令
/trap skin <skin>
/trap skins
/trap profile
/trap togglemode
/plast skin <skin>
/plast skins
/plast variants <skin>
权限
funtraps.admin — 完整的管理员访问权限。
funtraps.user — 可访问玩家的 Trap 和皮肤命令。
funtraps.skin.<skinId> — 使用特定皮肤的权限。
funtraps.skin.* — 使用所有可用皮肤的权限。
funtraps.worldguard.bypass — 绕过 FunTraps 自定义的 WorldGuard 标志。
重要更新说明
在更新 FunTraps 之前,请务必创建备份。
请备份整个 plugins/FunTraps 文件夹,包括配置文件、菜单、皮肤、结构文件、恢复数据和存储文件。
在更新前请查阅更新日志,特别是在更改存储设置、结构格式、自定义菜单或保护规则时。
FunTraps 为你的服务器带来战术战斗、自定义结构以及安全的世界恢复功能。
/trap rename <old> <new>
/trap remove <player|all> [resetcooldown]
/trap recovery <status|restore [world]|verify>
/trap reload
Plast 管理命令
/plast give <player> <amount>
/plast tool
/plast pos1
/plast pos2
/plast save <skin> [direction]
/plast delete <skin>
/plast rename <old> <new>
/plast remove <all|here|player|me|id> [resetcooldown]
/plast removehere [resetcooldown]
/plast reload
玩家命令
/trap skin <skin>
/trap skins
/trap profile
/trap togglemode
/plast skin <skin>
/plast skins
/plast variants <skin>
权限
funtraps.admin — 完全的管理员访问权限。
funtraps.user — 可访问玩家的陷阱和皮肤命令。
funtraps.skin.<skinId> — 使用特定某个皮肤的权限。
funtraps.skin.* — 使用所有可用皮肤的权限。
funtraps.worldguard.bypass — 绕过 FunTraps 自定义的 WorldGuard 标志。
重要更新说明
在更新 FunTraps 之前,务必备份。
备份整个 plugins/FunTraps 文件夹,包括配置文件、菜单、皮肤、结构图(schematics)、恢复数据和存储文件。
更新前请查阅更新日志,特别是在更改存储设置、结构格式、自定义菜单或保护规则时。
FunTraps 为你的服务器带来战术战斗、自定义建筑和安全的世界恢复功能。
Custom Cages, Traps & Plast Walls for Paper/Purpur 1.21+
FunTraps adds temporary tactical structures to Minecraft servers. Players can deploy custom cages, Traps and directional Plast walls using configurable activation items, structures, skins, potion effects, sounds and visual feedback.
Create your own Trap and Plast designs with .schem or YAML structures, configure their behavior, assign skins, manage limited or unlimited uses, and control exactly where players can use them.
FunTraps is designed for fast-paced combat mechanics without leaving permanent damage in the world.
- Lifesteal
- Survival
- Factions
- Practice
- KitPvP
- Prison
- PvP Events
- Minigames
- Custom Battle Arenas
Compatibility
- Server software: Paper / Purpur 1.21+
- Java: Java 21 recommended
- Storage: YAML, SQLite or MySQL
- Languages: English, Spanish and Russian
Dependencies and optional integrations
FunTraps works without additional plugins for its core Trap, Plast, skin, storage and restoration systems.
- WorldEdit / FAWE: Create, save and manage custom
.schem structures.
- WorldGuard: World and region restrictions, custom flags and protection rules.
- ProtectionStones: Claim-based permissions for owners, members, administrators and visitors.
- PlaceholderAPI: Placeholders inside menus, requirements, messages and custom item text.
Skin shop requirements
The included skin purchase menus are configured to use PlayerPoints.
To use the default shop exactly as included, install:
-
PlaceholderAPI
-
PlayerPoints
-
PlaceholderAPI resolves %playerpoints_points_formatted% inside the menus.
-
PlayerPoints provides player balances and the /points take <player> <amount> charge command.
-
The default confirmation menu checks the player's balance before completing a purchase.
-
FunTraps still works without these plugins, but the included PlayerPoints shop must be reconfigured before use.
Main features
Custom Traps and cages
- Create temporary cages using custom
.schem or YAML structures.
- Configure duration, cooldown, activation item, sounds, action bars and boss bars.
- Apply configurable potion effects to the owner and trapped players.
- Configure item cooldowns while players are inside active Traps.
- Save Trap structures with automatic center calculation.
- Configure per-player limits for active structures.
- Use custom placement, removal and ambient sounds.
Plast walls
- Deploy temporary directional walls using a dedicated activation item.
- Create separate Plast structures for every skin and direction.
- Supports horizontal, diagonal and vertical wall variants.
- Configure independent duration and cooldown settings.
- Use separate tools, saving commands, skins and removal commands.
Available Plast directions:
north
northeast
east
southeast
south
southwest
west
northwest
up
down
Example:
/plast save cruel northeast
This saves the variant as:
cruel_northeast.yml
Skins and uses
- Custom Trap and Plast skins.
- Unlimited, limited and virtual skin uses.
- Optional physical tokens that convert into virtual uses.
- Built-in skin browser, purchase menus and confirmation menus.
- Purchased skins can be granted directly as virtual uses.
- Selected skin state and remaining uses displayed in menus.
- Shift + right-click shortcut to open the skin menu from the activation item.
- Per-skin permissions using
funtraps.skin.<skinId>.
Safe restoration and recovery
- Temporary blocks restore automatically when structures expire or are removed.
- Traps and Plast walls are removed when their owner dies or disconnects.
- Original block information is stored before temporary blocks are replaced.
- Recovery data can restore pending structures after an unexpected shutdown.
- Containers, spawners and special block states are handled safely.
- Administrators can inspect, verify and restore pending recovery data.
Overlap and intersection system
FunTraps supports intersections between:
-
Trap ↔ Trap
-
Trap ↔ Plast
-
Plast ↔ Plast
-
self: Rules for structures owned by the same player.
-
others: Rules for structures owned by different players.
-
allow: Allows or blocks intersections.
-
SAFE: Restores only the finished structure layer while preserving intersected structures.
-
LEGACY: Uses legacy restoration behavior.
-
FORCE: Restores shared blocks to their original state and may visually break the intersected structure.
-
preserve-first-structure: Controls which structure remains visible in shared block positions.
Example overlap configuration
trap:
overlap:
preserve-first-structure: true
self:
allow: true
restore-mode: FORCE
others:
allow: true
restore-mode: FORCE
- The first placed Trap or Plast remains visible in shared positions.
- Later structures remain active internally.
- When one intersected structure ends, shared blocks are restored forcibly.
- The remaining structure can lose blocks in the shared area.
Material protection rules
FunTraps separates structure placement protection from interior clearing protection.
trap:
ignore-blocks:
- BARRIER
- BEDROCK
- BEACON
- DIRT_PATH
cancel-on-materials:
- CHEST
- BARREL
- ".*shulker_box"
clear-inside:
ignore-blocks:
- BARRIER
- BEDROCK
- BEACON
- ".*shulker_box"
- ignore-blocks: Matching blocks are not replaced by Trap or Plast structures.
- cancel-on-materials: Cancels the complete placement when a matching material exists inside the structure area.
- clear-inside.ignore-blocks: Defines blocks that clear-inside must never remove.
- Supports exact Minecraft material names and regex rules.
Regex examples
cancel-on-materials:
- SHULKER_BOX
- ".*shulker_box"
- ".*_shulker_box"
- ".*_bed"
- ".*_chest"
SHULKER_BOX matches only the normal shulker box.
.*shulker_box matches normal and colored shulker boxes.
.*_shulker_box matches colored shulker boxes only.
.*_bed matches every bed color.
.*_chest matches chest-related materials.
World, region and claim protection
FunTraps provides flexible restrictions for worlds, WorldGuard regions and ProtectionStones claims.
- Allow or block structures by world.
- Allow or block structures by WorldGuard region.
- Create local allowed-region exceptions inside blocked worlds.
- Restrict placement inside spawn areas, markets or protected zones.
- Use optional WorldGuard custom flags for advanced control.
- Use ProtectionStones role rules for owners, members, administrators and non-members.
- Use
funtraps.worldguard.bypass when an administrator requires a custom-flag bypass.
ProtectionStones role configuration
trap:
protectionstones:
placement:
allow-owners: true
allow-members: true
allow-administrators: false
allow-non-members: false
- allow-owners: Allows claim owners to deploy structures.
- allow-members: Allows listed claim members to deploy structures.
- allow-administrators: Allows players with administrator access in the claim.
- allow-non-members: Allows visitors without claim membership.
- Roles are cumulative. A player is allowed when at least one enabled role applies.
Clear-inside system
Clear-inside removes eligible blocks inside a Trap while respecting configured material rules, worlds, WorldGuard regions and ProtectionStones claims.
trap:
clear-inside:
enabled: true
default-behavior: DENY
allowed-worlds: []
allowed-regions: []
allowed-match: ANY
blocked-worlds: []
blocked-regions: []
protectionstones:
enabled: true
- With
DENY, clear-inside is disabled outside configured allowed worlds or regions.
- Authorized ProtectionStones claim members can still use clear-inside when ProtectionStones support is enabled.
- Set
protectionstones.enabled: false to prevent clear-inside inside all ProtectionStones claims.
- Use
allowed-worlds and allowed-regions to enable clear-inside in selected PvP worlds and arenas.
- Use
blocked-worlds and blocked-regions to protect important locations.
Performance and stability
- Deferred structure preloading to reduce first-use lag.
- Separate caches for Trap and Plast structures.
- Event-driven menu updates without mandatory one-tick refresh tasks.
- Particle viewer cache to reduce repeated player scans.
- Configurable MySQL connection pool.
- Recovery journal written before temporary world changes.
- Automatic cleanup on player death, disconnect and plugin shutdown.
- Crash recovery support for temporary structures and clear-inside changes.
- Modular systems for Traps, Plast walls, skins, menus, particles, storage, protections and recovery.
Commands
Trap administration
/trap give <player|all> <amount>
/trap giveuses <player> <skin> <amount>
/trap takeuses <player> <skin> <amount>
/trap setuses <player> <skin> <amount>
/trap tool
/trap pos1
/trap pos2
/trap save <skin>
/trap delete <skin>
/trap rename <old> <new>
/trap remove <player|all> [resetcooldown]
/trap recovery <status|restore [world]|verify>
/trap reload
Plast administration
/plast give <player> <amount>
/plast tool
/plast pos1
/plast pos2
/plast save <skin> [direction]
/plast delete <skin>
/plast rename <old> <new>
/plast remove <all|here|player|me|id> [resetcooldown]
/plast removehere [resetcooldown]
/plast reload
Player commands
/trap skin <skin>
/trap skins
/trap profile
/trap togglemode
/plast skin <skin>
/plast skins
/plast variants <skin>
Permissions
funtraps.admin — Full administrative access.
funtraps.user — Access to player Trap and skin commands.
funtraps.skin.<skinId> — Permission to use one specific skin.
funtraps.skin.* — Permission to use every available skin.
funtraps.worldguard.bypass — Bypass FunTraps custom WorldGuard flags.
Important update notes
Always create a backup before updating FunTraps.
Back up the complete plugins/FunTraps folder, including configuration files, menus, skins, schematics, recovery data and storage files.
Review the changelog before updating, especially when changing storage settings, structure formats, custom menus or protection rules.
FunTraps brings tactical combat, custom structures and safe world restoration to your server. /trap rename <old> <new>
/trap remove <player|all> [resetcooldown]
/trap recovery <status|restore [world]|verify>
/trap reload
Plast administration
/plast give <player> <amount>
/plast tool
/plast pos1
/plast pos2
/plast save <skin> [direction]
/plast delete <skin>
/plast rename <old> <new>
/plast remove <all|here|player|me|id> [resetcooldown]
/plast removehere [resetcooldown]
/plast reload
Player commands
/trap skin <skin>
/trap skins
/trap profile
/trap togglemode
/plast skin <skin>
/plast skins
/plast variants <skin>
Permissions
funtraps.admin — Full administrative access.
funtraps.user — Access to player Trap and skin commands.
funtraps.skin.<skinId> — Permission to use one specific skin.
funtraps.skin.* — Permission to use every available skin.
funtraps.worldguard.bypass — Bypass FunTraps custom WorldGuard flags.
Important update notes
Always create a backup before updating FunTraps.
Back up the complete plugins/FunTraps folder, including configuration files, menus, skins, schematics, recovery data and storage files.
Review the changelog before updating, especially when changing storage settings, structure formats, custom menus or protection rules.
FunTraps brings tactical combat, custom structures and safe world restoration to your server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧