⚡The modern EssentialsX replacement!⚡

The drop-in solution when Essentials just won't cut it for your high-performance Folia or paper server or proxy network.

---

📌 Why Serversentials?

Pretty annoying that Essentials doesn't support Folia and proxy networks properly, right?

Well, Serversentials is here for you! This plugin provides you with everything Essentials does but better, modern, high-performance, and network-compatible.

What makes Serversentials better?

• Proxy & Network Native: Packaged as a Hybrid JAR that runs on both Paper/Folia servers and the Velocity proxy.
• Community Driven: Run by community suggestions! Join our discord to submit your suggestions.

---

✨ Core Features at a Glance

• 🚀 Folia-Ready! Built and optimized for the high-performance multi-threaded Folia platform.
• 🌐 Cross-Server Network Support: Run a single JAR on backend servers and your Velocity proxy.
• ✈️ Network Teleportation: Send cross-server /tpa / /tpahere requests, bypass toggles with /tpo / /tpohere, and jump back to previous servers using /back.
• 👁️ Spectator Perspective /monitor: Moderation tool to monitor a player's perspective (locally or cross-server) in spectator mode without losing your original server, coordinates, or gamemode.
• 💬 Permission-Controlled Chat Formatting: Modern async chat renderer supporting group layouts, PAPI/Vault integration, and permission-bound styling (Hex colors, gradients, rainbow text, decorations) with explicit negative override support.
• 🎒 Interactive Invsee & Enderchest: View and edit inventories or enderchests across servers in a custom 54-slot GUI displaying armor, offhand items, and real-time player status (health, food, XP, active effects).
• 🎨 Global Nicknames & Lookup: Synchronize player nicknames network-wide via MySQL, reset to vanilla instantly, and find real usernames behind nicknames with /whois (featuring nickname tab-completion).
• 👻 Proxy Vanish Integration: Hides vanished players from joining players and integrates with Neznamy's TAB/TAB-bridge to automatically remove vanished players from the global tablist.
• 🛡️ Clean Command suggestions: Automatically filters and hides commands from the chat suggestions box if a player lacks permission to run them.
• 📦 Portable Utility GUIs: Seamless GUIs for commands like /craft, /echest, /anvil, /loom, /stonecutter, and /smithingtable.
• 🛠️ In-Game Item Editors: Modify items dynamically with /itemrename and /lore (add, set, delete, clear) supporting permission-bound styles.
• 💾 Dual-Dialect Storage: High-performance HikariCP connection pooling supporting SQLite (local) and MySQL (cross-server sync).
• 🔄 Smart Config Auto-Updater: Updates configuration files with new features automatically on startup while preserving all custom values and inline comments.

---

🔎 Feature Spotlight: The /monitor Command

A powerful, unique tool for your moderation team!

Allows you to monitor a player's perspective without losing your original position! Perfect for quietly tracking down exploiters or monitoring player behavior.

Usage: /monitor <player> to start monitoring, and /monitor to stop. Alias: /mon works too! Works seamlessly across proxy backend servers with automatic recovery safety.

---

💾 Installation Guide

Setting up Serversentials is quick and straightforward:

1. Single Server Setup (Spigot / Paper / Folia)

1. Download the Serversentials.jar file.
2. Drop the jar file directly into your server's plugins/ directory.
3. Start or restart your server to generate the default configuration files.

2. Network / Proxy Setup (Velocity Proxy + Backend Servers)

1. Drop the same Serversentials.jar file into your Velocity proxy's plugins/ folder.
2. Drop the Serversentials.jar file into the plugins/ folder of your backend Paper/Folia server/s.
3. Start all servers to let them generate their configurations.
4. On each backend server, open plugins/Serversentials/config.yml and locate the server-name key. Set this to match exactly the server's name as defined in your Velocity velocity.toml configuration (e.g. lobby, survival-1).
5. Restart backend servers to establish network synchronization.

