McConfig - EssentialsX Generator

Essentials Global

A color code between 0-9 or a-f.
Set to 'none' to disable.

The character(s) to prefix all nicknames, so that you know they are not true usernames.
If left blank, nickname prefix will be disabled.

The maximum length allowed in nicknames.
The nickname prefix is included in this.


When this option is enabled, nickname length checking will exclude color codes in player names.
ie: "&6Notch" has 7 characters (2 are part of a color code), a length of 5 is used when this option is set to true


Disable this if you have any other plugin, that modifies the displayname of a user.


When this option is enabled, the (tab) player list will be updated with the displayname.
The value of change-displayname (above) has to be true.


When EssentialsChat.jar isn't used, force essentials to add the prefix and suffix from permission plugins to displayname.
This setting is ignored if EssentialsChat.jar is used, and defaults to 'true'.
The value of change-displayname (above) has to be true.
Do not edit this setting unless you know what you are doing!


If the teleport destination is unsafe, should players be teleported to the nearest safe location?
If this is set to true, Essentials will attempt to teleport players close to the intended destination.
If this is set to false, attempted teleports to unsafe locations will be cancelled with a warning.


This forcefully disables teleport safety checks without a warning if attempting to teleport to unsafe locations.
teleport-safety and this option need to be set to true to force teleportation to dangerous locations.

The delay, in seconds, required between /home, /tp, etc.

The delay, in seconds, before a user actually teleports. If the user moves or gets attacked in this timeframe, the teleport never occurs.

The delay, in seconds, a player can't be attacked by other players after they have been teleported by a command.
This will also prevent the player attacking other players.


Whether to make all teleportations go to the center of the block; where the x and z coordinates decimal become .5

The delay, in seconds, required between /heal or /feed attempts.

The default radius with /near
Used to use chat radius but we are going to make it separate.

What to prevent from /item and /give.
Example: 10,11,46
Default is left blank.


Set this to true if you want permission based item spawn rules.
Note: The blacklist above will be ignored then.
Example permissions (these go in your permissions manager):
- essentials.itemspawn.item-all
- essentials.itemspawn.item-[itemname]
- essentials.itemspawn.item-[itemid]
- essentials.give.item-all
- essentials.give.item-[itemname]
- essentials.give.item-[itemid]
- essentials.unlimited.item-all
- essentials.unlimited.item-[itemname]
- essentials.unlimited.item-[itemid]
- essentials.unlimited.item-bucket Unlimited liquid placing
For more information, visit http://wiki.ess3.net/wiki/Command_Reference/ICheat#Item.2FGive

Mob limit on the /spawnmob command per execution.


Shall we notify users when using /lightning?


Shall we drop items instead of adding to inventory if the target inventory is full?


Should we notify players if they have no new mail?

When a command conflicts with another plugin, by default, Essentials will try to force the OTHER plugin to take priority.
Commands in this list, will tell Essentials to 'not give up' the command to other plugins.
In this state, which plugin 'wins' appears to be almost random.
If you have two plugin with the same command and you wish to force Essentials to take over, you need an alias.
To force essentials to take 'god' alias 'god' to 'egod'.
See http://wiki.bukkit.org/Commands.yml#aliases for more information.

Disabling commands here will prevent Essentials handling the command, this will not affect command conflicts.
You should not have to disable commands used in other plugins, they will automatically get priority.
See http://wiki.bukkit.org/Commands.yml#aliases to map commands to other plugins.

These commands will be shown to players with socialSpy enabled.
You can add commands from other plugins you may want to track or
remove commands that are used for something you dont want to spy on.
Set - '*' in order to listen on all possible commands.

These commands will be disabled when a player is muted.
Use '*' to disable every command.
Essentials already disabled Essentials messaging commands by default.
It only cares about the root command, not args after that (it sees /f chat the same as /f)

If you do not wish to use a permission system, you can define a list of 'player perms' below.
This list has no effect if you are using a supported permissions system.
If you are using an unsupported permissions system, simply delete this section.
Whitelist the commands and permissions you wish to give players by default (everything else is op only).
These are the permissions without the "essentials." part.


When this option is enabled, one-time use kits (ie. delay < 0) will be.
removed from the /kit list when a player can no longer use it

Note: All items MUST be followed by a quantity!
All kit names should be lower case, and will be treated as lower in permissions/costs.
Syntax: - itemID[:DataValue/Durability] Amount [Enchantment:Level].. [itemmeta:value]...
For Item Meta information visit http://wiki.ess3.net/wiki/Item_Meta
'delay' refers to the cooldown between how often you can use each kit, measured in seconds.
Set delay to -1 for a one time kit.
For more information, visit http://wiki.ess3.net/wiki/Kits

