Serversentials

# Serversentials **A high-performance, network-compatible, and Folia-ready utility suite designed to replace legacy essentials plugins on modern Minecraft servers and proxy networks.** --- !(https://cdn.modrinth.com/data/cached_images/b2de707d1f48d9cac075e9fc51ca39a5ef3837ac.jpeg) ## Overview Essentials suites often struggle when deployed on multi-threaded Folia environments or synchronized across proxy networks. **Serversentials** is built from the ground up to address these platform limitations. It operates as a unified, high-performance hybrid JAR capable of running on backend servers (Paper, Folia) and proxy servers (Velocity) simultaneously. ### Architecture Highlights * **Folia Optimization:** Asynchronous execution and global/region-specific task scheduling to ensure complete compatibility with Folia's multi-threaded region model. * **Hybrid JAR Architecture:** The same plugin file is loaded on both the backend game servers and your Velocity proxy. * **Dual-Dialect Storage:** High-performance database operations powered by HikariCP, supporting local SQLite file storage or network-synchronized MySQL databases. * **Automatic Configuration Migrator:** Upgrades configuration files seamlessly on plugin updates while preserving custom values, formatting, and inline comments. --- ## Feature Breakdown ### Network Teleportation & Movement * **Cross-Server Teleportation:** Send request-based `/tpa` and `/tpahere` teleports across different servers on your proxy network. Includes administrative bypass commands (`/tpo` and `/tpohere`). * **Session Tracking:** Hop back to your previous location or death coordinate across servers using `/back`. * **Utility Teleports:** Teleport to safe random coordinates within world borders using `/rtp`, or jump to the highest block above your coordinates with `/top`. * **Warps & Homes:** Set multi-home profiles (permission-capped) and global warps with support for custom warmups and cooldown timers. ### Chat & Messaging * **Cross-Server Whispering:** Perform private messaging network-wide using `/msg` and `/reply` with built-in `/socialspy` for administration. * **Staff Communication:** Staff-only channel using `/staffchat` to coordinate privately across the network. * **Modern Chat Renderer:** Fully custom chat formatting engine with MiniMessage syntax support, integrated with Vault/LuckPerms prefixes, suffixes, and display names. * **Connection Events:** Custom join and leave messages featuring PlaceholderAPI support, configurable to be toggled on or off independently. ### Extra Inventories (`/inv`) * **Multi-Profile Inventories:** Allows players to unlock and switch between up to 11 individual inventory profiles (1 base profile + 10 extra slots). * **Interactive GUI:** Preview profiles in a custom 54-slot chest interface displaying armor, offhand items, and player details. * **Administrative Management:** View or clear player inventories on demand using `/inv view` and `/inv clear`. * **Revocation Safety:** If a player loses permission for an inventory, it is set to "Locked" status, allowing them to extract their items safely but preventing new item storage. * **Custom NBT Support:** Safely serializes complex custom NBT data, making it fully compatible with custom item plugins like Nexo. ### Economy * **Network Transactions:** Send currency to players on the same server or across the proxy network with `/pay`. * **Vault Integration:** Fully hooks into Vault to act as a robust server economy provider. * **Leaderboards:** Display top currency holder statistics with `/baltop`. ### Moderation & Administration * **Live Perspective Monitoring:** The `/monitor` command allows administrators to enter spectator mode to monitor a player's perspective (locally or cross-server) and return safely to their original server, coordinates, and gamemode upon exit. * **Vanish Integration:** Hides vanished players from join queries and integrates with TAB/TAB-bridge to automatically remove vanished players from the global tablist. * **Suggestion Sanitization:** Dynamically filters command tab-completion suggestions so players only see commands they have permission to execute. --- ## Installation Guide ### Single Server Setup 1. Download the `Serversentials.jar` file. 2. Place the jar file inside your server's `plugins/` directory. 3. Start the server to generate the default configuration files. ### Proxy Network Setup (Velocity + Backend Servers) 1. Place the `Serversentials.jar` file inside your **Velocity proxy's** `plugins/` folder. 2. Place the same `Serversentials.jar` file inside the `plugins/` folder of all backend **Paper/Folia servers**. 3. Start the proxy and backend servers to generate the default configuration files. 4. On each backend server, edit `plugins/Serversentials/config.yml` and set the `server-name` key to match **exactly** the server's registered name in your Velocity `velocity.toml` configuration (e.g. `lobby`, `survival-1`). 5. Res