CergioNeedfulPlugin

An all-in-one teleport and server-utility plugin: TPA, homes, warps, spawn, RTP, back, and kits, tied together with LuckPerms integration so cooldowns, home limits, and RTP radius can be customized per rank or per player. Built-in skill leveling, combat logging punishment, and automatic ground/mob cleanup round it out so you don't need five separate plugins doing overlapping jobs.

Messages support English and Turkish out of the box (switchable in config.yml), use the MiniMessage format (gradients, hex colors), and all data is stored in YAML so it survives restarts.

Features

Teleportation

• /tpa, /tpahere — teleport requests with clickable accept/deny buttons in chat
• /sethome, /home, /delhome, /homes — multiple homes per player, configurable limit (overridable per-rank via LuckPerms meta)
• /warp, /setwarp, /warps — paged warp menu with custom icons
• /spawn, /setspawn
• /rtp — random teleport with adjustable radius and a biome blacklist
• /back — return to your last location or death point
• Every teleport has a warmup countdown that cancels on movement or damage, and a safe-landing check so you never spawn into lava/void/walls

Kits

• /kit, /kits, /createkit, /delkit, /kiticon — paged kit menu, build a kit straight from your inventory, per-kit permissions and cooldowns

Skill system (Combat & Mining)

• Two independent skill tracks, 20 levels each, with a progressively harder XP curve
• XP from mining specific ores and from PvP damage
• Right-click activatable abilities once leveled, boss bar XP feedback

Combat tag

• Logging out mid-fight applies a death penalty and drops your inventory
• Separate "death" and "command lock" timers shown on the action bar
• Blocks teleporting while tagged, with a configurable command whitelist

Automatic cleanup

• Periodically clears dropped items on the ground, with a countdown warning and sound cue
• Also reaches into currently unloaded chunks to clean those without permanently keeping them loaded
• Clears unnamed hostile mobs (zombies, skeletons, creepers, etc.) — nametagged, tamed, or passive mobs (cows, sheep, etc.) are never touched
• Manual trigger via /cergio cleanup

Admin

• /cergio reload — reloads config and messages live, no restart needed
• LuckPerms meta overrides for TPA cooldown, home limit, RTP radius, and more

Requirements

• Paper/Spigot 1.x (see version selector)
• LuckPerms is optional — without it, the plugin falls back to config defaults for all limits/cooldowns

Configuration

• config.yml — all timers, limits, radii, and the language: en|tr setting
• messages_en.yml / messages_tr.yml — fully editable, MiniMessage-formatted message files

Permissions

See the in-game /cergio admin command and the bundled permission nodes (cergio.tpa, cergio.home, cergio.warp.use, cergio.rtp, cergio.back, cergio.kit, cergio.admin) for granular access control.

---

Bugs and suggestions are welcome via the issue tracker linked on this page.