Effect commands

Configured in effect-commands.yml.

/speed, /strength, /fireresistance… — rank perks, as on most kitmaps. Each command gives its effect until the player dies; typing it again takes it off.

effect-commands.yml

# Shipped at what a Bard gives by holding an item (classes.yml, held-effects),
# without its burst - and Haste II and Night Vision, the Miner's.
#
#   <command>:
#     effect: the effect (speed, strength, jump_boost, fire_resistance...)
#     level: 1 is level I
#     aliases: other names it answers to
#     permission: optional; hcfcore.effect.<command> by default
#
# Or several effects at once, each with its level, in place of effect and level:
#
#     effects: {speed: 2, fire_resistance: 1}
#
# Typed again, such a command takes them all off when the player has every one
# of them from these commands; otherwise it gives them.
commands:
  speed:
    effect: speed
    level: 2
    aliases: [sp]
  strength:
    effect: strength
    level: 1
    aliases: [str]
  resistance:
    effect: resistance
    level: 1
    aliases: [res]
  regeneration:
    effect: regeneration
    level: 1
    aliases: [regen]
  jumpboost:
    effect: jump_boost
    level: 2
    aliases: [jb]
  fireresistance:
    effect: fire_resistance
    level: 1
    aliases: [fres, fr]
  invisibility:
    effect: invisibility
    level: 1
    aliases: [invis, invi]
  haste:
    effect: haste
    level: 2
    aliases: [hst]
  nightvision:
    effect: night_vision
    level: 1
    aliases: [nv]
  # Every effect a fight uses, at once.
  alleffect:
    effects:
      speed: 2
      fire_resistance: 1
      invisibility: 1
      haste: 2
      night_vision: 1
    aliases: [alleffects, effects]

Shipped at what a Bard gives by holding an item, without its burst — and the Miner's Haste II and Night Vision:

Command	Aliases	Effect
/speed	/sp	Speed II
/strength	/str	Strength I
/resistance	/res	Resistance I
/regeneration	/regen	Regeneration I
/jumpboost	/jb	Jump Boost II
/fireresistance	/fres, /fr	Fire Resistance I
/invisibility	/invis, /invi	Invisibility I
/haste	/hst	Haste II
/nightvision	/nv	Night Vision I
/alleffect	/alleffects, /effects	Speed II, Fire Resistance I, Invisibility I, Haste II and Night Vision I at once

/alleffect gives every one of them in a single command; typed again, it takes them all off (when the player has them all from these commands — otherwise it gives the missing ones).

Your own commands

Every command is a block: its name, the effect, its level (1 is level I) — or effects, several at once, each with its level —, aliases, and optionally a permission. Add, remove or rename freely:

effect-commands.yml — your own

commands:
  speed:
    effect: speed
    level: 3
    aliases: [sp]
  glowing:
    effect: glowing
    level: 1
    aliases: [glow]
    permission: myserver.rank.vip
  fighter:
    effects: {speed: 2, strength: 1}   # several at once, each with its level
    aliases: [fight]

• Permission: hcfcore.effect.<command> unless the block names another — operators only by default. Give the node to the ranks that should have the command; a player without it does not see the command at all.
• /hcf reload applies a new effect, level or permission. Adding, removing or renaming a command or an alias needs a restart: the server builds its list of commands once.
• An alias never takes over another plugin's command — if an essentials plugin already has /fr, it keeps it, and the console says so at startup. The command's own name does take over: /speed is this plugin's, even with an essentials plugin that has one.

How the effect behaves

• Until death, then gone like every effect. It survives logging out.
• Typing the command again takes it off — only the effect the command gave: a potion or a Bard's effect is never taken.
• A stronger effect wins while it lasts: with /speed on, a Bard's Speed III burst takes over for its seconds, then Speed II comes back.
• The effect caps hold (effects.caps of limiters.yml): capped at Speed II, a /speed configured at level III gives Speed II; an effect capped at 0 is refused.
• The potion caps do not apply: the command is not a potion. With strength: 0 under potions.caps — Strength from the Bard only — /strength still gives Strength to whoever holds its permission. Remove the block, or give its permission to nobody, to keep Strength to the Bard.