Configuration File
ArenaPvP's main configuration lives in mods/Arenapvp/config.json. It's created automatically on first launch with sensible defaults.
Reloading Configuration
You can reload the configuration without restarting the server:
/arena reload
This reloads config.json and applies changes to language, rating settings, and other global options. Arena templates are also refreshed — new templates become available for the next match.
Global Settings
| Key | Type | Default | Description |
|---|---|---|---|
Version | string | "14" | Config format version (managed automatically, do not edit) |
Language | string | "en" | Plugin language: "en" or "es" |
DebugMode | boolean | false | Enable debug mode (allows single-player arena testing) |
InstancesLimit | integer | 0 | Max concurrent arena instances (0 = unlimited) |
ArenaWorldPrefix | string | "arena_" | Prefix for arena world names |
Visual Effects
| Key | Type | Default | Description |
|---|---|---|---|
ParticleOnDeath | boolean | true | Show particles when a player dies in the arena |
ParticleIds | string[] | ["Teleport", "Lightning:1.5", "MemoryUnlock:1.5"] | Particle effect IDs for death effect (format: "ParticleId" or "ParticleId:scale") |
ActiveRaycast | boolean | true | Show colored particles when looking at another player |
ParticleIdRaycastEnemy | string | "Arena_Raycast_Enemy" | Particle when aiming at an enemy |
ParticleIdRaycastAlly | string | "Arena_Raycast_Ally" | Particle when aiming at an ally |
Rating & Matchmaking
| Key | Type | Default | Description |
|---|---|---|---|
MaxRatingDifference | integer | 50 | Max rating gap for matchmaking (0 = no limit) |
RatingGainOnWin | integer | 25 | Rating earned per victory |
RatingLossOnDefeat | integer | 15 | Rating lost per defeat |
AbandonPenaltyEnabled | boolean | true | Penalize players who leave mid-match |
AbandonPenaltyRating | integer | 25 | Rating deducted for abandoning |
DisconnectPenaltyEnabled | boolean | true | Penalize players who disconnect mid-match |
DisconnectPenaltyRating | integer | 15 | Rating deducted for disconnecting |
MinRatingAfterPenalty | integer | 0 | Minimum rating floor (rating cannot go below this) |
Permissions
| Key | Type | Default | Description |
|---|---|---|---|
DisableGroupPermission | string[] | [] | Permission groups to disable inside arena (list of group names) |
This is useful for disabling certain permission groups' abilities (like creative mode or fly) while players are inside an arena match.
Complete Example
{
"Version": "14",
"DebugMode": false,
"Language": "en",
"InstancesLimit": 0,
"ArenaWorldPrefix": "arena_",
"ParticleOnDeath": true,
"ParticleIds": ["Teleport", "Lightning:1.5", "MemoryUnlock:1.5"],
"ActiveRaycast": true,
"ParticleIdRaycastEnemy": "Arena_Raycast_Enemy",
"ParticleIdRaycastAlly": "Arena_Raycast_Ally",
"MaxRatingDifference": 50,
"RatingGainOnWin": 25,
"RatingLossOnDefeat": 15,
"AbandonPenaltyEnabled": true,
"AbandonPenaltyRating": 25,
"DisconnectPenaltyEnabled": true,
"DisconnectPenaltyRating": 15,
"MinRatingAfterPenalty": 0,
"DisableGroupPermission": [],
"Arenas": [ ... ],
"InventoryPresets": { ... }
}
See Arena Templates and Inventory Presets for the Arenas and InventoryPresets sections.