effect-commands.yml

Commands that give an effect until death: /speed, /strength and your own.

How it plays: read the guide

Every example on this page is taken from the shipped effect-commands.yml. /hcf reload applies a new effect, level or permission; adding, removing or renaming a command or an alias needs a restart.

Switch

effect-commands.yml

enabled: true

enabled: false at startup registers no command; switched off by /hcf reload, the commands answer that they are switched off until the next restart.

Commands

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]

Key	As shipped	What it does
commands.<name>	ten commands	The command, without its slash: letters, digits, _ and -
effect	—	The effect: speed, strength, jump_boost, fire_resistance… (another namespace is written in full, mypack:glow)
level	—	1 is level I, up to 255
effects	/alleffect only	Several effects at once, each to its level — {speed: 2, fire_resistance: 1} — in place of effect and level
aliases	one or two each	Other names; a name or alias belongs to the first command that claims it, and never takes over another plugin's command
permission	hcfcore.effect.<name>	Who may use it; operators by default

A command with no effect, a level out of range or a name already taken is left out, with a warning in the console.