# uxmEssentials **The all-in-one essentials suite for modern Paper servers Homes, Economy, Kits, Vaults, Moderation, a Staff Mode, Holograms, NPCs, Worlds, and 13 more, in one cohesive plugin.** Paper 1.21.11 · Java 25 · Folia-ready · 22 modules · Open source (GPL-3.0)

## One plugin instead of a patchwork of ten uxmEssentials replaces the stack of separate plugins most servers glue together an essentials core, an economy, a kit plugin, a vault plugin, a moderation toolkit, a hologram plugin, an NPC plugin, a multi-world manager with **one cohesive 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 built **Paper 1.21.11 only, on purpose** the current API used the way it is meant to be, **Folia-ready from line one**, with economy balances and player vaults stored in a real database so they survive world rollbacks. And the best part: every module ships with an **in-game management GUI**. You configure holograms, NPCs, warps, vaults, and punishments by clicking not by editing files and restarting. ## Why uxmEssentials - **Genuinely modular.** 22 feature modules, each toggled on its own. A disabled module wires nothing: no commands, no listeners, no database tables, no overhead. Run only what you need. - **Configure in-game.** Every module has a management GUI from `/uxmess gui`. The grids, slots, and icons are themselves config-driven. - **Nothing hardcoded.** Every player-facing string lives in a per-locale catalog; every command can be renamed, aliased, or disabled; every layout, cost, cooldown, and limit is a config value. - **Rollback-proof data.** Balances and vaults live in the database never in item NBT so a world rollback never duplicates money or items. - **Folia-ready.** Nothing schedules through the legacy scheduler; work is dispatched to the correct region thread. The same code runs unchanged on Paper and Folia. - **Adventure-native.** All text is MiniMessage through one shared theme no legacy colour codes anywhere. ## What's inside 22 modules

Player essentials homes, warps, player-warps, teleport

- **Homes** a slot-based GUI: click an empty cell to set a home, click a home to teleport / rename / relocate / re-icon. Home visibility + invites (`/visit`, `/invite`), an optional economy charge, a death-respawn chain (home, bed, spawn), unsafe / blacklisted-world guards, and land-claim gating across nine providers (Lands, GriefPrevention, uxmClaims, and more). - **Warps** per-warp cost, permission, password lock, welcome message, warmup / cooldown overrides, departure / arrival sounds and particles, and a rating system. - **Player-warps** player-owned warps with per-rank quotas, public / private visibility, password locks, visitor counts, and custom icons. - **Teleport** `/tpa`, `/tpahere`, `/back`, `/rtp` (a pre-warmed safe-search queue, so random teleports are instant), `/spawn`, move-cancels-warmup, per-rank cooldowns, and configurable arrival effects.

Progression economy, kits, vaults

- **Economy** a serious, multi-currency, database-backed economy: `/pay`, `/balance`, a cached `/baltop`, shared banks with interest, a loan system, a currency exchange, physical banknotes (anti-dupe), per-command costs, salary and daily rewards. Registers with Vault / Treasury or runs on its own native ledger. - **Kits** far beyond items on a cooldown: categories, per-rank variants, one-time and first-join grants, costs, requirements, a typed action engine (titles, sounds, particles, commands), rotation and scheduled availability, global stock, buy-to-unlock, and a full editor GUI. - **Vaults** database-backed player storage (survives rollbacks) with per-player vault counts and per-vault sizes via quota nodes, an item blacklist, per-vault name and icon, overflow rescue, and inactive-vault purge.

Staff tooling moderation, staff mode

- **Moderation** bans, IP-bans, temp-bans, mutes, kicks, warns, jails, with silent sanctions, duration tiers, warn escalation, alt detection, IP history, and a unified `/history`, `/checkban`, `/checkmute` plus a management GUI and a LiteBans importer. - **Staff Mode** a dedicated mode: toggle with loadout swap, vanish, examine, freeze, follow, navigator, staff chat, an online-staff list, alerts, flight, sanction rollback, server lockdown, and targeted socialspy.

Chat and social messaging, communication, presence, player-state

- **Messaging** private messages (`/msg`, `/r`), a mailbox with offline fallback and `/mail sendall`, AFK notices, and a per-player ignore list. - **Communication** multi-channel scheduled announcements (conditional, with placeholders), broadcasts, clear-chat, custom advancement notifications, and data-driven `/info`, `/rules`, `/discord` pages. - **Presence** nicknames, presence status, and display-name management. - **Player-state** gamemode, heal, feed, fly, god, speed, plus offline-capable `/invsee` and `/endersee`.

