Skip to content
NordBots.
Back to EventCountdown

EventCountdown configuration

The EventCountdown 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/EventCountdown/config.json then reload the plugin or restart the server. Keep a backup before large changes.

Every setting

General

Debug
togglefalse
Debug: flip to true when you want extra event logging in ArkApi.log. Keep it false otherwise.

Commands

Commands: the words players type in chat.

EventsCMD
text"/events"
EventsCMD: shows all events coming up and how long until each one.

Events

Events: your list of countdowns. Add or remove blocks in the [ ] list. Each event needs a Name and an At time.

Discord

Discord: the webhook that gets the countdown posts. Off by default.

Enabled
togglefalse
Enabled: flip to true to send countdown posts to Discord. A WebhookURL is required too.
WebhookURL
textempty
WebhookURL: drop the channel webhook link from Discord in here.
Username
text"EventCountdown"
Username: what name the bot shows when it posts.
ServerName
text"My ARK Server"
ServerName: printed in the footer of every embed. Put your server name here.

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.

{
  // EventCountdown help sheet. Every setting from config.json is spelled out below.
  // The plugin does not read this file. The notes break JSON, so put your real
  // changes in config.json.

  "General": {
    // Debug: flip to true when you want extra event logging in ArkApi.log. Keep it false otherwise.
    "Debug": false
  },

  // Commands: the words players type in chat.
  "Commands": {
    // EventsCMD: shows all events coming up and how long until each one.
    "EventsCMD": "/events"
  },

  // Events: your list of countdowns. Add or remove blocks in the [ ] list.
  // Each event needs a Name and an At time.
  "Events": [
    {
      // Name: what to call this event in messages.
      "Name": "Server Wipe",

      // At: the date and time the event happens, on the server's local clock.
      // The format is "YYYY-MM-DD HH:MM" on a 24 hour clock.
      "At": "2026-08-01 00:00",

      // WarnAt: how far out to warn players. Each entry is a number then a unit:
      // d for days, h for hours, m for minutes, s for seconds. The plugin sends one
      // warning as the clock passes each point. Put more points near the end to build hype.
      "WarnAt": ["7d", "1d", "1h", "10m", "1m"],

      // FinalCountdownFrom: the last seconds get an on screen tick, like "10, 9, 8".
      // 10 means the last 10 seconds. Set it to 0 to turn the tick off.
      "FinalCountdownFrom": 10,

      // RepeatDays: set to a number to make the event repeat. 7 means it runs again one
      // week later, then the week after, and so on. 0 means it runs once.
      "RepeatDays": 0,

      // GameStyle: how the warning shows in game.
      //   "server" a colored server message on the left.
      //   "notify" a big note in the middle of the screen.
      //   "chat"   a chat line.
      "GameStyle": "server",

      // Color: a color name for the server and notify styles. Try Red, Yellow, Green,
      // Orange, Gold, Blue, Cyan, Purple, Pink, White, Grey.
      "Color": "Red",

      // Discord: set to true to post the countdown to your webhook. The Discord post uses
      // a live timer, so it shows "starts in 3 hours" and updates on its own.
      "Discord": true,

      // DiscordColor: a name (success, info, warn, alert, gold) or a hex number for the embed.
      "DiscordColor": "alert",

      // ZeroMessage: a line shown when the event starts. Leave it "" for a default line.
      "ZeroMessage": "The server is wiping now. Thanks for playing!"
    },
    {
      // A repeating example. Raid weekend runs every 7 days.
      "Name": "Raid Weekend",
      "At": "2026-07-18 18:00",
      "WarnAt": ["1d", "1h", "10m"],
      "FinalCountdownFrom": 0,
      "RepeatDays": 7,
      "GameStyle": "server",
      "Color": "Orange",
      "Discord": true,
      "DiscordColor": "warn",
      "ZeroMessage": "Raid weekend is live. Good luck out there!"
    }
  ],

  // Discord: the webhook that gets the countdown posts. Off by default.
  "Discord": {
    // Enabled: flip to true to send countdown posts to Discord. A WebhookURL is required too.
    "Enabled": false,

    // WebhookURL: drop the channel webhook link from Discord in here.
    "WebhookURL": "",

    // Username: what name the bot shows when it posts.
    "Username": "EventCountdown",

    // ServerName: printed in the footer of every embed. Put your server name here.
    "ServerName": "My ARK Server"
  }

  // A note on times: all times use the server machine's local clock. If your server clock
  // is set to a different zone than you expect, set the times to match the server clock.
  // An event whose time has already passed is skipped, unless it repeats.
}