Плагин FunTraps – Customizable Cages FT 1.2.0

• Lifesteal
• Survival
• Factions
• Practice
• KitPvP
• Prison
• PvP Events
• Minigames
• Custom Battle Arenas

• Server Software: Paper / Purpur 1.21+
• Java: Java 21 recommended
• Storage: YAML, SQLite or MySQL
• Languages: English, Spanish and Russian

• WorldEdit / FAWE: Used to create, save and manage custom .schem structures.
• WorldGuard: Adds world and region restrictions, custom flags and protection rules.
• ProtectionStones: Adds claim-based permissions for owners, members, administrators and visitors.
• PlaceholderAPI: Resolves placeholders inside menus, requirements, messages and custom item text.

• PlaceholderAPI
• PlayerPoints

• PlaceholderAPI resolves the %playerpoints_points_formatted% balance placeholder shown in the menus.
• PlayerPoints provides the player point balance and the /points take <player> <amount> charge command.
• The default confirmation menu checks the player balance before completing a purchase.
• Without PlaceholderAPI and PlayerPoints, FunTraps itself still works, but the included PlayerPoints skin shop should not be used until its menu requirements and commands are changed.

• 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.
• Support custom placement, removal and ambient sounds.

• 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.

north
northeast
east
southeast
south
southwest
west
northwest
up
down

/plast save cruel northeast

cruel_northeast.yml

• 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>.

• 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 unexpected shutdowns.
• Containers, spawners and special block states are handled safely.
• Administrators can inspect, verify and restore pending recovery data.

• 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.

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.

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.

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.

• Allow or block structures by world.
• Allow or block structures by WorldGuard region.
• Create local allowed-region exceptions inside blocked worlds.
• Restrict placement inside important areas such as spawn, 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.

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.

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.

• 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.

• /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 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 – 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.

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.

Нажмите для раскрытия…