1.x/Healer

Not Supported!
This page is about Citizens 1.x, while the current version is Citizens 2.0.2. This page's content may be outdated, and shouldn't be trusted as being correct. See this page's talk page for more information. If you were looking for the 2.0.2 equivalent of this page, try Healer. If you feel this message was displayed in error, please contact an administrator.

Healers can provide a health boost when you run out of food. You can heal yourself by right-clicking one with a take-health item (default is a diamond sword). Healers aren't immortal though, they will run out of health eventually. To give health back, right-click one with the give-health item (default is a wool block). Additionally, you can increase a healer's level and therefore increase its maximum health. A healer starts at Level 1 with a maximum of 10 health points. Health will regenerate 1 health point (this can be turned off in citizens.yml) at a calculated interval. For more on that, see the Health Regeneration section.

Configuration Nodes

These nodes can be found in citizens.yml.

Setting - path of the setting
Default Value - default value of the setting
Description - short description of the setting

Setting	Default Value	Description
economy.prices.healer.creation	100	Amount that is charged when an NPC is toggled to a healer for the first time
economy.prices.healer.levelup	100	Base price that is charged when a healer is leveled up, multiplied based on amount of levels you level-up a healer
economy.prices.healer.heal	100	Amount that is charged when you get healed by a healer
healers.give-health-item	35	ID of the item used to give health to a healer
healers.take-health-item	276	ID of the item used to take health from a healer (i.e. heal yourself)
healers.health-regen-increment	12000	Tick multiplier used in equation to determine delay between each health regeneration (1 server tick = 1/20 of a second)

Commands

[] - Mandatory
() - Optional

Command - command's syntax
Args Description - description of the command's arguments
Require Selected - whether the command requires an NPC to be selected
Require Ownership - whether the commands requires you to be the owner of the NPC
Permission - command's permission node
Description - short description of the command

Command	Args Description	Require Selected	Require Ownership	Permission	Description
/healer help	None	false	false	citizens.healer.use.help	View the help page for healers
/healer status	None	true	true	citizens.healer.use.status	View the current level and health of a healer
/healer level-up (levels)	levels - amount of levels to level-up a healer	true	true	citizens.healer.modify.levelup	Level-up a healer the specified amount of levels

Health Regeneration

If a healer isn't at full health, their health will regenerate every X ticks based on their level. Here is the equation for calculating the regeneration delay:

regen ticks = (11 - level) * increment

level: Level of the healer
increment: Tick multiplier, can be changed in citizens.yml

This ensures that as a healer's level increases, the time it takes to regenerate health is decreased.

Other Permissions

Permission - permission node
Description - description of permission node

Permission	Description
citizens.healer.use.heal	Ability to interact with a healer (heal and give health)

Future

• Cooldowns between each heal

FAQ

Why isn't my healer healing when I left-click it? I am sure that I am using the correct heal-item.
In 1.1, healers were changed to heal when right-clicked.

Why isn't my healer healing when I right-click it?
Make sure that you are using the correct item. You can give health with a block of wool and take health with a diamond sword. Both of these are configurable in citizens.yml.