-
-
Notifications
You must be signed in to change notification settings - Fork 0
5: The commands
There are a handful of useful commands that you or a server admin can use to do various things, such as setting specific light type and target power etc, or rerolling for a new one.
They all start with either /light
or /lightwithin
and each commands needs a permission to be run, or if you prefer you can grant the lightwhithin.commands
permission to allow someone to use every commands. Otherwise they would need to be an Operator to use the commands.
All commands support tab-completion in game and are quite intuitive, so you could just play around with them in game in order to understand how they work.
In this guide I will use the /light alias.
Permission required: lightwithin.commands.set
With this command you can set a light attribute for a player to a specific value. You can change:
- The
type
of the light - The
target
of the light, but only if it's availabe for that light. (For example you can't set VARIANT to BLAZING) - The
power
of the light, limited between 1 and 10 - The
duration
of the light, minimum 1 - The
max_cooldown
of the light, limited between 1-120 - The
locked
status of the light. If set to true, the player won't be able to activate the light no matter what. - The
hasNaturallyTriggered
status of the light. If set to true, the player will be able to use LightCharges, if false they will first need to trigger their light in a natural way. After they have done that, they will be able to use LightCharges. - The
max_charges
of the light, limited between 0-9
The first argument is one of the values above, the second one it's the target of this change and can be a player or multiple ones. The third one is the value you want the new attribute to have.
Permission required: lightwithin.commands.get
With this command you can get information of a player's light attributes. The first argument can be:
-
all
which is going to give you information on all the attributes. It will also tell the unmodified/original values of each attribute. -
type
of the light -
target
of the light -
power
of the light -
duration
of the light -
cooldown
of the light -
locked
status of the light -
hasNaturallyTriggered
status of the light -
max_charges
of the light -
lights
gives you info about the currently usable lights. (Deprecated, will remove it probably)
The second argument is a player.
Permission required: lightwithin.commands.reroll
This command allows you to randomly change the target
's attributes, by generating a random uuid and calculating the new light attributes base on that. You can use:
-
all
to reroll everything, type, target etc. -
type
to reroll the light type (if the new type does not have the old target available a new one will be generated) -
target
to reroll the ligh target available for the current light type -
typeTarget
to reroll both the type and the target. -
power
to reroll the power of the light -
duration
to reroll the duration of the light -
cooldown
to reroll the cooldown of the light -
max_charges
to reroll max number of light charges
Permission required: lightwithin.commands.activate
This commands allows you to force-activate a light of a player, the target
, bypassing cooldown and other restrictions. Optionally, you can add a delay
in seconds after which the light will force activate.
Permission required: lightwithin.commands.ready
This commands allows you to force-ready a light of a player, the target
, bypassing cooldown and other restrictions. Optionally, you can add a delay
in seconds after which the light will force activate. This differs from the activate commands because the player still needs to press the button to activate the power.
Permission required: lightwithin.commands.reset
This commands will reset all of the light attributes of the target, by getting their uuid and re-calculating the attributes based on that. To prevent accidents, you will need to type the command again and confirm
at the end of the command.
This is useful if you mess around with the light set command or if the mod updates and adds a new light type and you want to see if the targets light ha changed.
Permission required: lightwithin.commands.charge
With this command you can set how many light charges a player has. You won't be able to add more charges than the player's max_light_charges attribute.