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.

Commands in general

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.

/light set < attribute > < target > <attribute_value>

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.

/light get < attribute > < target >

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.

/light reroll < target > < attribute >

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

/light activate < target > [ delay ]

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.

/light ready < target > [ delay ]

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.

/light reset < target > [ confirm ]

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.

/light charge < add|remove|get|fill|empty > < target > [amount]

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.