PDA

View Full Version : [Misc] LiquidMS



PixL
March 18th, 2023, 14:10
8811 (https://github.com/zibonbadi/liquidms/)

LiquidMS (https://github.com/zibonbadi/liquidms/) is a reverse-engineered implementation of Sonic Robo Blast 2's HTTP Master Server. It is licensed under GNU Affero General Public License version 3 (AGPLv3) and has been developed from the ground up around modularity and decentralization. Some of it's current features include:

General features



Interchangeable web-based server browser with integrated options for featureful (fancy) and lightweight (fast) deployments.
Out-of-the-box Docker-Compose setup based on modern web hosting technology for easily getting started.
(for developers) Modular design to be easily extensible with additional APIs (e.g. Legacy, SRB2Kart) to be able to host one master server to rule them all.


The Master Server

Our master server is designed to be the all-in-one toolkit for all your master server needs:



Rock-solid (according to user impressions)
Vanilla (https://web.archive.org/web/20220205110841/https://mb.srb2.org/MS/tools/api/v1/)-compliant API
Security fixes for API-level vulnerabilities of the original master server
Modular configuration to integrate each running node into your community exactly how you need it
SRB2Query endpoint to provide live netgame data
Crowdsourcable mirroring of other vanilla API-compliant Master Servers
Custom Snitch API to synchronize networks of LiquidMS nodes.


The "fancy" server browser

The web-based fancy server browser was built to bring SRB2's server browser into the modern age. It has been built to be simple, powerful, dynamic and responsive:



Mobile-friendly layout
Live information on netgames
Asynchronous netgame updates, individually and in bulk
Text search to filter for netgame titles, info, currently active players, origin, EVERYTHING
Pin important netgames to the top of the list
Drag & Drop to reorder the existing view of netgames
Colored netgame title support
Aggregate statistics on players currently online
(upcoming) Dark and Light modes, adapting to your browser preferences


HELP WANTED

Liquid Underground (http://discord.gg/HVTzVfAWG6) needs help making LiquidMS even more awesome. If you're interested, here's some of the things that you could currently help us out with:



Good ol' hosting of nodes, especially in cooperation with the Liquid Underground network
Documentation of the "2.1" legacy Master Server API
Implementing the legacy and SRB2Kart Master Server APIs
Documentation & Implementation of Modding information & downloadable files into the "fancy" server browser
Submitting bugs and feature ideas
Writing documentation and helping users get started (especially on Windows)



If you have any questions, join our Discord or post them below in this thread. We'd gladly welcome any help you can legally provide, especially around implementing the legacy master server API, but even if just by using our software. Thank you.

Sky
March 21st, 2023, 01:22
This is really cool. Welcome to modifications!

PixL
March 21st, 2023, 12:43
Thank you. Now that the thread got approved though, I feel the need to reiterate the question for visibility: Does anyone on the Skybase have info on the old binary MS API perhaps? That feature has been in demand pretty much since the release of v1.0.0 about a year ago and I've kinda been grasping straws on that for a while now :D. I simply don't know where to get any documentation on it. Thanks for everything.