Server Info Configuration

Server Info Configuration

File: serverinfo/serverinfo.json

General server information and external links.

Complete Example

{
  "server": {
    "name": "KyuubiSoft Server",
    "description": "Welcome to our amazing Hytale server! We offer Survival, Mini-Games and a great community.",
    "version": "1.0.0"
  },
  "stats": {
    "showPlayerCount": true,
    "showUptime": true,
    "showVersion": true,
    "customStats": []
  },
  "announcements": [
    {
      "id": "season2",
      "title": "Season 2 Announcement",
      "text": "Season 2 starts next week! Get ready for new content, features and events!",
      "type": "event",
      "priority": 1,
      "expiresAt": null
    }
  ],
  "links": [
    {
      "id": "discord",
      "name": "Discord",
      "description": "Join our community!",
      "url": "https://discord.gg/yourserver",
      "icon": "Deco_MusicDisc",
      "copyable": true,
      "priority": 1
    },
    {
      "id": "website",
      "name": "Website",
      "description": "Visit our official website",
      "url": "https://yourserver.com",
      "icon": "Deco_Globe",
      "copyable": true,
      "priority": 2
    },
    {
      "id": "store",
      "name": "Store",
      "description": "Support us with a donation",
      "url": "https://store.yourserver.com",
      "icon": "Ore_Gold",
      "copyable": true,
      "priority": 3
    },
    {
      "id": "wiki",
      "name": "Wiki",
      "description": "Server guides and documentation",
      "url": "https://wiki.yourserver.com",
      "icon": "Deco_Book",
      "copyable": true,
      "priority": 4
    }
  ]
}

---

Server Information

"server": {
  "name": "Server Name",
  "description": "Server description text",
  "version": "1.0.0"
}

Field	Type	Description
name	String	Server name
description	String	Server description
version	String	Server version (optional)

---

Announcements

"announcements": [
  {
    "id": "maintenance",
    "title": "Announcement Title",
    "text": "Announcement content text",
    "type": "info",
    "priority": 1,
    "expiresAt": "2026-12-31"
  }
]

Field	Type	Default	Description
id	String	-	Unique announcement ID
title	String	-	Announcement title
text	String	-	Announcement content
type	String	"info"	Type: "info", "warning", or "event"
priority	Integer	99	Sort order (lower = higher)
expiresAt	String	null	ISO date string for expiration (null = never expires)

Multiple Announcements

"announcements": [
  {
    "title": "Maintenance Tonight",
    "text": "Server will be down from 2-4 AM for updates.",
    "priority": 1
  },
  {
    "title": "New Feature: Guilds",
    "text": "Create or join a guild with /guild create or /guild join!",
    "priority": 2
  },
  {
    "title": "Double XP Weekend",
    "text": "This weekend all XP gains are doubled!",
    "priority": 3
  }
]

---

Links

"links": [
  {
    "id": "discord",
    "name": "Link Name",
    "description": "Short description",
    "url": "https://example.com",
    "icon": "Item_Id",
    "copyable": true,
    "priority": 1
  }
]

Field	Type	Default	Description
id	String	-	Unique link ID
name	String	-	Link title
description	String	-	Short description
url	String	-	The URL
icon	String	-	Item ID for icon
copyable	Boolean	true	Allow copying the URL to chat
priority	Integer	99	Sort order (lower = higher)

:::info How Links Work Since Hytale cannot open URLs directly, clicking a link sends the URL to the player’s chat. From there it can be clicked to open in a browser. :::

---

Stats

Display live server statistics on the Server Info page.

"stats": {
  "showPlayerCount": true,
  "showUptime": true,
  "showVersion": true,
  "customStats": [
    {
      "name": "Game Mode",
      "value": "Survival",
      "icon": "Weapon_Sword_Iron"
    }
  ]
}

Field	Type	Default	Description
showPlayerCount	Boolean	true	Show current player count
showUptime	Boolean	true	Show server uptime
showVersion	Boolean	true	Show server version
customStats	Array	[]	Custom statistics to display

Custom Stat Fields

Field	Type	Description
name	String	Stat display name
value	String	Stat value
icon	String	Item ID for icon

---

Common Link Icons

Icon	Item ID
Discord	Deco_MusicDisc
Website	Deco_Globe
Store	Ore_Gold
Wiki/Docs	Deco_Book
YouTube	Deco_Painting
Twitter	Deco_Scroll
Forum	Deco_Chest

---

Examples

Minimal Configuration

{
  "server": {
    "name": "My Server",
    "description": "A Hytale server"
  },
  "announcements": [],
  "links": [
    {
      "name": "Discord",
      "description": "Join us!",
      "url": "https://discord.gg/example",
      "icon": "Deco_MusicDisc"
    }
  ]
}

Event Announcement

"announcements": [
  {
    "title": "Halloween Event",
    "text": "Spooky challenges, exclusive rewards, and haunted dungeons await! Event runs Oct 25 - Nov 1.",
    "priority": 1
  }
]

Social Links Only

"links": [
  {
    "name": "Discord",
    "description": "Chat with the community",
    "url": "https://discord.gg/example",
    "icon": "Deco_MusicDisc"
  },
  {
    "name": "Twitter",
    "description": "Follow for updates",
    "url": "https://twitter.com/example",
    "icon": "Deco_Scroll"
  },
  {
    "name": "Instagram",
    "description": "Screenshots and art",
    "url": "https://instagram.com/example",
    "icon": "Deco_Painting"
  }
]