Essentials Sign Control
See http://wiki.ess3.net/wiki/Sign_Tutorial for instructions on how to use these.
To enable signs, remove # symbol. To disable all signs, comment/remove each sign.
Essentials colored sign support will be enabled when any sign types are enabled.
Color is not an actual sign, it's for enabling using color codes on signs, when the correct permissions are given.


















How many times per second can Essentials signs be interacted with per player.
Values should be between 1-20, 20 being virtually no lag protection.
Lower numbers will reduce the possibility of lag, but may annoy players.

Interval in minutes.
Unless you add a valid backup command or script here, this feature will be useless.
Use 'save-all' to simply force regular world saving without backup.

You'll need to manually set the backup command after generating this config if you do use this feature.



Set this true to enable permission per warp.

Sort output of /list command by groups.
You can hide and merge the groups displayed in /list by defining the desired behaviour here.
Detailed instructions and examples can be found on the wiki: http://wiki.ess3.net/wiki/List


More output to the console.



Set the locale for all messages.
If you don't set this, the default locale of the server will be used.
For example, to set language to English, set locale to en, to use the file "messages_en.properties".


Turn off god mode when people leave the server.

After this timeout in seconds, the user will be set as AFK.
This feature requires the player to have essentials.afk.auto node.
Set to -1 for no timeout.

After this timeout in seconds, the user will be kicked from the server.
essentials.afk.kickexempt node overrides this feature.
Set to -1 for no timeout.


Set this to true, if you want to freeze the player, if the player is AFK.
Other players or monsters can't push the player out of AFK mode then.
This will also enable temporary god mode for the AFK player.
The player has to use the command /afk to leave the AFK mode.


When the player is AFK, should he be able to pickup items?
Enable this, when you don't want people idling in mob traps.


This setting controls if a player is marked as active on interaction.
Enable this, when you don't want people idling in mob traps.


Should we automatically remove afk status when a player moves?
Player will be removed from AFK on chat/command regardless of this setting.
Disable this to reduce server lag.

Set the player's list name when they are AFK.
This is none by default which specifies that Essentials should not interfere with the AFK player's list name.
You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.


You can disable the death messages of Minecraft here.


Should players with permissions be able to join and part silently?
You can control this with essentials.silentjoin and essentials.silentquit permissions if it is enabled.
In addition, people with essentials.silentjoin.vanish will be vanished on join.

You can set a custom join message here, set to "none" to disable.
You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.

You can set a custom quit message here, set to "none" to disable.
You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.

Add worlds to this list, if you want to automatically disable god mode there.


Set to true to enable per-world permissions for teleporting between worlds with essentials commands.
This applies to /world, /back, /tp[a|o][here|all], but not warps.
Give someone permission to teleport to a world with essentials.worlds.<worldname>
This does not affect the /home command, there is a separate toggle below for this.

The number of items given if the quantity parameter is left out in /item or /give.
If this number is below 1, the maximum stack size size is given.
If over-sized stacks are not enabled, any number higher than the maximum stack size results in more than one stack.

Over-sized stacks are stacks that ignore the normal max stack size.
They can be obtained using /give and /item, if the player has essentials.oversizedstacks permission.
How many items should be in an over-sized stack?


Allow repair of enchanted weapons and armor.
If you set this to false, you can still allow it for certain players using the permission.
essentials.repair.enchanted


Allow 'unsafe' enchantments in kits and item spawning.
Warning: Mixing and overleveling some enchantments can cause issues with clients, servers and plugins.


Do you want Essentials to keep track of previous location for /back in the teleport listener?
If you set this to true any plugin that uses teleport will have the previous location registered.

Delay to wait before people can cause attack damage after logging in.

Set the max fly speed, values range from 0.1 to 1.0

Set the max walk speed, values range from 0.1 to 1.0

Set the maximum amount of mail that can be sent within a minute.

Set the maximum time /tempban can be used for in seconds.
Set to -1 to disable, and essentials.tempban.unlimited can be used to override.


Changes /reply functionality. If true, /r goes to the person you messaged last, otherwise the first person that messaged you.
If false, /r goes to the last person that messaged you.

If last-message-reply-recipient is true, this specifies the duration, in seconds, that would need to elapse for the reply-recipient to update when receiving a message.


Toggles whether or not right clicking mobs with a milk bucket turns them into a baby.


Toggles whether or not the fly status message should be sent to players on join.


Set to true to enable per-world permissions for setting time for individual worlds with essentials commands.
This applies to /time, /day, /eday, /night, /enight, /etime.
Give someone permission to teleport to a world with essentials.time.world.<worldname>.

