2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | Notes | #
# +------------------------------------------------------+ #
############################################################
# If you want to use special characters in this document, such as accented letters, you MUST save the file as UTF-8, not ANSI.
# If you receive an error when Essentials loads, ensure that:
# - No tabs are present: YAML only allows spaces
# - Indents are correct: YAML heirarchy is based entirely on indentation
# - You have "escaped" all apostrophes in your text: If you want to write "don't", for example, write "don''t" instead (note the doubled apostrphe)
# - List items are prefixed with a hyphen and indented:
# lists:
# - look like this
# not:
# - like this
# - Text with symbols is enclosed in single or double quotation marks
# - CraftBukkit and Permissions have been updated: CraftBukkit and Essentials almost always line up, but sometimes other plugins fall behind CraftBukkit's multiple daily updates
# - You have saved the document as UTF-8, NOT the default, ANSI
############################################################
# +------------------------------------------------------+ #
# | Essentials (Global) | #
# +------------------------------------------------------+ #
############################################################
# A color code between 0-9 or a-f. Set to 'none' to disable.
ops-name-color : 'c'
# The character(s) to prefix all nicknames, so that you know they are not true usernames.
nickname-prefix : '~'
2011-07-15 18:35:09 +00:00
# Disable this if you have any other plugin, that modifies the displayname of a user.
change-displayname : true
2011-07-22 23:43:02 +00:00
# Adds the prefix and suffix to the displayname of the player, so it will be displayed in messages and lists.
# The prefix/suffix can be set using Permissions, Group Manager or PermissionsEx.
# The value of change-displayname (above) has to be true.
2011-08-17 16:40:11 +00:00
# If you don't set this, it will default to true if essentials chat is installed.
# Don't forget to remove the # infront of the line
#add-prefix-suffix: false
2011-07-22 23:43:02 +00:00
2011-03-30 04:03:21 +00:00
# The delay, in seconds, required between /home, /tp, etc.
teleport-cooldown : 0
# The delay, in seconds, before a user actually teleports. If the user moves or gets attacked in this timeframe, the teleport never occurs.
teleport-delay : 0
# The delay, in seconds, required between /heal attempts
heal-cooldown : 60
2011-05-02 01:49:38 +00:00
# What to prevent from /i /give
# e.g item-spawn-blacklist: 46,11,10
item-spawn-blacklist :
# Set this to true if you want permission based item spawn rules
2011-07-06 09:59:16 +00:00
# Note: The blacklist above will be ignored then.
2011-05-02 01:49:38 +00:00
# Permissions:
# - essentials.itemspawn.item-all
# - essentials.itemspawn.item-[itemname]
# - essentials.itemspawn.item-[itemid]
# - essentials.give.item-all
# - essentials.give.item-[itemname]
# - essentials.give.item-[itemid]
permission-based-item-spawn : false
2011-03-30 04:03:21 +00:00
# Mob limit on spawnmob
spawnmob-limit : 10
2011-08-27 11:59:39 +00:00
# Shall we notify users when using /lightning
2011-04-29 08:48:29 +00:00
warn-on-smite : true
2011-11-18 03:18:03 +00:00
# motd and rules are now configured in the files motd.txt and rules.txt
2011-04-15 01:41:42 +00:00
# When a command conflicts with another plugin, by default, Essentials will try to force the OTHER plugin to take
# priority. If a command is in this list, Essentials will try to give ITSELF priority. This does not always work:
# usually whichever plugin was updated most recently wins out. However, the full name of the command will always work.
# For example, if WorldGuard and Essentials are both enabled, and WorldGuard takes control over /god, /essentials:god
# will still map to Essentials, whereas it might normally get forced upon WorldGuard. Commands prefixed with an "e",
# such as /egod, will always grant Essentials priority.
2011-05-13 13:16:47 +00:00
# We should try to take priority over /god. If this doesn't work, use
# /essentials:god or /egod. If god is set using WorldGuard, use /ungod to remove then use whichever you see fit.
2011-05-22 21:01:23 +00:00
overridden-commands :
- god
2011-03-30 04:03:21 +00:00
# Disabled commands will be completelly unavailable on the server.
disabled-commands :
# - nick
2011-07-16 02:05:43 +00:00
# Restricted commands have been removed.
# Now we have a whitelist, all commands not on this list are only available to ops.
2011-03-30 04:03:21 +00:00
# These will have NO EFFECT if you have Permissions installed!
2011-07-22 23:29:31 +00:00
# They are here only if you want something simpler than Permissions.
# These are the permissions without the "essentials." part.
2011-07-16 02:05:43 +00:00
player-commands :
- afk
- back
- back.ondeath
- balance
- clearinventory
- compass
2011-07-18 01:09:34 +00:00
- depth
- getpos
2011-07-22 23:29:31 +00:00
- geoip.show
2011-07-16 02:05:43 +00:00
- help
- helpop
- home
- home.others
- ignore
- info
2011-07-18 01:09:34 +00:00
- kit
2011-07-16 02:05:43 +00:00
- list
- mail
2011-07-18 01:09:34 +00:00
- mail.send
- me
2011-07-16 02:05:43 +00:00
- motd
- msg
- nick
- pay
2011-07-18 01:09:34 +00:00
- ping
2011-07-16 02:05:43 +00:00
- powertool
2011-07-22 23:29:31 +00:00
- protect
2011-07-16 02:05:43 +00:00
- r
- rules
- seen
- sell
- sethome
2011-07-18 01:09:34 +00:00
- setxmpp
2011-07-22 23:29:31 +00:00
- signs.create.protection
- signs.create.trade
- signs.break.protection
- signs.break.trade
- signs.use.balance
- signs.use.buy
- signs.use.disposal
- signs.use.free
- signs.use.heal
- signs.use.mail
- signs.use.protection
- signs.use.sell
- signs.use.time
- signs.use.trade
- signs.use.warp
- signs.use.weather
2011-07-18 01:09:34 +00:00
- spawn
2011-07-16 02:05:43 +00:00
- suicide
- tpa
- tpaccept
- tpahere
- tpdeny
2011-07-18 01:09:34 +00:00
- warp
2011-07-22 23:29:31 +00:00
- warp.list
2011-07-16 02:05:43 +00:00
- world
- worth
2011-07-18 01:09:34 +00:00
- xmpp
2011-03-30 04:03:21 +00:00
# Note: All items MUST be followed by a quantity!
# Times are measured in seconds.
kits :
tools :
delay : 10
items :
- 277 1
- 278 1
- 279 1
# Disable all signs
signs-disabled : false
# Backup runs a command while saving is disabled
backup :
# Interval in minutes
interval : 60
# Add a command that backups your data, e.g.
2011-08-27 11:59:39 +00:00
#command: 'rdiff-backup World1 backups/World1'
2011-03-30 04:03:21 +00:00
# Set this true to enable permission per warp.
per-warp-permission : false
# Sort output of /list command by groups
sort-list-by-groups : false
2011-04-16 23:18:00 +00:00
# More output to the console
debug : false
2011-04-03 14:25:10 +00:00
2011-05-09 02:47:19 +00:00
# Set the locale for all messages
# If you don't set this, the default locale of the server will be used.
2011-07-17 22:30:39 +00:00
# Don't forget to remove the # infront of the line
2011-05-09 02:47:19 +00:00
#locale: de_DE
2011-08-27 11:59:39 +00:00
# Turn off god mode when people exit
2011-07-07 20:43:44 +00:00
remove-god-on-disconnect : false
2011-07-17 22:30:39 +00:00
# Use the permission system of bukkit
# This only works if no other permission plugins are installed
use-bukkit-permissions : false
2011-08-27 11:59:39 +00:00
# Auto-AFK
# After this timeout in seconds, the user will be set as afk.
# Set to -1 for no timeout.
auto-afk : 300
# Auto-AFK Kick
# After this timeout in seconds, the user will be kicked from the server.
# Set to -1 for no timeout.
auto-afk-kick : -1
# Set this to true, if you want to freeze the player, if he is afk.
# Other players or monsters can't push him 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.
2011-08-27 13:30:56 +00:00
freeze-afk-players : false
2011-08-27 11:59:39 +00:00
2011-10-09 18:59:06 +00:00
# You can disable the death messages of minecraft here
death-messages : true
2011-11-25 06:12:21 +00:00
# Add worlds to this list, if you want to automatically disable god mode there
no-god-in-worlds :
# - world_nether
2011-12-03 17:13:42 +00:00
# Set to true to enable per-world permissions for teleporting with /world
# Give someone permission to teleport to a world with essentials.world.<worldname>
world-teleport-permissions : false
2011-11-28 18:55:51 +00:00
# Oversized stacks are stacks that ignore the normal max stacksize.
# They can be obtained using /give and /item, if the player has essentials.oversizedstacks permission.
# How many items should be in a oversized stack?
oversized-stacksize : 64
2011-12-02 07:30:52 +00:00
# Do you allow to repair enchanted weapons and armor?
# If you set this to false, you can still allow it for certain players using the permission
# essentials.repair.enchanted
repair-enchanted : true
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | EssentialsHome | #
# +------------------------------------------------------+ #
############################################################
2011-11-26 21:30:40 +00:00
# When users die, should they respawn at their first home, instead of the spawnpoint or bed?
2011-03-30 04:03:21 +00:00
respawn-at-home : false
2011-11-26 21:30:40 +00:00
# If no home is set send you to bed or spawn when /home is used
spawn-if-no-home : true
2011-03-30 04:03:21 +00:00
2011-11-30 01:51:02 +00:00
# Allows people to set their bed at daytime
update-bed-at-daytime : true
2011-10-01 09:08:58 +00:00
# Allow players to have multiple homes.
# Define different amounts of multiple homes for different permissions, e.g. essentials.sethome.multiple.vip
# People with essentials.sethome.multiple.unlimited are not limited by these numbers.
sethome-multiple :
# essentials.sethome.multiple
default : 3
# essentials.sethome.multiple.vip
vip : 5
# essentials.sethome.multiple.staff
staff : 10
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | EssentialsEco | #
# +------------------------------------------------------+ #
############################################################
# Defines the balance with which new players begin. Defaults to 0.
starting-balance : 0
# worth-# defines the value of an item when it is sold to the server via /sell.
2011-04-16 00:42:43 +00:00
# These are now defined in worth.yml
2011-03-30 04:03:21 +00:00
# Defines the cost to use the given commands PER USE
command-costs :
# /example costs $1000 PER USE
#example: 1000
# /kit tools costs $1500 PER USE
2011-05-13 16:57:45 +00:00
#kit-tools: 1500
2011-05-02 03:56:51 +00:00
2011-05-13 16:57:45 +00:00
# Set this to a currency symbol you want to use.
currency-symbol : '$'
2011-03-30 04:03:21 +00:00
2011-07-05 21:50:31 +00:00
# Set the maximum amount of money a player can have
# The amount is always limited to 10 trillions because of the limitations of a java double
max-money : 10000000000000
2011-07-06 01:13:03 +00:00
# Enable this to log all interactions with trade/buy/sell signs and sell command
economy-log-enabled : false
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | EssentialsHelp | #
# +------------------------------------------------------+ #
############################################################
2011-08-27 11:59:39 +00:00
# Show other plugins commands in help
2011-03-30 04:03:21 +00:00
non-ess-in-help : true
2011-08-27 11:59:39 +00:00
# Hide plugins which dont give a permission
# You can override a true value here for a single plugin by adding a permission to a user/group.
# The indervidual permission is: essentials.help.<plugin>, anyone with essentials.* or '*' will see all help this setting reguardless.
# You can use negitive permissions to remove access to just a single plugins help if the following is enabled.
2011-06-24 14:12:04 +00:00
hide-permissionless-help : true
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | EssentialsChat | #
# +------------------------------------------------------+ #
############################################################
chat :
2011-12-02 09:17:20 +00:00
# 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 (!)
# Or 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."
2011-03-30 04:03:21 +00:00
radius : 0
2011-12-02 09:17:20 +00:00
# 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.
2011-03-30 12:56:34 +00:00
# If set to the default chat format which "should" be compatible with ichat.
2011-12-02 09:17:20 +00:00
# For more information of chat formatting, check out the wiki: http://ess.khhq.net/wiki/Chat_Formatting
2011-03-30 12:56:34 +00:00
format : '<{DISPLAYNAME}> {MESSAGE}'
#format: '&7[{GROUP}]&f {DISPLAYNAME}&7:&f {MESSAGE}'
2011-12-02 09:17:20 +00:00
2011-03-30 04:03:21 +00:00
group-formats :
2011-03-30 12:56:34 +00:00
# Default: '{WORLDNAME} {DISPLAYNAME}&7:&f {MESSAGE}'
# Admins: '{WORLDNAME} &c[{GROUP}]&f {DISPLAYNAME}&7:&c {MESSAGE}'
2011-03-30 04:03:21 +00:00
2011-12-02 09:17:20 +00:00
# If your using group formats make sure to remove the '#' to allow the setting to be read.
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | EssentialsProtect | #
# +------------------------------------------------------+ #
############################################################
protect :
# Database settings for sign/rail protection
2011-12-01 00:35:48 +00:00
# mysql or sqlite
2011-03-30 04:03:21 +00:00
datatype : 'sqlite'
# If you specified MySQL above, you MUST enter the appropriate details here.
# If you specified SQLite above, these will be IGNORED.
username : 'root'
password : 'root'
mysqlDb : 'jdbc:mysql://localhost:3306/minecraft'
# For which block types would you like to be alerted?
2011-03-30 12:56:34 +00:00
# You can find a list of IDs in plugins/Essentials/items.csv after loading Essentials for the first time.
2011-03-30 04:03:21 +00:00
alert :
# 10: lava
# 11: still lava
# 46: TNT
on-placement : 10 , 11 , 46
2011-04-03 18:16:23 +00:00
on-use :
2011-03-30 04:03:21 +00:00
# 46: TNT
2011-07-17 23:05:42 +00:00
on-break :
2011-03-30 04:03:21 +00:00
# Users cannot PLACE these types of blocks/items.
# < 255 designates a BLOCK
# > 255 designates an ITEM (Some blocks can be placed as blocks OR items; lava blocks can be placed by lava buckets, for example.)
blacklist :
placement : 327 , 326 , 14 , 56 , 46 , 11 , 10 , 9 , 8
usage : 327 , 326 , 325
#prevent people from breaking blocks
#break: 20,50
break :
2011-07-17 23:05:42 +00:00
# Which blocks should not be pushed by pistons
piston :
2011-03-30 04:03:21 +00:00
# General physics/behavior modifications
prevent :
lava-flow : false
water-flow : false
water-bucket-flow : false
2011-05-13 17:15:45 +00:00
fire-spread : true
lava-fire-spread : true
2011-03-30 04:03:21 +00:00
flint-fire : false
2011-05-13 17:15:45 +00:00
lightning-fire-spread : true
2011-04-11 10:49:45 +00:00
portal-creation : false
2011-03-30 04:03:21 +00:00
tnt-explosion : false
2011-07-18 05:22:28 +00:00
tnt-playerdamage : false
2011-07-05 23:24:54 +00:00
fireball-explosion : false
2011-07-18 05:22:28 +00:00
fireball-fire : false
fireball-playerdamage : false
2011-03-30 04:03:21 +00:00
creeper-explosion : false
creeper-playerdamage : false
creeper-blockdamage : false
2011-09-21 00:30:58 +00:00
enderman-pickup : false
2011-11-28 05:15:51 +00:00
villager-death : false
2011-04-07 20:32:00 +00:00
# Monsters won't follow players
# permission essentials.protect.entitytarget.bypass disables this
2011-04-07 20:44:06 +00:00
entitytarget : false
2011-03-30 04:03:21 +00:00
# Prevent the spawning of creatures
spawn :
2011-04-11 00:10:18 +00:00
chicken : false
cow : false
2011-03-30 04:03:21 +00:00
creeper : false
2011-11-21 02:21:02 +00:00
ghast : false
2011-04-11 00:10:18 +00:00
giant : false
monster : false
pig : false
pig_zombie : false
sheep : false
skeleton : false
2011-11-21 02:21:02 +00:00
slime : false
2011-04-11 00:10:18 +00:00
spider : false
squid : false
zombie : false
wolf : false
2011-09-22 14:08:55 +00:00
cave_spider : false
enderman : false
silverfish : false
2011-11-21 02:21:02 +00:00
ender_dragon : false
villager : false
blaze : false
mushroom_cow : false
2011-11-28 12:55:54 +00:00
magma_cube : false
snowman : false
2011-03-30 04:03:21 +00:00
# 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.
creeper :
max-height : -1
# Protect various blocks.
protect :
# Protect all signs
signs : true
# Prevent users from destroying rails
rails : true
# Blocks below rails/signs are also protected if the respective rail/sign is protected.
# This makes it more difficult to circumvent protection, and should be enabled.
# This only has an effect if "rails" or "signs" is also enabled.
block-below : true
2011-08-27 11:59:39 +00:00
# Prevent placing blocks above protected rails, this is to stop a potential griefing
2011-03-30 04:03:21 +00:00
prevent-block-on-rails : false
2011-06-02 23:09:59 +00:00
2011-08-27 11:59:39 +00:00
# Store blocks / signs in memory before writing
2011-06-02 23:09:59 +00:00
memstore : false
2011-03-30 04:03:21 +00:00
# Disable various default physics and behaviors
disable :
# Should fall damage be disabled?
fall : false
# Users with the essentials.protect.pvp permission will still be able to attack each other if this is set to true.
# They will be unable to attack users without that same permission node.
pvp : false
# Should drowning damage be disabled?
# (Split into two behaviors; generally, you want both set to the same value)
drown : false
suffocate : false
# Should damage via lava be disabled? Items that fall into lava will still burn to a crisp. ;)
lavadmg : false
2011-03-30 13:34:15 +00:00
# Should arrow damage be disabled
2011-03-30 04:03:21 +00:00
projectiles : false
# This will disable damage from touching cacti.
contactdmg : false
# Burn, baby, burn! Should fire damage be disabled?
firedmg : false
2011-04-21 16:58:02 +00:00
# Should the damage after hit by a lightning be disabled?
lightning : false
2011-03-30 04:03:21 +00:00
# Should people with build: false in permissions be allowed to build
# Set true to disable building for those people
2011-04-03 18:16:23 +00:00
build : true
2011-07-18 00:30:05 +00:00
# Should people with build: false in permissions be allowed to use items
# Set true to disable useing for those people
use : true
2011-03-30 04:03:21 +00:00
2011-08-27 11:59:39 +00:00
# Should we tell people they are not allowed to build
2011-10-01 04:02:32 +00:00
warn-on-build-disallow : true
2011-04-14 21:14:16 +00:00
2011-03-30 04:03:21 +00:00
2011-08-27 11:59:39 +00:00
# Disable weather options
2011-04-27 01:33:45 +00:00
weather :
storm : false
thunder : false
lightning : false
2011-03-30 04:03:21 +00:00
############################################################
# +------------------------------------------------------+ #
# | New Players | #
# +------------------------------------------------------+ #
############################################################
newbies :
# 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.
# If not, set to ''
#announce-format: ''
announce-format : '&dWelcome {DISPLAYNAME} to the server!'
# When we spawn for the first time, which spawnpoint do we use?
2011-08-11 11:31:57 +00:00
# Set to "none" if you want to use the spawn point of the world.
2011-03-30 04:03:21 +00:00
spawnpoint : newbies
2011-03-30 12:56:34 +00:00
# End of File <-- No seriously, you're done with configuration.