Skip to content

«⚙️» Configuration

Helpful Commands is very flexible in terms of configuration. Everything can be done directly in the game and there is no need to manually tinker with the config file.

🔰▪ Basics

helpfulcommands.config

or

helpfulcommands.config.*

All configuration is done with the /hc config command. If you don't have a config parameter, it means you don't have permissions to configure the mod.

What can you do and configure

  • Manage commands: toggle their active and public states
  • View a list of all configuration fields, query and update their values

Who can configure the mod

On dedicated server

  • Anyone with OP level of 4
  • Anyone who has permissions to do so, which can be set using any permissions management tool (e.g. LuckPerms)

On integrated server

For security reasons, only the host can configure the mod. Other players will get an error regardless of their OP level and permissions.

Config file location

If you need the config file, you can find it here: (world root directory)/config/(filename).json

filename:

  • Since 3.0.0: helpfulcommands3.json
  • Since 1.0.0: hcConfig.json

📃▪ Command management

helpfulcommands.config.manageCommand

Toggle command's active state

This command allows you to enable or disable commands:
/hc config manageCommand <command name> toggleEnabled [state]

  • If state parameter is empty, the command will be toggled (enabled -> disabled; disabled -> enabled)

Disabled commands can't be used by anyone, and they don't appear when you try to type them (no autocomplete)

Tip

You can toggle commands more easily in the Command List (/hc commandList): just click on the command name to toggle its active state. Each command in the list is also color-coded: green - enabled, red - disabled. This doesn't apply to server consoles.

Toggle command's public state

This command allows you to toggle the public state of the command:
/hc config manageCommand <command name> togglePublic [state]

  • If state parameter is empty, the public state will be toggled (public -> restricted; restricted -> public)

Tip

You can toggle the public state more easily in the Command List (/hc commandList): just click on the special letter to the left of the command name. Public commands will be highlighted in the list. This doesn't apply to server consoles.

🔧▪ Config field management

helpfulcommands.config.manageField

Query current value

Use this command to see the current value of the config field:
/hc config manageField <field name> query

Update value

Use this command to set the new value of the field:
/hc config manageField <field name> set <new value>

Tip

You can see all available fields, their current values and descriptions in one place in the game by simply typing /hc config without any other parameters. You can also click on the current value to edit it.

List of fields

explosionPowerLimit

Default value: 15

Maximum power limit for /explosion command. Be careful: strong explosions are destructive and can cause lag.

jumpDistanceLimit

Default value: 0

Maximum distance for the /jump command. Players will not be able to teleport further than this value. If set to 0, there is no limit for the 'distance' argument, and the default formula will be used if the 'distance' argument is empty.