Integration: Citizens

Citizens is a all-purpose NPC service for your servers.

Trait: Spellcaster

This trait will allow you to :

1. Make an NPC cast a spell on demand (/spellcaster cast <spell_id>).
2. Add an automatic spell cast, with a cooldown and a condition.

The first point is trivial, so let's fous here on the second one.

Usage

If you have an NPC, and you want it to cast a spell. First, select it (/npc sel).

Command

/spellcaster add <spell_id> [cooldown] [condition]

1. The spell ID is mandatory and must be valid.
2. The cooldown is optional.

• The format is <amount><time_unit>. The allowed units are:
  • Hours : 'h',
  • Minutes : 'm',
  • Seconds : 's',
  • Ticks : 't'.
• Examples: 30s, 600t, 20m, ...

3. The condition must be a valid USS expression. The return value may be a boolean or a number (in which case all non-zeroes values will be considered as false).

How does it work ?

• Once the cooldown is over, the NPC will periodically try to check if its condition is valid (i.e. returns true). When it's the case, the corresponding spell will be cast, and the cooldown will be applied.

• A spellcaster may have an unlimited amount of spells to cast.

• All spell cooldowns are distincts.

• You can add quotes around the condition, to make it more readable.

Examples

1. Cast a fire-ball when a player is around

/spellcaster add fireball 30s "sizeof(all players within 6 around %caster) > 0"

1. Cast a heal when HP are below 12

/spellcaster add big_heal 2m "get_health(%caster)<=12"