---

⚔️ Commands & Permissions

A comprehensive list of the most important commands and their required permissions:

Command	Aliases	Description	Required Permissions
Gamemode & Styling
/fly	-	Toggle flight mode.	serversentials.fly
/gms, /gmc, /gmsp	-	Change your gamemode.	serversentials.gms/gmc/gmsp
/nick	-	Change your display name/nickname.	serversentials.nick
/whois	-	Look up the real username behind a nickname.	serversentials.whois
Admin & Moderation
/monitor	mon	Monitor a player without leaving your original spot.	serversentials.monitor
/vanish	v	Toggle invisibility/vanish mode.	serversentials.vanish serversentials.vanish.see
/invsee	inv	View a player's inventory.	serversentials.invsee serversentials.invsee.edit
/heal, /feed, /god	-	Restore status or toggle invulnerability.	serversentials.heal/feed/god
Homes & Warps
/home	-	Teleport to a set home.	serversentials.home serversentials.home.cooldown.<#> serversentials.home.countdown.<#>
/sethome	-	Set a new home location.	serversentials.sethome serversentials.sethome.<#>
/warp	-	Teleport to a public server warp.	serversentials.warp serversentials.warp.<name>
/setwarp	-	Create a new warp location.	serversentials.setwarp
Teleportation
/tpa, /tpahere, /tptoggle	-	Request to teleport to/from another player.	serversentials.tpa/tpahere/tptoggle
/tpo, /tpohere	-	Force teleport (Admin bypass).	serversentials.tpo/tpohere
Economy
/balance, /pay	bal	Check balance or pay a player.	serversentials.balance/pay
/economy	eco	Admin balance modification.	serversentials.economy.give/set/deduct
/baltop	-	Show the server's top balances.	serversentials.baltop
Item Customization
/itemrename	iname	Rename the display name of your held item.	serversentials.itemrename
/lore	-	Add, set, delete, or clear lore lines of your held item.	serversentials.lore
Utility GUIs
/craft, /echest, /anvil, /loom, /stonecutter, /smithingtable	ec, smith	Open portable crafting GUIs.	serversentials.craft/echest/anvil/loom/stonecutter/smithingtable

---

💻 PlaceholderAPI Support

Requires PlaceholderAPI (Using Folia?: Use a Folia-compatible release):

Placeholder	Description	Example Output
%serversentials_name%	The player's current username.	Jolly
%serversentials_displayname%	The player's formatted display name (respects /nick).	[Admin] Jolly
%serversentials_gamemode%	The player's current game mode.	SURVIVAL
%serversentials_eco_balance%	The player's current economy balance.	542.50

---

⚙️ Configuration Example

Serversentials is designed to be highly configurable with a simple, modular structure. Missing keys are automatically merged on plugin updates without breaking custom layouts.

server-name: "default"
# If using on a proxy network, change this to the configured server name for this server
# If running a single server, no need to change this
# Set this properly if on a proxy network to avoid issues with teleporting!!!

database:
  type: sqlite # or "mysql" use sqlite if you haven't set up a mysql server
  # SQLite options
  file: serversentials.db
  # MySQL options (used only if type = mysql)
  host: localhost
  port: 3306
  database: serversentials
  username: root
  password: ""
  useSSL: false
  pool-size: 10

