FunTraps - Speedgot

FunTraps -----

A fun trap cage plugin for your server

FunTraps – Customizable Cages

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

[hr]

Description

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

[hr]

✨ Features

Selection tool (Golden Axe) to define areas.
Custom skins for cages, configurable in config.yml.
Potion effects per trap (supports infinite or time-limited effects).
Integration with protection systems:
- WorldGuard: restrict traps in blocked worlds/regions and allow them in configured ones.
- ProtectionStones: only region owners/members can use traps inside.
Advanced effect manager: handles both temporary and infinite effects with no config errors.
Lightweight and modular: no mandatory dependencies, works out of the box.
Perfect for:
- PvP minigames where players can trap each other.
- Adventure maps with activatable traps.
- Fun survival servers adding tactical gameplay.

[hr]

⚙️ Installation

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

[hr]

Configuration

All configuration is located in:

Code (Text):

plugins/FunTraps/config.yml

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

Code (Text):

skins:
default:
duration: 15
cooldown: 15
animation: sphere
sounds:
place:
name: minecraft:ui.toast.challenge_complete
volume: 1.0
pitch: 1.0
range: 24
remove:
name: minecraft:block.beacon.power_select
volume: 1.0
pitch: 1.0
range: 24
effects:
self:
- type: STRENGTH
amplifier: 2
duration: 10
- type: SPEED
amplifier: 2
duration: 5
- type: GLOWING
amplifier: 0
duration: -1
enemies:
- type: SLOWNESS
amplifier: 1
duration: 10
- type: GLOWING
amplifier: 0
duration: -1

[hr]

Commands

The main command is /trap.

Admin Commands (permission: trapsfun.admin)

/trap give <player|me|all> <amount> → Give trap activation item.
/trap tool → Get selection tool (Golden Axe).
/trap set <name> → Save a structure with the selected region.
/trap delete <skin> → Delete a saved structure.
/trap rename <old> <new> → Rename a saved structure.
/trap remove <player|me|all> → Remove active traps.
/trap reload → Reload config and messages.

Player Commands (permission: trapsfun.user)

/trap skin <name> → Select a trap skin.
/trap skins → List all available skins.

[hr]

Permissions

trapsfun.admin → Full admin access.
trapsfun.user → Access to user commands.
traps.skin.<name> → Permission to use a specific skin.
traps.skin.* → Use all skins.

[hr]

Notes

- Trap activation item is set in config.yml (`trap.activation-item`).
- Selection tool defines Position 1 and 2 for saving structures.
- All messages can be customized in lang.yml.

[hr]

Dependencies