Visual and engagement holograms, NPCs, scoreboard, tablist, nametags, vote

- **Holograms** Display-entity holograms: multi-line, multi-page (per-viewer click-to-cycle), provider-driven leaderboards, click-action chains, inline animations, per-player visibility and blacklists, glow and opacity, link-to-NPC follow, plus FancyHolograms / DecentHolograms importers. - **NPCs** packet-based NPCs over an in-house packet layer: players, mobs, and display entities; skins by name / MineSkin / URL; click-action chains; equipment, glow, poses, deep per-type variants; per-owner quotas and a command blocklist. - **Scoreboard** per-player, condition-selected sidebars by priority, with animated and conditional lines and hidden score numbers. - **Tablist** per-player tab name formatting and sorting, animated header / footer, fixed-slot layouts with filler. - **Nametags** above-head display-entity nametags, per-viewer and vanish-aware. - **Vote** a full vote-rewards engine: Votifier intake, totals and a leaderboard, a cross-server vote party with escalation, streaks, per-site cooldowns and reminders, multi-channel broadcasts, and Discord webhook notifications.

World and utility worlds, itemworld, discord-link

- **Worlds** a full multi-world manager: create / import / delete (confirm-staged), per-world properties and gamerules, built-in void and flat generators, access gating with economy entry fees, cross-world portals, a world-editor GUI, pre-generation, backup / restore, and idle auto-unload. - **Itemworld** the everyday utility surface: item tools, virtual workstations (anvil, crafting, and more, anywhere), powertool, mob and entity tools, time / weather aliases, inventory cleanup, and admin-fun each an independently disableable sub-group. - **Discord-link** link a Minecraft account to Discord, sync roles, and push audit / economy notifications (with the Discord add-on).

## Configure it all in-game `/uxmess gui` opens a hub linking to every module's editor. Entity modules (holograms, NPCs, warps, vaults, moderation) get a list, then an editor pick an entity, then flip its properties with toggles, steppers, text / number / enum editors, a colour picker, and list editors. Settings modules get a panel of switches. The menus themselves are config-driven, so you can re-skin every screen without code. ## Migrating in? One command. `/uxmess import ` runs a one-shot, **idempotent** migration with a dry-run preview and a documented conflict policy: | Source | Imports | |---|---| | **EssentialsX** | homes (into the slot model), warps, kits, economy | | **FancyHolograms / DecentHolograms** | holograms | | **LiteBans** | bans, IP-bans, mutes, warns | | **Vault / PlayerPoints** | economy balances | ## Requirements | | | |---|---| | **Server** | Paper **1.21.11** (or a Paper fork Folia / Purpur / Pufferfish) | | **Java** | **25** | | **Database** | SQLite by default (zero setup). MySQL, MariaDB, and PostgreSQL optional. | | **Optional** | PlaceholderAPI, Vault / Treasury, a Votifier listener, LuckPerms all auto-detected. | > Spigot and CraftBukkit are **not** supported uxmEssentials uses `paper-plugin.yml`, Brigadier, and bundled Adventure. Clients on older versions can still connect through a server-side ViaVersion. ## Getting started 1. Drop `uxmEssentials-0.2.0.jar` into your server's `plugins/` folder and start the server. 2. Config is generated per module under `plugins/uxmEssentials/modules/`. Toggle any module from its `config.conf`. 3. Run `/uxmess doctor` to confirm the database, economy provider, and integrations are healthy. 4. Migrating? Try `/uxmess import essentialsx` (dry-run first). The admin root is `/uxmess` (aliases `/uxe`, `/uxmessentials`). **Optional companion jars** - **`uxmEssentials-velocity`** a Velocity proxy module that syncs homes, warps, economy, and vote parties across a network. - **`uxmEssentials-discord`** a JDA bridge for account linking and audit / economy notifications. You only need the main jar to get started; add the companions when your setup calls for them. ## Notes uxmEssentials is open source (GPL-3.0) and under active development. Feature requests, bug reports, and feedback are genuinely welcome `/uxmess doctor` and your server log are the fastest path to a fix.

siracozmen

siracozmen's Plugins

uxmEssentials by UXPLIMA

siracozmen's Organizations

Stars

Watching

uxmEssentials by