Skip to content

Core Features

Reece Williams edited this page Sep 2, 2026 · 2 revisions

Core Features

ServerTools' "Core" is the Essentials-style command set: fly, heal, tp, warps, spawn, messaging, and the usual player and staff utilities. Everything lives under the Core: section of config.yml, and each command flips on or off with its own Enabled flag.

Needs: nothing for most of these. Repair only charges money if you have Vault + an economy - without it, repairs are free.

The permission nodes look like essentials.fly and so on. That's just the naming style for familiarity, you do NOT need EssentialsX installed for any of this.

Player utilities

Ping Core.Ping (off by default). /ping shows your real ping in ms. No perm node needed.

Realname Core.Realname (off). /realname <player> tells you the actual account name behind an online player. Perm essentials.realname.

Compass Core.Compass (off). /compass prints the direction you're facing plus bearing in degrees. Perm essentials.compass.

Hat Core.Hat (on). /hat swaps the item in your hand onto your head, and back. Perm essentials.hat.

Workbench Core.Workbench (on). /workbench or /craft opens a crafting table anywhere. Perm essentials.workbench.

Trash Core.Trash (on). /trash opens a throwaway 54-slot inventory. Close it and the items are gone. No perm node.

Fly Core.Fly (on). /fly toggles your flight. /fly <player> toggles someone else's if you have essentials.fly.others. Base perm essentials.fly.

Enchant Core.Enchant (on). /enchant <name> [level] adds an enchant to the held item, and it can go past vanilla level caps. Perm essentials.enchant.

Nickname Core.Nickname (off). /nick <name/off> sets a display and tab name, 3-20 chars, and rejects names already in use. A prefix (default ~) shows in chat unless the player has the bypass perm. Perms nickname.use, nickname.prefixbypass.

Top Core.Top (on). /top teleports you onto the highest block above you. Perm essentials.top.

Repair Core.Repair (off). /repair (or /fix) mends the held tool, weapon, or armor. /repair all mends everything. Enchanted items need repair.enchanted. If you've got Vault + an economy it charges per repair, otherwise it's free. Single Cost defaults to 1500 (perm essentials.repair), All Cost to 15000 (perm essentials.repair.all).

Staff and admin

God Core.God (off). /god toggles damage immunity and auto-heal for yourself. Clears when you quit. Perm essentials.god.

Extinguish Core.Extinguish (off). /extinguish puts out fire on yourself. With the staff perm you can do /extinguish <player> on others. Perms essentials.ext, essentials.ext.others.

ClearInv Core.ClearInv (on). /clearinv empties your inventory. /clearinv <player> clears someone else. Base perm essentials.clearinventory (add .others for clearing others).

Heal Core.Heal (on). /heal (self), /feed (food only), /healall (everyone online). Perms: essentials.heal, essentials.feed, and essentials.heal.others for healall. Console can target a named player.

Gamemode Core.Gamemode (on). /gamemode <mode> plus shortcuts /gm /gms /gmc /gma /gmsp. Each mode has its own perm: essentials.gamemode.creative/survival/spectator/adventure. Console skips the perm checks.

InvSee Core.InvSee (off). /invsee <player> opens their live inventory (/invsee <player> <anything> shows armor). It's view-only unless you grant the modify perm. Perms: view essentials.invsee, edit others essentials.invsee.modify. You can also mark certain players as protected from edits with essentials.invsee.preventmodification.

Enderchest Core.Enderchest (off). /enderchest opens your own. To open someone else's you need the others perm, and to actually edit it you need the modify perm. Perms: essentials.enderchest, view others essentials.enderchest.others, edit essentials.enderchest.modify.

Broadcast Core.Broadcast (on). /broadcast <msg> sends a server-wide message using your configured format. Perm essentials.broadcast.

AdminChat Core.AdminChat (on). /adminchat <msg> broadcasts only to players who hold the perm, and logs to console too. Perm tools.adminchat.

Messaging

Messaging Core.Messaging (on). Covers /msg, /r, /socialspy, /togglemsg, and /disablemessaging.

  • Social spy lets staff see all private messages live.
  • Players can toggle receiving PMs with /togglemsg. Staff with the bypass perm can still message them.
  • /disablemessaging halts PMs server-wide.
  • Optional ping sound when a message arrives (Sound.Enabled, default BLOCK_NOTE_BLOCK_PLING).

Formats and perms are all configurable:

Permissions:
  Message: essentials.message
  Reply: essentials.reply
  SocialSpy: essentials.socialspy
  ToggleMSG: essentials.togglemsg
  DisableMessaging: chat.disablemessaging
  StaffBypass: staff.bypassdisabledmsg

Teleport and spawn

Teleport Core.Teleport (on). Handles /tp, /tpo, /tpa (the request/accept flow with /tpaccept and /tpdeny), and /tphere. Console can do /tp <player> <target> or /tp <player> <x> <y> <z>. Perms: essentials.tp, essentials.tpa, essentials.tphere.

Spawn Core.Spawn (on). /spawn teleports you. /spawn <player> sends someone else (needs the admin perm). /setspawn saves the spot. It also handles respawns and first-time joins. Options you'd set:

  • spawnFirstUniqueJoinOnly - send brand-new players to spawn on their first join (default true).
  • onJoinInstantly - send everyone to spawn on every join (default false).
  • teleportWhenInVoid - yank players out of the void back to spawn, with a message and a per-world disabledWorlds skip list.

Perms: spawn.use for the command, spawn.admin for setspawn and sending others.

Warps Core.Warps (on). /warp <name> [player], /warps (paged list), /setwarp <name> [perm], /delwarp <name>, /warpinfo <name>. Warps stick around between restarts and can carry an optional per-warp permission, so locked warps show red in the list and stay hidden from tab-complete. Warping another player needs the warp-other perm. Config perms:

DeleteWarpPerm: tools.delwarp
SetWarpPerm: tools.setwarp
ViewWarpPerm: tools.viewwarp
WarpOtherPlayToWarpPerm: tools.warpother

Clone this wiki locally