⚡Serversentials: The Essentials Replacement for Folia⚡

The drop-in solution when Essentials just won't cut it for your high-performance server.

---

📌 Why Serversentials?

Pretty annoying that Essentials doesn't support Folia right?

Well, Serversentials is here for you! This plugin provides you with everything Essentials does but better, modern, and with more features.

What makes Serversentials better?

• Serversentials is run by community suggestions! Just join our discord to submit your suggestion :)

---

✨ Core Features at a Glance

• Folia-Ready! Built and optimized for the high-performance Folia platform.
• Complete Essentials Commands: All the familiar commands you rely on, including /home, /warp, /god, /heal, and many more!
• Modern Utility GUIs: Seamless GUIs for commands like /craft, /echest, and /anvil.
• Robust Data Storage: Supports both SQLite (simple setup) and MySQL (performance for large networks).
• Integrated Economy: Full Economy module with automatic Vault-hooking.
• Clean Messaging: Uses Actionbar messages to prevent chat spam and keep your console clean.
• Modular Design: Toggle-able modules in the config—use only the features you want!
• Advanced Permissions: Granular, Permission-based control over home limits, cooldowns, and countdowns.
• PlaceholderAPI support included!

---

🔎 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!

---

⚔️ Commands & Permissions

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

Command	Aliases	Description	Required Permissions
Gamemode & Basic
/fly	-	Toggle flight mode for yourself.	serversentials.fly
/gms, /gmc, /gmsp	-	Change your gamemode.	serversentials.gms/gmc/gmsp
/nick	-	Change your display name/nickname.	serversentials.nick
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
Utility GUIs
/craft, /echest, /anvil, /loom, /smithingtable	ec, smith	Open portable crafting GUIs.	serversentials.craft/echest/anvil

More commands and permissions not listed here!

💻 PlaceholderAPI Support

Requires PlaceholderAPI (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.

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

  # 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
  #---------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!"

... and much more!

⚙️ Dependencies:

• Vault

❤️ 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.