NexusCombat splits its settings across two files, both generated automatically on first launch. config.yml holds every setting and messages.yml holds every chat message, action bar and menu title. Player data is saved in nexuscombat.db when using SQLite, and kills waiting to be saved are kept in nexuscombat-outbox.db so nothing is lost if the database goes down.
Storage
| Setting | Default | Description |
|---|---|---|
| storage.type | sqlite | sqlite or mysql |
| storage.refresh-seconds | 5 | How often online players' data is refreshed from the database, minimum 2 |
| storage.mysql.url | jdbc:mysql://127.0.0.1:3306/nexuscombat | Database address |
| storage.mysql.username | nexuscombat | Database username |
| storage.mysql.password | "" | Database password |
Create the database before switching to MySQL. Every server sharing it must use the same player UUIDs, so all servers should be in online mode or behind the same proxy.
Combat Tagging
| Setting | Default | Description |
|---|---|---|
| combat.enabled | true | Tag players when they fight |
| combat.seconds | 20 | How long a tag lasts |
| combat.action-bar | true | Show the countdown on the action bar |
| combat.logout.punishment | KILL | NONE, KILL, COMMANDS or KILL_AND_COMMANDS |
| combat.logout.credit-opponent | true | Give the opponent the kill when a player combat logs |
| combat.logout.commands | [] | Console commands run when a player combat logs |
| combat.blocked-commands | 12 commands | Commands players can't use while tagged |
| combat.teleports.block | true | Stop tagged players from teleporting |
| combat.teleports.allowed-causes | [ENDER_PEARL] | Teleport types still allowed while tagged |
Logout commands support {player}, {uuid}, {opponent} and {opponent_uuid}. Blocked commands match the first word, so adding home also blocks /home base and /essentials:home.
Safe Zones and Barriers
| Setting | Default | Description |
|---|---|---|
| regions.enabled | true | Stop tagged players entering WorldGuard regions with pvp set to deny |
| regions.barriers.enabled | true | Show glowing walls at safe zone edges |
| regions.barriers.radius | 4 | How far around the player walls are shown, 1 to 8 blocks |
| regions.barriers.refresh-ticks | 8 | How often walls update, 2 to 40 ticks |
| regions.barriers.material | RED_STAINED_GLASS | Block the walls are made from |
| regions.barriers.glow-color | #ff4055 | Glow colour of the walls |
Safe zones need WorldGuard and WorldEdit. Any region with pvp set to deny counts as a safe zone, and only the tagged player can see their own walls.
Items and Potions
| Setting | Default | Description |
|---|---|---|
| item-blocker.enabled | true | Block items while tagged |
| item-blocker.materials | 5 items | Items that can't be used while tagged |
| potion-bans.enabled | true | Block potion effects while tagged |
| potion-bans.effects | [minecraft:strength, minecraft:regeneration] | Effects that can't be applied while tagged |
| item-cooldowns.enabled | true | Give items cooldowns |
| item-cooldowns.combat-only | false | Only start cooldowns when the item is used in combat |
| item-cooldowns.seconds | 5 items | Cooldown for each item, 1 to 86400 seconds, 0 disables it |
If an item is both blocked and on cooldown, the block takes priority while tagged. Banned potion effects are blocked from every source, so banning regeneration also stops golden apple regeneration and beacon effects while tagged.
Protection and PvP Toggle
| Setting | Default | Description |
|---|---|---|
| newbie-protection.enabled | true | Protect players from PvP on their first join |
| newbie-protection.seconds | 300 | How long protection lasts |
| newbie-protection.action-bar | true | Show remaining protection on the action bar |
| pvp-toggle.enabled | true | Let players turn their PvP on or off |
| pvp-toggle.default-enabled | true | Whether new players start with PvP on |
| pvp-toggle.cooldown-seconds | 30 | Time players must wait between changes |
Protection counts down in real time, including while the player is offline.
Stats, Death Messages and Recaps
| Setting | Default | Description |
|---|---|---|
| statistics.enabled | true | Track kills, deaths, K/D and streaks |
| statistics.count-environmental-deaths | false | Count deaths from falls, lava and mobs as deaths |
| leaderboards.enabled | true | Turn /pvptop on |
| death-messages.enabled | true | Replace PvP death messages with NexusCombat ones |
| death-messages.default-visible | true | Whether new players see death messages |
| kill-recap.enabled | true | Show the killer their victim's health, weapon, armor and effects |
Commands
| Setting | Default | Description |
|---|---|---|
| commands.gui.enabled | true | Use menus for stats and leaderboards, false always uses chat |
| commands.<command>.enabled | true | Turn a command on or off |
| commands.<command>.name | per command | Main command name |
| commands.<command>.aliases | per command | Extra names for the command |
| commands.<command>.permission | per command | Permission needed, separate several with ; to allow any of them |
| Command | Name | Aliases | Permission |
|---|---|---|---|
| combat | combat | nexuscombat | nexuscombat.use |
| pvp | pvp | pvptoggle | nexuscombat.toggle |
| stats | pvpstats | combatstats | nexuscombat.stats |
| top | pvptop | combattop | nexuscombat.top |
| deathmessages | deathmessages | pvpdeathmessages | nexuscombat.deathmessages |
If another plugin already uses a command name, NexusCombat leaves it alone and registers its command as /nexuscombat:<name> instead.
Default Config File
storage:
type: sqlite
refresh-seconds: 5
mysql:
url: 'jdbc:mysql://127.0.0.1:3306/nexuscombat'
username: 'nexuscombat'
password: ''
combat:
enabled: true
seconds: 20
action-bar: true
logout:
punishment: KILL
credit-opponent: true
commands: []
blocked-commands: [spawn, home, homes, warp, warps, tpa, tpahere, tpaccept, back, hub, lobby, server]
teleports:
block: true
allowed-causes: [ENDER_PEARL]
regions:
enabled: true
barriers:
enabled: true
radius: 4
refresh-ticks: 8
material: RED_STAINED_GLASS
glow-color: '#ff4055'
item-blocker:
enabled: true
materials: [ELYTRA, ENDER_PEARL, GOLDEN_APPLE, ENCHANTED_GOLDEN_APPLE, BOW]
potion-bans:
enabled: true
effects: [minecraft:strength, minecraft:regeneration]
item-cooldowns:
enabled: true
combat-only: false
seconds:
GOLDEN_APPLE: 8
ENCHANTED_GOLDEN_APPLE: 30
ENDER_PEARL: 12
TRIDENT: 4
MACE: 3
newbie-protection:
enabled: true
seconds: 300
action-bar: true
pvp-toggle:
enabled: true
default-enabled: true
cooldown-seconds: 30
statistics:
enabled: true
count-environmental-deaths: false
leaderboards:
enabled: true
death-messages:
enabled: true
default-visible: true
kill-recap:
enabled: true
commands:
gui:
enabled: true
combat:
enabled: true
name: combat
aliases: [nexuscombat]
permission: nexuscombat.use
pvp:
enabled: true
name: pvp
aliases: [pvptoggle]
permission: nexuscombat.toggle
stats:
enabled: true
name: pvpstats
aliases: [combatstats]
permission: nexuscombat.stats
top:
enabled: true
name: pvptop
aliases: [combattop]
permission: nexuscombat.top
deathmessages:
enabled: true
name: deathmessages
aliases: [pvpdeathmessages]
permission: nexuscombat.deathmessages
Restart the server after editing any file. There is no reload command.
Messages
| Key | Default | |||||
|---|---|---|---|---|---|---|
| prefix | &#FF4055&lNexusCombat &8» &r | |||||
| combat-start | &cYou are in combat with {opponent}. &7Stay online for {seconds}s. | |||||
| combat-end | &aYou are out of combat. | |||||
| combat-action-bar | &c&lIN COMBAT &8· &f{seconds}s | |||||
| combat-command-blocked | &cYou cannot use that command during combat. | |||||
| combat-teleport-blocked | &cYou cannot teleport during combat. | |||||
| region-blocked | &cYou cannot enter a safe zone during combat. | |||||
| item-blocked | &cThat item is blocked during combat. | |||||
| item-cooldown | &cThat item is still on cooldown. | |||||
| potion-blocked | &cThat potion effect is blocked during combat. | |||||
| protection-action-bar | &a&lPVP PROTECTION &8· &f{seconds}s | |||||
| pvp-enabled | &aYour PvP is enabled. | |||||
| pvp-disabled | &eYour PvP is disabled. | |||||
| pvp-toggle-cooldown | &eYou can change PvP again in {seconds}s. | |||||
| death-pvp | &c{victim} &7was killed by &c{killer}&7 with &f{weapon}&7. | |||||
| death-combat-logout | &c{victim} &7logged out in combat against &c{killer}&7. | |||||
| kill-recap | `&f{victim} &8 | &c{health} HP &7before defeat &8 | &7Held item &f{weapon} &8 | &7Armor &f{armor} &8 | &7Effects &f{effects}` | |
| status | `&7PvP &f{pvp} &8 | &7Protection &f{protection}s &8 | &7Combat &f{combat}s` | |||
| stats-summary | `&f{player} &8 | &7Kills &f{kills} &8 | &7Deaths &f{deaths} &8 | &7K/D &f{kd} &8 | &7Streak &f{streak} &8 | &7Best &f{best_streak}` |
| top-entry | &8#{position} &f{player} &8» &c{value} | |||||
| gui-stats-title | &8PvP stats &7· &f{player} | |||||
| gui-top-title | &8Leaderboard &7· &f{metric} |
The Messages table shows the main ones. messages.yml has every message, including the PvP denial messages, command replies, menu item names and leaderboard names. Messages support & colour codes and hex colours written as &#RRGGBB, and any message set to '' is turned off. The prefix is added in front of every chat message automatically.