FunTraps – Customizable Cages

Add fun and tactical traps to your server with full region and protection support.
A lightweight Spigot/Paper 1.21+ plugin that allows you to create custom cage/trap structures with configurable skins and potion effects, fully integrated with WorldGuard and ProtectionStones.

---

---

🧠 Description

FunTraps lets server administrators configure customizable traps that activate on players.
Traps can take the form of cages or prisons with configurable blocks and effects.

---

✨ Features:

• Selection tool (Golden Axe) to define areas.
• Custom skins for cages, configurable in config.yml.
• Potion effects per trap (supports both infinite and time-limited effects).
• Integration with protection systems:
  • WorldGuard: restrict traps in blocked worlds/regions, allow them in permitted areas.
  • ProtectionStones: only owners or members of regions can use traps inside.
• Advanced effect manager: handles both temporary and infinite effects without config errors.
• Lightweight and modular: no mandatory dependencies, works out-of-the-box.
• Perfect for:
  • Minigames where players can trap each other.
  • Adventure maps with triggerable traps.
  • Survival servers that want to add a tactical twist.

---

⚙️ Installation

1. Download the latest FunTraps.jar.
2. Place it into your server’s plugins/ folder.
3. (Optional) Install WorldGuard and/or ProtectionStones for region restrictions.
4. Start or reload your server.

---

🛠 Configuration

All settings are located in:

plugins/FunTraps/config.yml.

Skins

You can define multiple cage skins with blocks and effects.
Example:

skins:
  default:
    # Trap duration with this skin (in seconds)
    duration: 15
    # Trap cooldown with this skin (in seconds)
    cooldown: 15
    # Animation type: "sphere", more coming soon...
    animation: sphere

    # ────────────────
    # Item cooldowns inside the trap
    # ────────────────
    item-cooldowns:
      ENDER_PEARL: 8        # seconds
      CHORUS_FRUIT: 12
      ENCHANTED_GOLDEN_APPLE: 30
      GOLDEN_APPLE: 15

    # ────────────────
    # Sounds when placing or removing the trap
    # ────────────────
    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 Commands

The main command is /trap and includes several subcommands, split between admins and players.

---

🔧 For Admins (trapsfun.admin)

• /trap give <player|all> <amount>
  Give the trap activation item to a player, all players, or yourself.

• /trap tool
  Get the selection tool (Golden Axe) to define structure regions.

• /trap save <name>
  Save a structure with the given name using the selected positions.

• /trap delete <skin>
  Delete a saved structure by name.

• /trap rename <old> <new>
  Rename a saved structure.

• /trap remove <player|all>
  Remove active traps from a player, everyone, or yourself.

• /trap reload
  Reload the configuration and messages system.

---

👤 For Players (trapsfun.user)

• /trap skin <name>
  Select a trap skin (if you have permission to use it).

• /trap skins
  List all available skins on the server.

---

🔑 Permissions

• trapsfun.admin → full access to management commands.
• trapsfun.user → access to skin-related commands.
• traps.skin.<name> → permission to use a specific skin.
• traps.skin.* → permission to use all skins.

---

📌 Notes

• The trap activation item is defined in config.yml (trap.activation-item).
• The selection tool marks position 1 and 2 to create structures.
• Feedback messages are managed in lang.yml and are fully customizable.

---

🧱 Dependencies

• [✅] Spigot / Paper 1.21+
• [✅] (Optional) WorldGuard (region/world restrictions)
• [✅] (Optional) ProtectionStones (player region support)

---