Docs

config.json Reference

The config.json file controls all bot credentials, channel mappings, status intervals, and embed styles for Hytale DiscordSync.

Full Configuration Reference

json
{
  "botToken": "BOT_TOKEN",
  "channelId": "000000000000000000",
  "startMessage": "The server is online!",

  "serverName": "Hytale Server",
  "serverIcon": "https://i.imgur.com/tu_logo.png",
  "serverBanner": "https://i.imgur.com/tu_banner.png",

  "maxPlayers": 100,
  "ignoredAuthors": [
    "System",
    "Sistema"
  ],

  "statusMessages": [
    "Hytale | %online% Online",
    "discord.gg/your-invite",
    "Playing on the Server"
  ],
  "statusInterval": 10,

  "messages": {
    "discordToGameFormat": "§9[Discord] §f%user%: %message%",
    "gameToDiscordFormat": "**%player%**: %message%",
    "playerJoin": ":green_circle: **%player%** joined the server.",
    "playerLeave": ":red_circle: **%player%** left the server.",

    "statusTitle": "Server Status",
    "statusDescription": "**IP:** play.yourserver.com\n**Version:** Latest",
    "statusFields": "👥 Players",
    "statusFooter": "Requested by %user%"
  },

  "embeds": {
    "join": {
      "enabled": true,
      "color": "#57F287",
      "title": "Player Joined",
      "description": "%player% has connected."
    },
    "leave": {
      "enabled": true,
      "color": "#ED4245",
      "title": "Player Left",
      "description": "%player% has disconnected."
    },
    "death": {
      "enabled": true,
      "color": "#2F3136",
      "title": "Player Died",
      "description": "%player% died."
    },
    "serverStart": {
      "enabled": true,
      "color": "#5865F2",
      "title": "Server Status",
      "description": "The server is now **ONLINE** 🟢"
    },
    "serverStop": {
      "enabled": true,
      "color": "#ED4245",
      "title": "Server Status",
      "description": "The server is now **OFFLINE** 🔴"
    }
  }
}

Settings Breakdown

Core Settings

  • botToken: Your Discord bot token from the Discord Developer Portal.
  • channelId: The numerical ID of the Discord text channel for chat relay.
  • serverName: Display name of your server used in /status embeds.
  • serverIcon: Direct URL to a PNG/JPG icon for your server.
  • serverBanner: Direct URL to a large banner image displayed in /status.
  • maxPlayers: Maximum player slots shown in status embeds.
  • ignoredAuthors: In-game chat authors ignored by the Discord relay.
config.json Reference | Hytale DiscordSync Docs