Essentials [ NE CHERCHE PAS DE REPONSE]

#############

±-----------------------------------------------------+

| 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 hierarchy 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 apostrophe)

- Text with symbols is enclosed in single or double quotation marks

If you have problems join the Essentials help support channel: http://tiny.cc/EssentialsChat

############################################################

±-----------------------------------------------------+

| Essentials (Global) |

±-----------------------------------------------------+

############################################################

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

ops-name-color: ‘a’

The character(s) to prefix all nicknames, so that you know they are not true usernames.

nickname-prefix: ‘’

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

max-nick-length: 1

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

change-displayname: true

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.

#change-playerlist: 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!

#add-prefix-suffix: false

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.

teleport-safety: true

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, 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.

teleport-invulnerability: 4

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

heal-cooldown: 60

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.

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

permission-based-item-spawn: false

Mob limit on the /spawnmob command per execution.

spawnmob-limit: 10

Shall we notify users when using /lightning?

warn-on-smite: true

motd and rules are now configured in the files motd.txt and rules.txt.

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/Bukkit.yml#aliases for more information

overridden-commands:

- god

- info

Disabling commands here will prevent Essentials handling the command, this will not affect command conflicts.

Commands should fallback to the vanilla versions if available.

You should not have to disable commands used in other plugins, they will automatically get priority.

disabled-commands:

- nick

- clear

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.

socialspy-commands:

  • msg
  • w
  • r
  • mail
  • m
  • t
  • whisper
  • emsg
  • tell
  • er
  • reply
  • ereply
  • email
  • action
  • describe
  • eme
  • eaction
  • edescribe
  • etell
  • ewhisper
  • pm

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.

player-commands:

  • afk
  • afk.auto
  • back
  • back.ondeath
  • balance
  • balance.others
  • balancetop
  • build
  • chat.color
  • chat.format
  • chat.shout
  • chat.question
  • clearinventory
  • compass
  • depth
  • delhome
  • getpos
  • geoip.show
  • help
  • helpop
  • home
  • home.others
  • ignore
  • info
  • itemdb
  • kit
  • kits.tools
  • list
  • mail
  • mail.send
  • me
  • motd
  • msg
  • msg.color
  • nick
  • near
  • pay
  • ping
  • protect
  • r
  • rules
  • realname
  • seen
  • sell
  • sethome
  • setxmpp
  • signs.create.protection
  • signs.create.trade
  • signs.break.protection
  • signs.break.trade
  • signs.use.balance
  • signs.use.buy
  • signs.use.disposal
  • signs.use.enchant
  • signs.use.free
  • signs.use.gamemode
  • signs.use.heal
  • signs.use.info
  • signs.use.kit
  • signs.use.mail
  • signs.use.protection
  • signs.use.repair
  • signs.use.sell
  • signs.use.time
  • signs.use.trade
  • signs.use.warp
  • signs.use.weather
  • spawn
  • suicide
  • time
  • tpa
  • tpaccept
  • tpahere
  • tpdeny
  • warp
  • warp.list
  • world
  • worth
  • xmpp

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.

For more information, visit http://wiki.ess3.net/wiki/Kits

kits:
Randonneur:
delay: 1000
items:
- 298 1
- 299 1
- 300 1
- 301 1
- 267 1
- 420 5
- 297 15
- 17 10
Voyageur:
delay: 1000
items:
- 306 1
- 307 1
- 308 1
- 309 1
- 267 1 Sharpness:1
- 420 10
- 364 15
- 368 2
- 395 1
Aventurier:
delay: 1000
items:
- 306 1 Protection:2
- 307 1 Protection:2
- 308 1 Protection:2
- 309 1 Protection:2
- 267 1 Sharpness:2
- 364 15
- 46 16
- 54 2
- 260 1
Explorateur:
delay: 1000
items:
- 306 1 Protection:3
- 311 1
- 308 1 Protection:3
- 313 1
- 276 1 name:&a&lPIKACHUUUUUUUUU
- 261 1 Power:1
- 262 32
- 364 15
Légende:
delay: 1000
items:
- 310 1 Protection:1
- 311 1 Protection:1
- 312 1 Protection:1
- 313 1 Protection:1
- 276 1 Sharpness:2 name:&5&lLATEAMROCKETSENSVASBLABLABLA
- 120 12
- 381 12
- 384 64
- 364 15
- 354 1 name:&5&lTY_FOR_YOUR_MONEY;)

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.

