Skip to main content

Get 25% OFF on your first order with BisectHosting using code "DAQEM"!

Configuration

Necessities generates two configuration files in your config/necessities/ folder.

1. necessities.yml

This file controls the logic and behavior of the mod.

General

  • prefix: The text displayed before system messages (e.g., [Necessities]).
  • primaryColor: The hex color code for the prefix brackets and main text.
  • maxNickLength: The maximum character length for /nick.
  • allowColorsInNick: Whether players can use color codes (e.g., &6) in their nicknames.
  • godModeAllow: Globally enable/disable the /god command.
  • flyAllow: Globally enable/disable the /fly command.

Teleportation

Control cooldowns (how long you must wait between uses) and delays (how long you must stand still before teleporting).

SettingDescription
spawnTeleportDelay / spawnCooldownSettings for /spawn.
warpTeleportDelay / warpCooldownSettings for /warp.
homeTeleportDelay / homeCooldownSettings for /home.
tpaTeleportDelay / tpaCooldownSettings for /tpa.
backTeleportDelay / backCooldownSettings for /back.
rtpCooldown / rtpDelaySettings for /rtp.

RTP (Random Teleport)

  • minRadius: The minimum distance from spawn to teleport.
  • maxRadius: The maximum distance from spawn to teleport.

Homes

  • homesLimit: The default maximum number of homes a player can set. This can be overridden with permissions (see Homes System).

2. commands.yml

This file allows you to enable or disable specific commands and define custom aliases.

Example Structure:

gamemode:
# Whether the command is registered
enabled: true
# List of alternate commands that trigger this
aliases:
- "gm"

If you want to disable /tpa entirely or change /gmc to run /gamemode creative, you can do it here.