1.x/Healer

From Citizens Wiki

< 1.x

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.