1.x/Healer

From Citizens Wiki

< 1.x

Revision as of 23:05, 14 February 2012 by AgentKid (talk | contribs) (NavBox)

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.