Mods / Status Server

Tags: #Utility
Author: Nyuhnyash
Side: Server
Created: Mar 15th 2023 at 10:33 PM
Last modified: Sep 13th at 10:09 PM
Downloads: 885
Follow Unfollow 12

Latest release (for Vintage Story 1.19.8, 1.20.3, 1.20.4, 1.20.5, 1.20.9 - 1.20.10 and 1.20.11 - 1.20.12, outdated):
StatusServer_v1.0.2.zip  1-click install


Provides game server information via popular Server List Ping protocol

Configure

  1. Install the mod with /moddb install statusserver command
  2. Run the server with mod installed for the first time to generate default config file.
  3. Open TCP port specified in mod config (You can't share the same port with Vintage Story game server).
  4. (Optional) Add server icon (64x64, PNG only) path relative to VintagestoryServer executable (or use absolute path).

Default config file

{
    "Port": 25565,
    "IconFile": "server-icon.png",
    "EnabledExtensions": [ "world" ]
}​

Usage

There are plenty of libraries implementing the protocol: mcstatus, mcutil, etc. More examples.

Ready-to-use services: mcsrvstat.us, mcstatus.io, Telegram bot @msmpbot.

Operate raw json to access non-standard extensions data.

Raw json response
{
    "version": {
        "protocol": 2000,
        "name": "1.18.0-pre.6"
    },
    "players": {
        "max": 16,
        "online": 1,
        "sample": [
            {
                "name": "Nyuhnyash",
                "id": "3e4a67aa-c4f1-f5f7-dffd-37e2fad5f74d"
            }
        ]
    },
    "description": {
        "text": "Vintage Story Server"
    },
    "favicon": "data:image/png;base64,<...>",
// Non-standard extension
    "world": {
        "datetime": "2. May, Year 0, 17:31"
    }
}​

Mod Version For Game version Downloads Released Changelog Download 1-click mod install*
1.0.2
1.20.9 - 1.20.10 1.20.11 - 1.20.12
114 Feb 8th at 6:19 PM StatusServer_v1.0.2.zip 1-click install

Fix GameVersion in the response (avoid constant inlining)

1.0.1
1.17.0 - 1.17.4 1.17.8 - 1.18.0-pre.0 1.18.6 - 1.18.7
264 Apr 4th 2023 at 9:55 AM StatusServer_v1.0.1.zip 1-click install

Better exception handling

1.0.1-dev.0
1.18.13 - 1.18.15 1.19.0 - 1.19.1 1.19.7 - 1.19.8
248 Sep 25th 2023 at 8:37 PM StatusServer_v1.0.1-compiled.zip 1-click install

Compiled version of 1.0.1 because .NET 7 built-in compiler can't handle the sourced version (it's a bug)

1.0.0
1.17.0 - 1.17.4 1.17.8 - 1.17.11
259 Mar 15th 2023 at 10:51 PM StatusServer_v1.0.0.zip 1-click install

Initial release


5 Comments (oldest first | newest first)

💬 Nyuhnyash , Oct 1st 2023 at 11:20 PM

Kaofan clientsettings.json generated by VS Server itself, it's fine.

To add icon create 64x64 pixel PNG image, name it server-icon.png and put it in the same directory as VintagestoryServer.

💬 Gnusik2291, Oct 1st 2023 at 9:56 PM

Nyuhnyash

After entering the command "/moddb install statusserver", a new file called "clientsettings.json" appeared. Is this how it's supposed to be?

 

Edit: And how exactly do I add an icon?

💬 Nyuhnyash , Oct 1st 2023 at 9:01 PM

Kaofan When mod is installed it will listen selected TCP port using Server List Ping protocol. You can then send ping or status request (using any online services or libraries) to [server IP]:[port (from mod config)] and recieve a response.

Example with mcstatus:

PS C:\> mcstatus vs.hardshard.ru:25587 ping
23.39459996437654ms
PS C:\> mcstatus vs.hardshard.ru:25587 status
version: v1.18.13 (protocol 2000)
motd: "Motd(parsed=['[RU] HardShard — Vintage Story: Season One', <Formatting.RESET: 'r'>], raw={'text': '[RU] HardShard — Vintage Story: Season One'}, bedrock=False)"
players: 2/50 ['EastRane (09c8c3be-14a8-0799-31a6-3b82bebb73a2)', 'Gottor (e6b572c3-bf56-a864-22c5-293a9a611649)']

💬 Gnusik2291, Sep 29th 2023 at 10:51 AM

Nyuhnyash

how exactly this mod works. Because I understand that when entering the command, the mod somehow installs something, but I don't know where the Server status will be shown.

💬 DearFox, Apr 8th 2023 at 8:50 PM

Хаха, это гениально))
Остальсь только реализовать прокси сервер для подключения Minecraft клиента к серверу VintageStory хD

 (edit comment delete)
Основной веб-сайт | Почтовый сервер | FTP сервер | Административная панель | API интерфейс | Content Delivery Network | Статические файлы | Ресурсы сайта | Изображения | Файловое хранилище | Блог | Интернет-магазин | Техническая поддержка | Справочная система | Документация | Форум | Новости | Загрузки | Демонстрация | Тестовая среда | Приложение | Медиа контент | Разработка | Промежуточная среда | Бета версия | Безопасная зона | Вход в систему | Панель управления | Портал | Система управления контентом