enabledSigns:
#- color
#- balance
#- buy
#- sell
#- trade
#- free
#- disposal
#- warp
#- kit
#- mail
#- enchant
#- gamemode
#- heal
#- info
#- spawnmob
#- repair
#- time
#- weather

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.

sign-use-per-second: 4

Backup runs a batch/bash command while saving is disabled.

backup:

Interval in minutes.

interval: 30

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.

#command: ‘rdiff-backup World1 backups/World1’

Set this true to enable permission per warp.

per-warp-permission: false

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

list:
# To merge groups, list the groups you wish to merge
#Staff: owner admin moderator
Admins: owner admin
# To limit groups, set a max user limit
#builder: 20
# To hide groups, set the group as hidden
#default: hidden
# Uncomment the line below to simply list all players with no grouping
#Players: ‘*’

More output to the console.

debug: false

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”.

Don’t forget to remove the # in front of the line.

For more information, visit http://wiki.ess3.net/wiki/Locale

#locale: en

Turn off god mode when people exit.

remove-god-on-disconnect: false

Auto-AFK

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.

auto-afk: 300

Auto-AFK Kick

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.

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.

freeze-afk-players: false

When the player is afk, should he be able to pickup items?

Enable this, when you don’t want people idling in mob traps.

disable-item-pickup-while-afk: false

This setting controls if a player is marked as active on interaction.

When this setting is false, you will need to manually un-AFK using the /afk command.

cancel-afk-on-interact: true

Should we automatically remove afk status when the player moves?

Player will be removed from AFK on chat/command regardless of this setting.

Disable this to reduce server lag.

cancel-afk-on-move: true

You can disable the death messages of Minecraft here.

death-messages: false

Should operators be able to join and part silently.

You can control this with permissions if it is enabled.

allow-silent-join-quit: false

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.

custom-join-message: “none”

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.

custom-quit-message: “none”

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

no-god-in-worlds:

- world_nether

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.

This does not affect the /home command, there is a separate toggle below for this.

world-teleport-permissions: false

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.

default-stack-size: -1

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?

oversized-stacksize: 64

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

repair-enchanted: true

Allow ‘unsafe’ enchantments in kits and item spawning.

Warning: Mixing and overleveling some enchantments can cause issues with clients, servers and plugins.

unsafe-enchantments: false

#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.
register-back-in-listener: false

#Delay to wait before people can cause attack damage after logging in.
login-attack-delay: 5

#Set the max fly speed, values range from 0.1 to 1.0
max-fly-speed: 0.8

#Set the max walk speed, values range from 0.1 to 1.0
max-walk-speed: 0.8

#Set the maximum amount of mail that can be sent within a minute.
mails-per-minute: 1000

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.

max-tempban-time: -1

############################################################

±-----------------------------------------------------+

| EssentialsHome |

±-----------------------------------------------------+

############################################################

Allows people to set their bed at daytime.

update-bed-at-daytime: true

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.

world-home-permissions: false

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.

For more information, visit http://wiki.ess3.net/wiki/Multihome

sethome-multiple:
default: 3
vip: 5
staff: 10

In this example someone with ‘essentials.sethome.multiple’ and ‘essentials.sethome.multiple.vip’ will have 5 homes.

Set timeout in seconds for players to accept tpa before request is cancelled.

Set to 0 for no timeout.

tpa-accept-cancellation: 120

############################################################

±-----------------------------------------------------+

| EssentialsEco |

±-----------------------------------------------------+

############################################################

For more information, visit http://wiki.ess3.net/wiki/Essentials_Economy

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.

These are now defined in worth.yml

Defines the cost to use the given commands PER USE.

Some commands like /repair have sub-costs, check the wiki for more information.

command-costs:

/example costs $1000 PER USE

#example: 1000

/kit tools costs $1500 PER USE

#kit-tools: 1500

Set this to a currency symbol you want to use.

