Skip to content

Commands

JvstvsHD edited this page Aug 21, 2024 · 2 revisions

Commands

All commands are registered with the prefix /necrify. Moreover, it is possible to register top-level commands too by setting allow-top-level-commands to true (which is per default)

Arguments

  • \<arg\> describes an argument or literal that is required for the execution of this command
  • [arg] describes an argument or literal that is not required for the execution of this command. If this argument is not provided, a default value will be used.
  • \<user\> describes a required argument that must be supplied by either the name or UUID (refer to the UUID section) of the user that should be targetted by the execution of this command
  • [reason] describes an optional argument that can be supplied with a reason. This value supports using MiniMessage syntax for styling such as colouring and decoration.
  • \<duration\> describes a required argument that must be supplied with a duration

UUID

A UUID (Universally Unique Identifier) is a 128-bit value that is used to uniquely distinguish players. Necrify is able to parse UUIDs in the following format: a55750bc-bc6d-48e2-ac45-9b3d635229e0 (with dashes) or a55750bcbc6d48e2ac459b3d635229e0 (without dashes), whereas parsing is case-insensitive. Mojang uses Version 4, Variant 1 UUIDs for Minecraft accounts.

See Wikipedia and the Minecraft Wikipedia for more information.

Durations

To be parsed by PunishmentDuration#parse(String), a string must follow the following scheme: an integer greater than 0 followed by a char determining the time unit of this value. This can be repeated without spaces inbetween.

The following time units are supported by default:

  • s - second(s)
  • m - minute(s)
  • h - hour(s)
  • d - day(s)

Example: 1d12h15m30s means a duration of 1 day, 12 hours, 15 minutes and 30 seconds.

Command usage

All commands are registered as a child to /necrify in all cases. Moreover, some commands (all besides user and punishment) will be registered on top-level, meaning /necrify ban is equivalent to /ban. This behaviour is enabled by default but can be disabled by setting allow-top-level-commands to false in the config.yml and restarting the server.

Banning and muting:

  • /necrify ban <user> [reason] bans a player permanently for the given or the default reason so they are denied from joining the server.
    Example: /necrify ban *user* <red>You have been banned permanently from this network. bans user forever from your server.
  • /necrify mute <user> [reason] mutes a player permanently for the given or the default reason so they are not able to write any messages.
    Example: /necrify mute *user* <red>You have been muted permanently on this network. denies user from ever writing messages on your server again.
  • /necrify tempban [reason] bans a player for the given duration for the given or the default reason so they are denied from joining the server.
    Example: /necrify tempbanban 1d1h *user* <red>You have been banned for 25h from this network. bans user for 25 hours from your server.
  • /necrify tempmute [reason] mutes a player for the given duration for the given or the default reason so they are not able to write any messages.
    Example: /necrify mute *user* <red>You have been muted for 25h on this network. denies user from writing messages on your server for the next 25 hours.

Removing punishments:

  • /necrify unban unbans the given player
  • /necrify unmute unmutes the given player in general:
  • /necrify punishment remove removes the specified punishment from this user.

Administrative and other

  • /necrify user <user> <info|delete|whitelist> shows either information about a player's punishments and his whitelist status, deletes this user including all punishments or inverts his whitelist status (from whitelisted to blacklisted or vice versa)
  • /necrify punishment <punishment id> <cancel|change|info|remove|chain> [other punishment's id] cancels/removes, changes or shows information about the given punishment(must be a uuid); lets this punishment be suceded by the other punishment
Clone this wiki locally