The main configuration file lives at plugins/SSoggyPvP-Manager/config.yml.

Overview

The config controls:

• Default PvP behavior for new players
• Player-facing messages
• Playtime debt timing
• Zone wand material
• Zone exit message cooldowns
• Save interval and debug logging

Core Settings

default-pvp-state: false

playtime:
  minutes-per-cycle: 60
  hours-per-cycle: 1
  forced-seconds: 1200
  forced-minutes: 20
  solo-accumulate: true
  solo-forced: false

zone-wand-material: BLAZE_ROD

zone-exit-cooldowns:
  chat: 3
  actionbar: 0

save-interval: 5
debug: false

Default PvP State

default-pvp-state: false

Controls whether new players begin with PvP enabled or disabled.

• true: new players start with PvP on
• false: new players start with PvP off

Messages

All player-facing strings live under messages: and support standard Bukkit color codes.

Example keys:

messages:
  pvp-enabled: "&a&lPvP enabled!"
  pvp-disabled: "&c&lPvP disabled."
  pvp-forced-zone: "&4&lForced PvP zone!"
  pvp-forced-playtime: "&4&lForced PvP active! &f%time% &cremaining."

Useful format codes:

• &a green
• &c red
• &e yellow
• &7 gray
• &l bold

Playtime Settings

playtime:
  minutes-per-cycle: 60
  hours-per-cycle: 1
  forced-seconds: 1200
  forced-minutes: 20
  solo-accumulate: true
  solo-forced: false

• minutes-per-cycle: how many minutes of accumulated playtime triggers a forced PvP cycle (overrides hours-per-cycle)
• hours-per-cycle: legacy support; how many hours of playtime triggers a forced PvP cycle
• forced-seconds: how many seconds forced PvP lasts for each processed cycle (overrides forced-minutes)
• forced-minutes: legacy support; how many minutes forced PvP lasts for each processed cycle
• solo-accumulate: whether playtime accumulates when a player is online alone
• solo-forced: whether forced PvP debt counts down when a player is online alone

See Playtime System for behavior details.

Zone Tooling

zone-wand-material: BLAZE_ROD

Any valid Bukkit material can be used as the zone selector wand.

Zone Exit Cooldowns

zone-exit-cooldowns:
  chat: 3
  actionbar: 0

These values control how often players can receive leave-zone notifications.

• chat: cooldown in seconds for chat messages
• actionbar: cooldown in seconds for action bar messages
• 0: no cooldown

Persistence and Debugging

save-interval: 5
debug: false

• save-interval: automatic save cadence in minutes
• debug: enables extra console logging for troubleshooting

Applying Changes

Most config changes can be applied with:

/pvpadmin reload