Skip to content
NordBots.
Back to WarnSystem

WarnSystem configuration

The WarnSystem config.json controls how the plugin runs on your Ark Survival Ascended server. Every setting is listed below with what it does and its default value.

Open the configuration editorPrefer clicking to typing? Build the file with sliders and toggles.

Where it lives

Drop the file on your server at ArkApi/Plugins/WarnSystem/config.json then reload the plugin or restart the server. Keep a backup before large changes.

Every setting

General

Debug
togglefalse
Debug: set to true to write extra lines to ArkApi.log. Leave it false for normal play.
AutosaveSeconds
number30
AutosaveSeconds: how often the plugin saves warnings and mutes to disk. 30 is fine.

Commands

Commands: the words staff and players type in chat. Rename them or set one to "" to turn it off. The first five are for staff. The last one is for any player.

WarnCMD
text"/warn"
staff: add a warning. /warn <player> <reason>
WarningsCMD
text"/warnings"
staff: see a player's warnings. /warnings <player>
UnwarnCMD
text"/unwarn"
staff: remove the newest warning. /unwarn <player>
MuteCMD
text"/mute"
staff: mute a player. /mute <player> <minutes> [reason]
UnmuteCMD
text"/unmute"
staff: unmute a player. /unmute <player>
MyWarningsCMD
text"/mywarnings"
any player: see their own warnings.

Warn

Warn: how warnings and the auto mute work.

TellPlayer
toggletrue
TellPlayer: set to true so the warned player gets a private message with the reason.
AutoMuteAt
number3
AutoMuteAt: how many active warnings before a player is muted on their own. 3 means the third warning triggers a mute. Set it to 0 to turn auto mute off.
MuteMinutes
number30
MuteMinutes: how long the auto mute lasts, in minutes. 30 is half an hour.
MaxMuteMinutes
number1440
MaxMuteMinutes: the longest any mute can be, in minutes. 1440 is one day. This caps both the auto mute and the /mute command.
EscalateMute
toggletrue
EscalateMute: set to true so each warning past the limit mutes for longer. The fourth warning mutes for MuteMinutes times 2, the fifth for times 3, and so on, up to the cap. Set it to false for a flat mute time every time.
ExpireDays
number0
ExpireDays: warnings older than this many days no longer count toward the auto mute. They still show in the history. 0 means warnings never expire.

Mute

Mute: how a mute behaves.

MuteBlocksCommands
togglefalse
MuteBlocksCommands: set to true so a muted player can not use chat commands either. Leave it false so a muted player can still use commands (like /back), and only their normal chat is blocked. False also means a muted staff member can still /unmute.
CommandPrefix
text"/"
CommandPrefix: the character a command starts with. Used to tell a command from chat when MuteBlocksCommands is false. Almost always "/".

Permissions

Permissions: this plugin needs the Permissions plugin for the staff chat commands.

Enabled
toggletrue
Enabled: set to false to skip Permissions. Note: without Permissions the staff chat commands (/warn, /mute, and so on) will not work for anyone, on purpose, so they can not be abused. The mute itself still works once it is set.
StaffPermission
text"WarnSystem.Use"
StaffPermission: the node a player needs to use the staff commands. Give it to your mod and admin groups.

Discord

Discord: post warnings and mutes to a staff webhook. Off by default.

Enabled
togglefalse
Enabled: turn Discord posting on. You must also set a WebhookURL.
WebhookURL
textempty
WebhookURL: paste your staff channel webhook URL here.
Username
text"WarnSystem"
Username: the name the webhook posts under.
ServerName
text"My ARK Server"
ServerName: shows in the embed footer. Handy when you run more than one server.

The full commented config

This is a reading copy with notes. It is not valid JSON, so do not load it. Use the editor or the plain config.json instead.

{
  // This file explains every setting in config.json.
  // It has notes in it, so it is NOT valid JSON. Do not load this file.
  // Edit config.json instead. This file is just here to help you.

  "General": {
    // Debug: set to true to write extra lines to ArkApi.log. Leave it false for normal play.
    "Debug": false,

    // AutosaveSeconds: how often the plugin saves warnings and mutes to disk. 30 is fine.
    "AutosaveSeconds": 30
  },

  // Commands: the words staff and players type in chat. Rename them or set one to "" to
  // turn it off. The first five are for staff. The last one is for any player.
  "Commands": {
    "WarnCMD": "/warn",           // staff: add a warning. /warn <player> <reason>
    "WarningsCMD": "/warnings",   // staff: see a player's warnings. /warnings <player>
    "UnwarnCMD": "/unwarn",       // staff: remove the newest warning. /unwarn <player>
    "MuteCMD": "/mute",           // staff: mute a player. /mute <player> <minutes> [reason]
    "UnmuteCMD": "/unmute",       // staff: unmute a player. /unmute <player>
    "MyWarningsCMD": "/mywarnings" // any player: see their own warnings.
  },

  // Warn: how warnings and the auto mute work.
  "Warn": {
    // TellPlayer: set to true so the warned player gets a private message with the reason.
    "TellPlayer": true,

    // AutoMuteAt: how many active warnings before a player is muted on their own.
    // 3 means the third warning triggers a mute. Set it to 0 to turn auto mute off.
    "AutoMuteAt": 3,

    // MuteMinutes: how long the auto mute lasts, in minutes. 30 is half an hour.
    "MuteMinutes": 30,

    // MaxMuteMinutes: the longest any mute can be, in minutes. 1440 is one day. This caps
    // both the auto mute and the /mute command.
    "MaxMuteMinutes": 1440,

    // EscalateMute: set to true so each warning past the limit mutes for longer. The fourth
    // warning mutes for MuteMinutes times 2, the fifth for times 3, and so on, up to the cap.
    // Set it to false for a flat mute time every time.
    "EscalateMute": true,

    // ExpireDays: warnings older than this many days no longer count toward the auto mute.
    // They still show in the history. 0 means warnings never expire.
    "ExpireDays": 0
  },

  // Mute: how a mute behaves.
  "Mute": {
    // MuteBlocksCommands: set to true so a muted player can not use chat commands either.
    // Leave it false so a muted player can still use commands (like /back), and only their
    // normal chat is blocked. False also means a muted staff member can still /unmute.
    "MuteBlocksCommands": false,

    // CommandPrefix: the character a command starts with. Used to tell a command from chat
    // when MuteBlocksCommands is false. Almost always "/".
    "CommandPrefix": "/"
  },

  // Permissions: this plugin needs the Permissions plugin for the staff chat commands.
  "Permissions": {
    // Enabled: set to false to skip Permissions. Note: without Permissions the staff chat
    // commands (/warn, /mute, and so on) will not work for anyone, on purpose, so they can
    // not be abused. The mute itself still works once it is set.
    "Enabled": true,

    // StaffPermission: the node a player needs to use the staff commands. Give it to your
    // mod and admin groups.
    "StaffPermission": "WarnSystem.Use"
  },

  // Discord: post warnings and mutes to a staff webhook. Off by default.
  "Discord": {
    // Enabled: turn Discord posting on. You must also set a WebhookURL.
    "Enabled": false,

    // WebhookURL: paste your staff channel webhook URL here.
    "WebhookURL": "",

    // Username: the name the webhook posts under.
    "Username": "WarnSystem",

    // ServerName: shows in the embed footer. Handy when you run more than one server.
    "ServerName": "My ARK Server"
  }

  // How mute works under the hood: the plugin watches chat and drops messages from a muted
  // player, so no extra plugin is needed. You can target a player by their online name or by
  // their EOS id. An EOS id works even when the player is offline, which is handy for warnings.
}