modules:
  # serversentials.home <- /home and /sethome
  # serversentials.sethome.<#> <- Number of homes
  # serversentials.home.cooldown.<#> <- Cooldown per /home command
  # servesentials.home.countdown.<#> <- Countdown before teleporting
  home: true
  nick: # serversentials.nick
    enabled: true
    maxlength: 32 # This includes MiniMessage formatting <red>JollyJoe <- counts 13
  #---------TELEPORTS----------
  tpa: #serversentials.tpa
    enabled: true
    expiration: 20 # Seconds before teleport requests expire
  tpahere: # serversentials.tpahere
    enabled: true
    expiration: 20 # Seconds before teleport requests expire
  tptoggle: true # serversentials.tptoggle <- Toggles teleport requests on/off
  tpo: true # serversentials.tpo <- Tpa override
  tpohere: true # serversentials.tpohere <- Tpahere override
  teleport:
    back: true # serversentials.back <- /back support

  # serversentials.warp <- /warp
  # serversentials.warp.<warpname> <- /warp <name>
  # serversentials.setwarp <- /setwarp
  # serversentials.warp.cooldown.<#>
  # serversentials.warp.countdown.<#>
  warp: true
  #---------UTILITIES----------
  craft: true # serversentials.craft
  anvil: true # serversentials.anvil
  loom: true # serversentials.loom
  echest: true # serversentials.echest
  stonecutter: true # serversentials.stonecutter
  smithingtable: true # serversentials.smithingtable
  #---------MODERATION-----------
  invsee: true # serversentials.invsee
  vanish: true # serversentials.vanish || serversentials.vanish.see || serversentials.vanish.others
  gamemode: true # serversentials.gms/gmc/gmsp || serversentials.gms/gmc/gmsp.others
  fly: true # serversentials.fly || serversentials.fly.others
  monitor: true # serversentials.monitor
  #---------EXTRAS----------
  heal: true # serversentials.heal || serversentials.heal.others
  feed: true # serversentials.feed || serversentials.feed.others
  god: true # serversentials.god || serversentials.god.others
  item: # serversentials.item || serversentials.item.others <- /item command
    enabled: true
    respect-max-stack-size: true # true = don't allow oversized stacks
  enchant:
    respect-max-levels: true # true = don't allow over-limit enchants
  chat:
    enabled: true
    require-global-permission: true
    default-format: "<gray>{prefix}</gray><white>{player}</white><gray> » {message}</gray>"
    # formats are checked in defined order from top to bottom
    formats:
      - name: "admin"
        permission: "serversentials.chat.format.admin"
        format: "<red>[Admin]</red> <gold>{prefix}{player}</gold><dark_gray> »</dark_gray> <yellow>{message}</yellow>"
      - name: "vip"
        permission: "serversentials.chat.format.vip"
        format: "<aqua>[VIP]</aqua> <aqua>{prefix}{player}</aqua><gray> »</gray> <white>{message}</white>"
  #---------ECONOMY-------
  economy:
    enabled: true
    starting-balance: 100.0
    currency-symbol: "$"
    formatted: true # true = show commas and decimals, false = plain numbers
    decimals: 2 # number of decimal places

messages:
  no-permission: "<red>You do not have permission to use this command!</red>"
  player-not-found: "<red>Player not found!</red>"
  starting-balance: "<green>You received your starting balance of {symbol}{amount}!</green>"
  balance-display: "<green>{player}'s balance: <yellow>{symbol}{balance}</yellow>"
  pay-usage: "<red>Usage: /pay <player> <amount>"
  pay-insufficient: "<red>You do not have enough funds!"
  pay-sent: "<green>You sent {symbol}{amount} to {player}."
  pay-received: "<green>You received {symbol}{amount} from {player}."
  economy-usage: "<red>Usage: /economy <give/set/deduct> <player> <amount>"
  economy-success: "<green>{action} {symbol}{amount} for {player}."
  baltop-header: "<gold>--- Top balances - Page: {page} ----"
  baltop-line: "<yellow>{rank}. {player} - {symbol}{balance}"
  baltop-empty: "<red>No balances found!"
  invalid-number: "<red>Invalid number!"
  invalid-recipient: "<red>You cannot send money to yourself!"

⚙️ Dependencies: Vault (or any Vault-compatible economy/chat provider)

❤️ A Note from the Developer I am a 1-man team, I will do my best to release updates and fixes for this plugin as this is my #1 priority when it comes to plugin development now. For any issues and suggestions, please join my Discord Server.