# This determines the command prefix when there are conflicts (/name:home, /name:help, etc.) name: Essentials main: com.earth2me.essentials.Essentials # Note to developers: This next line cannot change, or the automatic versioning system will break. version: ${full.version} website: https://essentialsx.net/ description: Provides an essential, core set of commands for Bukkit. softdepend: [Vault, LuckPerms] authors: [Zenexer, ementalo, Aelux, Brettflan, KimKandor, snowleo, ceulemans, Xeology, KHobbits, md_5, Iaccidentally, drtshock, vemacs, SupaHam, md678685] api-version: "1.13" commands: afk: description: Marks you as away-from-keyboard. usage: / [player/message...] aliases: [eafk,away,eaway] antioch: description: 'A little surprise for operators.' usage: / [message] aliases: [eantioch,grenade,egrenade,tnt,etnt] back: description: Teleports you to your location prior to tp/spawn/warp. usage: / [player] aliases: [eback,return,ereturn] backup: description: Runs the backup if configured. usage: / aliases: [ebackup] balance: description: States the current balance of a player. usage: / [player] aliases: [bal,ebal,ebalance,money,emoney] balancetop: description: Gets the top balance values. usage: / aliases: [ebalancetop,baltop,ebaltop] ban: description: Bans a player. usage: / [reason] aliases: [eban] banip: description: Bans an IP address. usage: /
aliases: [ebanip] beezooka: description: Throw an exploding bee at your opponent. usage: / aliases: [ebeezooka,beecannon,ebeecannon] book: description: Allows reopening and editing of sealed books. usage: / [title|author [name]] aliases: [ebook] break: description: Breaks the block you are looking at. usage: / aliases: [ebreak] broadcast: description: Broadcasts a message to the entire server. usage: / aliases: [bc,ebc,bcast,ebcast,ebroadcast,shout,eshout] broadcastworld: description: Broadcasts a message to a world. usage: / aliases: [bcw,ebcw,bcastw,ebcastw,ebroadcastworld,shoutworld,eshoutworld] bigtree: description: Spawn a big tree where you are looking. usage: / aliases: [ebigtree,largetree,elargetree] burn: description: Set a player on fire. usage: / aliases: [eburn] clearinventory: description: Clear all items in your inventory. usage: / [player|*] [item[:]|*|**] [amount] aliases: [ci,eci,clean,eclean,clear,eclear,clearinvent,eclearinvent,eclearinventory] clearinventoryconfirmtoggle: description: Toggles whether you are prompted to confirm inventory clears. usage: / aliases: [eclearinventoryconfirmtoggle, clearinventoryconfirmoff, eclearinventoryconfirmoff, clearconfirmoff, eclearconfirmoff, clearconfirmon, eclearconfirmon, clearconfirm, eclearconfirm] condense: description: Condenses items into a more compact blocks. usage: / [||hand|inventory] aliases: [econdense,compact,ecompact,blocks,eblocks,toblocks,etoblocks] compass: description: Describes your current bearing. usage: / aliases: [ecompass,direction,edirection] createkit: description: Create a kit in game! usage: / aliases: [kitcreate,createk,kc,ck] customtext: description: Allows you to create custom text commands. usage: / - Define in bukkit.yml delhome: description: Removes a home. usage: / [player:] aliases: [edelhome,remhome,eremhome,rmhome,ermhome] deljail: description: Removes a jail. usage: / aliases: [edeljail,remjail,eremjail,rmjail,ermjail] delkit: description: Deletes the specified kit. usage: / aliases: [edelkit,remkit,eremkit,rmkit,ermkit,deletekit,edeletekit] delwarp: description: Deletes the specified warp. usage: / aliases: [edelwarp,remwarp,eremwarp,rmwarp,ermwarp] depth: description: States current depth, relative to sea level. usage: /depth aliases: [edepth,height,eheight] disposal: description: Opens a portable disposal menu. usage: / aliases: [edisposal,trash,etrash] eco: description: Manages the server economy. usage: / aliases: [eeco,economy,eeconomy] enchant: description: Enchants the item the user is holding. usage: / [level] aliases: [eenchant,enchantment,eenchantment] enderchest: description: Lets you see inside an enderchest. usage: / [player] aliases: [echest,eechest,eenderchest,endersee,eendersee,ec,eec] essentials: description: Reloads essentials. usage: / aliases: [eessentials, ess, eess, essversion] exp: description: Give, set or look at a players exp. usage: / [show|set|give] [playername [amount]] aliases: [eexp,xp] ext: description: Extinguish players. usage: / [player] aliases: [eext,extinguish,eextinguish] feed: description: Satisfy the hunger. usage: / [player] aliases: [eat,eeat,efeed] fly: description: Take off, and soar! usage: / [player] [on|off] aliases: [efly] fireball: description: Throw a fireball or other assorted projectiles. usage: / [fireball|small|large|arrow|skull|egg|snowball|expbottle|dragon|splashpotion|lingeringpotion|trident] [speed] aliases: [efireball,fireentity,efireentity,fireskull,efireskull] firework: description: Allows you to modify a stack of fireworks. usage: / <|power [amount]|clear|fire [amount]> aliases: [efirework] gamemode: description: Change player gamemode. usage: / [player] aliases: [adventure,eadventure,adventuremode,eadventuremode,creative,ecreative,eecreative,creativemode,ecreativemode,egamemode,gm,egm,gma,egma,gmc,egmc,gms,egms,gmt,egmt,survival,esurvival,survivalmode,esurvivalmode,gmsp,sp,egmsp,spec,spectator] gc: description: Reports memory, uptime and tick info. usage: / [all] aliases: [lag,elag,egc,mem,emem,memory,ememory,uptime,euptime,tps,etps,entities,eentities] getpos: description: Get your current coordinates or those of a player. usage: / [player] aliases: [coords,egetpos,position,eposition,whereami,ewhereami,getlocation,egetlocation,getloc,egetloc] give: description: Give a player an item. usage: / [amount [itemmeta...]] aliases: [egive] god: description: Enables your godly powers. usage: / [player] [on|off] aliases: [egod,godmode,egodmode,tgm,etgm] hat: description: Get some cool new headgear. usage: / [remove] aliases: [ehat,head,ehead] heal: description: Heals you or the given player. usage: / [player] aliases: [eheal] help: description: Views a list of available commands. usage: / [search term] [page] aliases: [ehelp] helpop: description: Message online admins. usage: / aliases: [ac,eac,amsg,eamsg,ehelpop] home: description: Teleport to your home. usage: / [player:][name] aliases: [ehome,homes,ehomes] ignore: description: Ignore or unignore other players. usage: / aliases: [eignore,unignore,eunignore,delignore,edelignore,remignore,eremignore,rmignore,ermignore] info: description: Shows information set by the server owner. usage: / [chapter] [page] aliases: [about,eabout,ifo,eifo,einfo,inform,einform,news,enews] invsee: description: See the inventory of other players. usage: / aliases: [einvsee] item: description: Spawn an item. usage: / [amount [itemmeta...]] aliases: [i,eitem,ei] itemdb: description: Searches for an item. usage: / aliases: [dura,edura,durability,edurability,eitemdb,itemno,eitemno] itemlore: description: Edit the lore of an item. usage: / [text/line] [text] aliases: [lore, elore, ilore, eilore, eitemlore] itemname: description: Names an item. usage: / [name] aliases: [iname, einame, eitemname, itemrename, irename, eitemrename, eirename] jails: description: List all jails. usage: / aliases: [ejails] jump: description: Jumps to the nearest block in the line of sight. usage: / aliases: [j,ej,ejump,jumpto,ejumpto] kick: description: Kicks a specified player with a reason. usage: / [reason] aliases: [ekick] kickall: description: Kicks all players off the server except the issuer. usage: / [reason] aliases: [ekickall] kill: description: Kills specified player. usage: / aliases: [ekill] kit: description: Obtains the specified kit or views all available kits. usage: / [kit] [player] aliases: [ekit,kits,ekits] kittycannon: description: Throw an exploding kitten at your opponent. usage: / aliases: [ekittycannon] lightning: description: The power of Thor. Strike at cursor or player. usage: / [player] [power] aliases: [elightning,shock,eshock,smite,esmite,strike,estrike,thor,ethor] list: description: List all online players. usage: / [group] aliases: [elist,online,eonline,playerlist,eplayerlist,plist,eplist,who,ewho] mail: description: Manages inter-player, intra-server mail. usage: / [read|clear|send [to] [message]|sendall [message]] aliases: [email,eemail,memo,ememo] me: description: Describes an action in the context of the player. usage: / aliases: [action,eaction,describe,edescribe,eme] more: description: Fills the item stack in hand to specified amount, or to maximum size if none is specified. usage: / [amount] aliases: [emore] motd: description: Views the Message Of The Day. usage: / [chapter] [page] aliases: [emotd] msg: description: Sends a private message to the specified player. usage: / aliases: [w,m,t,pm,emsg,epm,tell,etell,whisper,ewhisper] msgtoggle: description: Blocks receiving all private messages. usage: / [player] [on|off] aliases: [emsgtoggle] mute: description: Mutes or unmutes a player. usage: / [datediff] [reason] aliases: [emute,silence,esilence] near: description: Lists the players near by or around a player. usage: / [playername] [radius] aliases: [enear,nearby,enearby] nick: description: Change your nickname or that of another player. usage: / [player] aliases: [enick,nickname,enickname] nuke: description: May death rain upon them. usage: / [player] aliases: [enuke] tpoffline: description: Teleport to a player's last known logout location usage: / aliases: [otp, offlinetp, tpoff, tpoffline] pay: description: Pays another player from your balance. usage: / aliases: [epay] paytoggle: description: Toggles whether you are accepting payments. usage: / aliases: [epaytoggle, payoff, epayoff, payon, epayon] payconfirmtoggle: description: Toggles whether you are prompted to confirm payments. usage: / aliases: [epayconfirmtoggle, payconfirmoff, epayconfirmoff, payconfirmon, epayconfirmon, payconfirm, epayconfirm] ping: description: Pong! usage: / aliases: [echo,eecho,eping,pong,epong] potion: description: Adds custom potion effects to a potion. usage: / power: duration:> aliases: [epotion,elixer,eelixer] powertool: description: Assigns a command to the item in hand. usage: / [l:|a:|r:|c:|d:][command] [arguments] - {player} can be replaced by name of a clicked player. aliases: [epowertool,pt,ept] powertooltoggle: description: Enables or disables all current powertools. usage: / aliases: [epowertooltoggle,ptt,eptt,pttoggle,epttoggle] ptime: description: Adjust player's client time. Add @ prefix to fix. usage: / [list|reset|day|night|dawn|17:30|4pm|4000ticks] [player|*] aliases: [playertime,eplayertime,eptime] pweather: description: Adjust a player's weather usage: / [list|reset|storm|sun|clear] [player|*] aliases: [playerweather,eplayerweather,epweather] r: description: Quickly reply to the last player to message you. usage: / aliases: [er,reply,ereply] rtoggle: description: Change whether the recipient of the reply is last recipient or last sender usage: / [player] [on|off] aliases: [ertoggle, replytoggle, ereplytoggle] realname: description: Displays the username of a user based on nick. usage: / aliases: [erealname] recipe: description: Displays how to craft items. usage: / [number] aliases: [formula,eformula,method,emethod,erecipe,recipes,erecipes] remove: description: Removes entities in your world. usage: / [radius|world] aliases: [eremove,butcher,ebutcher,killall,ekillall,mobkill,emobkill] repair: description: Repairs the durability of one or all items. usage: / [hand|all] aliases: [fix,efix,erepair] rest: description: Rests you or the given player. usage: / [player] aliases: [erest] rules: description: Views the server rules. usage: / [chapter] [page] aliases: [erules] seen: description: Shows the last logout time of a player. usage: / aliases: [eseen] sell: description: Sells the item currently in your hand. usage: / <||hand|inventory|blocks> [-][amount] aliases: [esell] sethome: description: Set your home to your current location. usage: / [[player:]name] aliases: [esethome,createhome,ecreatehome] setjail: description: Creates a jail where you specified named [jailname]. usage: / aliases: [esetjail,createjail,ecreatejail] settpr: description: Set the random teleport location and parameters. usage: / [center|minrange|maxrange] [value] aliases: [esettpr, settprandom, esettprandom] setwarp: description: Creates a new warp. usage: / aliases: [createwarp,ecreatewarp,esetwarp] setworth: description: Set the sell value of an item. usage: / [itemname|id] aliases: [esetworth] showkit: description: Show contents of a kit. usage: / aliases: [kitpreview,preview,kitshow] editsign: description: Edits a sign in the world. usage: / [text] aliases: [sign, esign, eeditsign] skull: description: Set the owner of a player skull usage: / [owner] aliases: [eskull, playerskull, eplayerskull, head, ehead] socialspy: description: Toggles if you can see msg/mail commands in chat. usage: / [player] [on|off] aliases: [esocialspy] spawner: description: Change the mob type of a spawner. usage: / [delay] aliases: [changems,echangems,espawner,mobspawner,emobspawner] spawnmob: description: Spawns a mob. usage: / [:data][,[:data]] [amount] [player] aliases: [mob,emob,spawnentity,espawnentity,espawnmob] speed: description: Change your speed limits. usage: / [type] [player] aliases: [flyspeed,eflyspeed,fspeed,efspeed,espeed,walkspeed,ewalkspeed,wspeed,ewspeed] sudo: description: Make another user perform a command. usage: / aliases: [esudo] suicide: description: Causes you to perish. usage: / aliases: [esuicide] tempban: description: Temporary ban a user. usage: / aliases: [etempban] tempbanip: description: Temporarily ban an IP Address. usage: / aliases: [etempbanip] thunder: description: Enable/disable thunder. usage: / [duration] aliases: [ethunder] time: description: Display/Change the world time. Defaults to current world. usage: / [day|night|dawn|17:30|4pm|4000ticks] [worldname|all] aliases: [day,eday,night,enight,etime] togglejail: description: Jails/Unjails a player, TPs them to the jail specified. usage: / [datediff] aliases: [jail,ejail,tjail,etjail,etogglejail,unjail,eunjail] top: description: Teleport to the highest block at your current position. usage: / aliases: [etop] tp: description: Teleport to a player. usage: / [otherplayer] aliases: [tele,etele,teleport,eteleport,etp,tp2p,etp2p] tpa: description: Request to teleport to the specified player. usage: / aliases: [call,ecall,etpa,tpask,etpask] tpaall: description: Requests all players online to teleport to you. usage: / aliases: [etpaall] tpaccept: description: Accepts a teleport request. usage: / [otherplayer] aliases: [etpaccept,tpyes,etpyes] tpahere: description: Request that the specified player teleport to you. usage: / aliases: [etpahere] tpall: description: Teleport all online players to another player. usage: / aliases: [etpall] tpauto: description: Automatically accept teleportation requests. usage: / aliases: [etpauto] tpacancel: description: Cancel all outstanding teleport requests. Specify [player] to cancel requests with them. usage: / [player] aliases: [etpacancel] tpdeny: description: Reject a teleport request. usage: / aliases: [etpdeny,tpno,etpno] tphere: description: Teleport a player to you. usage: / aliases: [s,etphere] tpo: description: Teleport override for tptoggle. usage: / [otherplayer] aliases: [etpo] tpohere: description: Teleport here override for tptoggle. usage: / aliases: [etpohere] tppos: description: Teleport to coordinates. usage: / [yaw] [pitch] [world] aliases: [etppos] tpr: description: Teleport randomly. usage: / aliases: [etpr, tprandom, etprandom] tptoggle: description: Blocks all forms of teleportation. usage: / [player] [on|off] aliases: [etptoggle] tree: description: Spawn a tree where you are looking. usage: / aliases: [etree] unban: description: Unbans the specified player. usage: / aliases: [pardon,eunban,epardon] unbanip: description: Unbans the specified IP address. usage: /
aliases: [eunbanip,pardonip,epardonip] unlimited: description: Allows the unlimited placing of items. usage: / [player] aliases: [eunlimited,ul,unl,eul,eunl] vanish: description: Hide yourself from other players. usage: / [player] [on|off] aliases: [v,ev,evanish] warp: description: List all warps or warp to the specified location. usage: / [player] aliases: [ewarp,warps,ewarps] weather: description: Sets the weather. usage: / [duration] aliases: [rain,erain,sky,esky,storm,estorm,sun,esun,eweather] whois: description: Determine the username behind a nickname. usage: / aliases: [ewhois] workbench: description: Opens up a workbench. usage: / aliases: [craft,ecraft,wb,ewb,wbench,ewbench,eworkbench] world: description: Switch between worlds. usage: / [world] aliases: [eworld] worth: description: Calculates the worth of items in hand or as specified. usage: / <||hand|inventory|blocks> [-][amount] aliases: [eprice,price,eworth] permissions: essentials.*: default: op description: Give players with op everything by default children: essentials.gamemode.*: true # These permissions can't be assigned from player-commands for compatibility reasons essentials.teleport.cooldown.bypass.tpa: default: true description: If the player does not have this permission, /tpa will have cooldown even with the parent bypass perm essentials.teleport.cooldown.bypass.back: default: true description: If the player does not have this permission, /back will have cooldown even with the parent bypass perm essentials.gamemode.*: default: op children: essentials.gamemode: true essentials.gamemode.others: true essentials.gamemode.all: true essentials.seen.extra: default: op children: essentials.seen.ip: true essentials.seen.location: true essentials.keepinv: default: false description: Controls whether players keep their inventory on death. essentials.near.exclude: default: false description: If the player should be excluded from near lookups. essentials.keepxp: default: false description: Allows the user to keep their exp on death, instead of dropping it. essentials.invsee.preventmodify: default: false description: Prevents other players from modifying the players inventory. essentials.afk.auto: default: false description: Players with this permission will be set to afk after a period of inaction as defined in the config file. essentials.home.compass: default: false description: Point the player's compass at their first home. compass-towards-home-perm needs to be enabled in the configuration. essentials.ban.exempt: default: false description: Prevent a specified group or player from being banned essentials.kick.exempt: default: false description: Prevents the player from being kicked. essentials.chat.ignoreexempt: default: false description: Someone with this permission will not be ignored, even if they are on another persons ignore list essentials.kit.exemptdelay: default: false description: Exempts you from the kit delay feature, this affects signs as well as command. essentials.mute.exempt: default: false description: Prevent a specified group or player from being muted essentials.sethome.bed: default: false description: Allows the player to right click a bed during daytime to update their 'bed' home. essentials.silentjoin: default: false description: Allow to join silently essentials.silentjoin.vanish: default: false description: Allow to join silently, and get put in vanish mode essentials.silentquit: default: false description: Suppress leave/quit messages for users with this permission. essentials.sleepingignored: default: false description: User isn't required to be sleeping, for time to be reset. essentials.sudo.exempt: default: false description: Prevents the holder from being sudo'ed by another user essentials.tempban.exempt: default: false description: Prevents a specified group or player from being tempbanned essentials.nick.allowunsafe: default: false description: If a player has this, they can set their username to any value. Use with caution, as this has the potential to break userdata files. essentials.balancetop.exclude: default: false description: Players with this permission are excluded from the balancetop essentials.back.onteleport: default: true description: Players with this permission will have back location stored during any teleportation essentials.back.ondeath: default: false description: Players with this permission will have back location stored during death essentials.exempt: default: false description: Parent permission to be exempt from many moderator actions children: essentials.invsee.preventmodify: true essentials.ban.exempt: true essentials.kick.exempt: true essentials.mute.exempt: true essentials.chat.ignoreexempt: true essentials.sudo.exempt: true essentials.tempban.exempt: true essentials.exempt.protect: true