Essentials Home


Allows people to set their bed at daytime.


Set to true to enable per-world permissions for using homes to teleport between worlds.
This applies to the /home only.
Give someone permission to teleport to a world with essentials.worlds.<worldname>

Allow players to have multiple homes.
Players need essentials.sethome.multiple before they can have more than 1 home.
You can set the default number of multiple homes using the 'default' rank below.
To remove the home limit entirely, give people 'essentials.sethome.multiple.unlimited'.
To grant different home amounts to different people, you need to define a 'home-rank' below.
Create the 'home-rank' below, and give the matching permission: essentials.sethome.multiple.<home-rank>
For more information, visit http://wiki.ess3.net/wiki/Multihome
In this example someone with 'essentials.sethome.multiple' and 'essentials.sethome.multiple.vip' will have 5 homes.
Remember, they MUST have both permission nodes in order to be able to set multiple homes.


Set the timeout, in seconds for players to accept a tpa before the request is cancelled.
Set to 0 for no timeout.

Essentials Economy

Defines the balance with which new players begin.
Defaults to 0.



Defines the cost to use the given commands PER USE.
Some commands like /repair have sub-costs, check the wiki for more information.

Set this to a currency symbol you want to use.
Remember, if you want to use special characters in this document, such as accented letters, you MUST save the file as UTF-8, not ANSI.

Set the maximum amount of money a player can have.
The amount is always limited to 10 trillion because of the limitations of a java double.

Set the minimum amount of money a player can have (must be above the negative of max-money).
Setting this to 0, will disable overdrafts/loans completely. Users need 'essentials.eco.loan' perm to go below 0.


Enable this to log all interactions with trade/buy/sell signs and sell command.


Use this option to force superperms-based permissions handler regardless of detected installed perms plugin.
This is useful if you want superperms-based permissions (with wildcards) for custom permissions plugins.

Minimum acceptable amount to be used in /pay.

Essentials Help


Show other plugins commands in help.


Hide plugins which do not give a permission.
You can override a true value here for a single plugin by adding a permission to a user/group.
The individual permission is: essentials.help.<plugin>, anyone with essentials.* or '*' will see all help regardless.
You can use negative permissions to remove access to just a single plugins help if the following is enabled.

Essentials Chat

If EssentialsChat is installed, this will define how far a player's voice travels, in blocks. Set to 0 to make all chat global.
Note that users with the "essentials.chat.spy" permission will hear everything, regardless of this setting.
Users with essentials.chat.shout can override this by prefixing text with an exclamation mark (!)
Users with essentials.chat.question can override this by prefixing text with a question mark (?)
You can add command costs for shout/question by adding chat-shout and chat-question to the command costs section."

Chat formatting can be done in two ways, you can either define a standard format for all chat.
Or you can give a group specific chat format, to give some extra variation.
For more information of chat formatting, check out the wiki: http://wiki.ess3.net/wiki/Chat_Formatting



Chat formatting can be done in two ways, you can either define a standard format for all chat.
Or you can give a group specific chat format, to give some extra variation.
For more information of chat formatting, check out the wiki: http://wiki.ess3.net/wiki/Chat_Formatting

Essentials Protect

























































Maximum height the creeper should explode. -1 allows them to explode everywhere.
Set prevent.creeper-explosion to true, if you want to disable creeper explosions.














Essentials Anti Build


Should people with build: false in permissions be allowed to build?
Set true to disable building for those people.
Setting to false means EssentialsAntiBuild will never prevent you from building.


Should people with build: false in permissions be allowed to use items?
Set true to disable using for those people.
Setting to false means EssentialsAntiBuild will never prevent you from using items.


Should we tell people they are not allowed to build?

For which block types would you like to be alerted?
You can find a list of IDs in plugins/Essentials/items.csv after loading Essentials for the first time.
10 = lava :: 11 = still lava :: 46 = TNT :: 327 = lava bucket)


Essentials Spawn

Should we announce to the server when someone logs in for the first time?
If so, use this format, replacing {DISPLAYNAME} with the player name.
Clear the input below if you don't want a welcome message.

When we spawn for the first time, which spawnpoint do we use?
Set to "none" if you want to use the spawn point of the world.

Do we want to give users anything on first join? Set to '' to disable
This kit will be given regardless of cost and permissions, and will not trigger the kit delay.

Set this to lowest, if you want Multiverse to handle the respawning.
Set this to high, if you want EssentialsSpawn to handle the respawning.
Set this to highest, if you want to force EssentialsSpawn to handle the respawning.


When users die, should they respawn at their first home or bed, instead of the spawnpoint?


Teleport all joining players to the spawnpoint.