Configuration

All server-wide settings live in plugins/HoeWars/config.yml. Edit it with the server stopped, or edit it live and run /hoe reload to apply changes. This page covers each section.

Color codes use the legacy ampersand style, for example &6 for gold. This applies in the config, messages, and scoreboard files.

Storage

Chooses where player data is saved.

storage:
  type: SQLITE

Set type to SQLITE (a local file, no setup) or MYSQL (a shared database for networks). The full MySQL connection and pool settings live in this section. See Storage and Data for details.

Lobby

Where players go after a match. Easiest set with the /hoe setlobby command while standing in place, which writes these values for you.

lobby:
  world: "world"
  x: 0.0
  y: 64.0
  z: 0.0

Arena clone

Controls where match copies are pasted and how fast.

arena-clone:
  world: "world"
  base-x: 10000
  base-y: 64
  base-z: 10000
  spacing: 200
  blocks-per-tick: 800
  use-fawe-if-present: true

Key	What it controls
`world`	The world clones are pasted into
`base-x`, `base-y`, `base-z`	Where the first clone starts
`spacing`	Distance between simultaneous clones
`blocks-per-tick`	How many blocks the built-in paster places per tick (lower it if you see lag)
`use-fawe-if-present`	Use FastAsyncWorldEdit for the paste when it is installed

See Arenas for the bigger picture.

Match

Player counts, length, and start thresholds per mode.

match:
  ranked:
    players: 10
    duration: 240
    countdown: 10
    min-players-to-start: 6

Key	What it controls
`players`	Maximum players in a match
`duration`	Match length in seconds
`countdown`	Countdown length in seconds before a match starts
`min-players-to-start`	Players needed before the countdown begins

Repeat for unranked and deathmatch. See Game Modes.

Territory

The claiming rules.

territory:
  tool-type: HOE
  neutral-block: WHITE_CONCRETE
  claim-block-type: CONCRETE
  allow-stealing: false
  steal-requires-double-click: false
  steal-cooldown-ticks: 10
  claim-cooldown-ticks: 2

Key	What it controls
`tool-type`	The tool players claim with (`HOE` or `SHOVEL`)
`neutral-block`	The block an unclaimed floor tile shows as
`claim-block-type`	The block a claimed tile becomes (an arena can override this; see Arenas)
`allow-stealing`	Whether players can claim tiles already owned by others
`steal-requires-double-click`	Require a double click to steal, when stealing is on
`steal-cooldown-ticks`	Minimum ticks between steals
`claim-cooldown-ticks`	Minimum ticks between claims

Ranks

The rank ladder. Each tier sets a win requirement, a tool tier, and a display name. See Ranks and ELO for the default table.

ELO

elo:
  enabled: true
  k-factor: 32
  starting: 1000

Turn ELO on or off, and set the base rating and the K-factor (how much a single match can move a rating).

Visuals

visuals:
  colored-armor: true
  claim-particle: HAPPY_VILLAGER
  claim-sound: BLOCK_NOTE_BLOCK_PLING
  player-glow: true
  arena-border-particles: true
  winner-fireworks: true

Toggle armor coloring, the particle and sound played on each claim, player glow, the arena border particles, and the winner fireworks.

Queue and leaderboard

queue:
  max-wait-time: 120
leaderboard:
  cache-refresh-seconds: 45

max-wait-time is the longest a player waits in queue before the plugin acts. cache-refresh-seconds is how often leaderboards refresh. See Stats and Leaderboards.

Applying changes

After editing, run:

/hoe reload

This reloads the config, ranks, and arenas without a restart.

On this page