uxmEssentials v1.0

uxmEssentials

A modern, modular, all-in-one essentials suite for Paper 1.21+. Homes, warps, teleportation, a full economy, advanced kits, moderation, and dozens of quality-of-life tools, built from the ground up for today's servers.

uxmEssentials replaces the stack of separate plugins most servers glue together (essentials, an economy, a kit plugin, a vault plugin, a moderation toolkit) with one cohesive, internally consistent suite. Every feature shares the same configuration style, the same message system, the same permission scheme, and the same database, so your server behaves predictably instead of like a patchwork of plugins that each do things their own way.

It is written for Java 21 and the modern Paper API: Brigadier commands, MiniMessage formatting, and Folia-ready regionized scheduling from line one.

Support https://discord.uxplima.com/
Source Code https://github.com/UXPLIMA/uxmEssentials

Why uxmEssentials?

• Truly modular. Every feature is an independent module. Don't want the economy? Disable it and it wires nothing: no commands, no listeners, no database tables, no overhead. Run only what you need.
• Folia-ready. Built for regionized and multi-threaded servers from the start. No legacy BukkitScheduler assumptions; work is dispatched to the right region thread.
• Database-backed by design. Player vaults and economy balances live in a real database, so they survive world rollbacks. SQLite out of the box (zero setup); MySQL, MariaDB, and PostgreSQL supported for networks.
• Fully translatable. Every player-facing message resolves through a per-language catalog with MiniMessage formatting. Ships with English and Turkish, and per-player locales are respected.
• Config-driven commands. Rename, re-alias, or disable any command without touching code or fighting other plugins, all from a single catalog file.
• Cross-server and Discord ready. Optional Velocity and Discord companion modules (see below).

Features

Homes, Warps & Teleportation

• Multiple homes with permission-tiered limits, a main home, rename, and move.
• Server warps with optional cost and per-warp permissions, plus a paginated /warps GUI.
• A /tpa and /tpahere request system, /back (including death-back), /spawn and multi-spawn, and a safe-search /rtp with a pre-warmed location queue so random teleports are instant.
• Configurable warmups that cancel on movement, and uniform cooldowns across every teleport.

Economy
A serious, multi-currency economy, not an afterthought.

• Multi-currency wallets with a default currency shipped out of the box.
• /pay with optional tax and a confirmation prompt, /balance, and a cached, banned-aware /baltop leaderboard.
• Bank accounts with tiered interest, and a loan system with credit scoring.
• Physical banknotes: /withdraw mints a note item, /deposit redeems it (anti-dupe protected), plus admin-issued /eco note vouchers.
• Currency exchange, /worth, /sell, /setworth, per-command costs, a periodic salary, and a daily login reward.
• Registers with Vault and Treasury (or runs on its own native ledger), with optional Redis cross-server balance sync.

Kits
Kits that go far beyond "give some items on a cooldown":

• Cooldowns (with permission-tiered overrides), one-time kits, per-kit permissions, and a per-kit cost (soft-coupled to the economy).
• Per-rank variants, so one /kit daily hands richer loot to higher ranks.
• Requirements (PlaceholderAPI conditions) and a typed action engine (messages, titles, sounds, particles, fireworks, commands, delays) sequenced around the item grant.
• Rotation and scheduled availability (weekdays plus daily time windows plus one-off events), global stock limits, and a buy-to-unlock model (pay once, then claim free).
• Categories, first-join and auto-equip kits, a clear-inventory option for loadout and PvP servers, per-player placeholder parsing on granted items, and a configurable inventory-full policy.
• A full browse-menu GUI, read-only kit preview, and an in-game kit editor.

Moderation

• Bans, IP-bans, temp-bans, mutes, jails, warns (with expiry), and kicks.
• Alt detection, ban and warn history, a one-command /sanction summary, /togglejail, and command-spy.

Communication & Presence

• Private messages, reply, social spy, ignore, and an offline mailbox.
• AFK, vanish, nicknames, /realname, and /whois.
• Broadcasts (global and per-world), chat clearing, and data-driven text commands: drop a file and /info, /rules, /motd, /discord and so on appear automatically, paginated and placeholder-aware, with no recompile.

Vaults & Item Tools

• Database-backed player vaults (per-player vault count and per-vault size via quota nodes) that survive rollbacks.
• A broad item toolbox: item utilities, virtual workstations (open a crafting table, anvil, and more anywhere), powertools, mob and entity tools, time and weather aliases, inventory cleanup, and admin-fun toys.
• Offline /invsee and /endersee: inspect and edit a player's inventory or ender chest even while they're offline.

And more
Player warps, holograms, voting and vote-party rewards, scoreboards, server links, an in-game /help, on-demand /backup, and a /uxmess doctor health check.

Migrating from EssentialsX?
One command: /uxmess import essentialsx.

It reads your existing Essentials data (homes, balances, mail, warps, kits, and jails/mutes) into uxmEssentials, with a dry-run mode, conflict policies, and an automatic backup before it touches anything. Live balance import from Vault providers and PlayerPoints is supported too.

Companion modules (optional)
uxmEssentials ships as one main plugin plus two optional add-ons:

• uxmEssentials-velocity: a Velocity proxy module that synchronizes homes, warps, and economy across a network.
• uxmEssentials-discord: a Discord bridge for audit and economy notifications.

You only need the main jar to get started; add the companions when your setup calls for them.

Getting started

1. Drop uxmEssentials-0.1.0.jar into your server's plugins folder and start the server.
2. Default config is generated per module under plugins/uxmEssentials/modules/. Enable or disable any module from there.
3. Run /uxmess doctor to confirm everything is wired correctly.
4. Migrating from EssentialsX? Try /uxmess import essentialsx dry-run first.

Notes
uxmEssentials is open source and under active development. Feature requests, bug reports, and feedback are genuinely welcome; please use the issue tracker. If you run into a problem, /uxmess doctor and your server log are the fastest way to a fix.