currency-symbol: ‘$’

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.

max-money: 10000000000000

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.

min-money: -10000

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

economy-log-enabled: false

############################################################

±-----------------------------------------------------+

| EssentialsHelp |

±-----------------------------------------------------+

############################################################

Show other plugins commands in help.

non-ess-in-help: true

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., 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.

hide-permissionless-help: true

############################################################

±-----------------------------------------------------+

| EssentialsChat |

±-----------------------------------------------------+

############################################################

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."

radius: 0

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.

If set to the default chat format which “should” be compatible with ichat.

For more information of chat formatting, check out the wiki: http://wiki.ess3.net/wiki/Chat_Formatting

format: ‘{DISPLAYNAME} : {MESSAGE}’
#format: ‘&7[{GROUP}]&r {DISPLAYNAME}&7:&r {MESSAGE}’

group-formats:

Default: ‘{WORLDNAME} {DISPLAYNAME}&7:&r {MESSAGE}’

Admins: ‘{WORLDNAME} &c[{GROUP}]&r {DISPLAYNAME}&7:&c {MESSAGE}’

If you are using group formats make sure to remove the ‘#’ to allow the setting to be read.

############################################################

±-----------------------------------------------------+

| EssentialsProtect |

±-----------------------------------------------------+

############################################################

protect:

General physics/behavior modifications.

prevent:
lava-flow: false
water-flow: false
water-bucket-flow: false
fire-spread: true
lava-fire-spread: true
flint-fire: false
lightning-fire-spread: true
portal-creation: false
tnt-explosion: false
tnt-playerdamage: false
tnt-minecart-explosion: false
tnt-minecart-playerdamage: false
fireball-explosion: false
fireball-fire: false
fireball-playerdamage: false
witherskull-explosion: false
witherskull-playerdamage: false
wither-spawnexplosion: false
wither-blockreplace: false
creeper-explosion: false
creeper-playerdamage: false
creeper-blockdamage: false
enderdragon-blockdamage: true
enderman-pickup: false
villager-death: false
# Monsters won’t follow players.
# permission essentials.protect.entitytarget.bypass disables this.
entitytarget: false
# Prevent the spawning of creatures.
spawn:
creeper: true
skeleton: true
spider: true
giant: true
zombie: true
slime: true
ghast: true
pig_zombie: true
enderman: true
cave_spider: true
silverfish: true
blaze: true
magma_cube: true
ender_dragon: true
pig: true
sheep: true
cow: true
chicken: true
squid: true
wolf: true
mushroom_cow: true
snowman: true
ocelot: true
iron_golem: true
villager: true
wither: true
bat: true
witch: true
horse: true

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

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

# Should arrow damage be disabled?
projectiles: false

# This will disable damage from touching cacti.
contactdmg: false

# Burn, baby, burn!  Should fire damage be disabled?
firedmg: false

# Should the damage after hit by a lightning be disabled?
lightning: false

# Should Wither damage be disabled?
wither: false

# Disable weather options?
weather:
  storm: false
  thunder: false
  lightning: false

############################################################

±-----------------------------------------------------+

| EssentialsAntiBuild |

±-----------------------------------------------------+

############################################################

Disable various default physics and behaviors

For more information, visit http://wiki.ess3.net/wiki/AntiBuild

# 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.
build: true

# 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.
use: true

# Should we tell people they are not allowed to build?
warn-on-build-disallow: true

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

alert:
on-placement: 10,11,46,327
on-use: 327
on-break:

blacklist:

# Which blocks should people be prevented from placing?
placement: 10,11,46,327

# Which items should people be prevented from using?
usage: 327

# Which blocks should people be prevented from breaking?
break:

# Which blocks should not be pushed by pistons?
piston:

# Which blocks should not be dispensed by dispensers
dispenser:

############################################################

±-----------------------------------------------------+

| Essentials Spawn / New Players |

±-----------------------------------------------------+

############################################################

newbies:
announce-format: ‘&a&lBienvenue OP {DISPLAYNAME}&a&l sur le serveur Phoenixia en Construction!’
spawnpoint: newbies
kit: Randonneur

respawn-listener-priority: high
respawn-at-home: false