This is a public mapping of server IPs <-> a pretty display name. This data is used extensively around Lunar Client, most notably when displaying server names (or "Private Server", if unknown) on the friends list. Historically, this mapping was handled internally, and server owners did not have a good way to manage data for their server.
Each server in ServerMappings is represented by a folder with an accompanying metadata.json and logo.png. Open a pull requrest in this repository whilst following the steps below, and we'll review it as soon as possible. Once merged, Lunar Client services will update over the next 20 minutes. Check out metadata.example.json as an example of how to structure your metadata file.
The addresses array in each server object is actually an array of IP suffixes. For example, "addresses": ["lunar.gg", "other.domain"] will match lunar.gg, na.lunar.gg, play.other.domain, and so on.
We also require your server's primary connection information and allowed client versions. The primaryAddress field should be an address included** in the addresses array. The minecraftVersions field must be an array of client versions allowed on your Minecraft server. (ie. 1.18, 1.19); The primaryMinecraftVersion field must be a version included in the minecraftVersions array. The versions you include must be versions that are directly offered in Lunar Client, which can be found in the version selector of the Lunar Client Launcher.
In addition to the data that you will need to provide in your metadata.json, you will need to upload a .png version of your logo into the same folder. All images are to be transparent, square (1:1 aspect ratio), and a minimum of 512px in width and height. The file name should be logo.png. We require the logo to be large as we perform a number of different transformations for all the various places in Lunar Client!
Servers are also required to provide background image, you will need to upload a .png version of the background into the same folder as your metadata.json. Images should represent either the artistic style or the content of the server, with images needing to be a minimum of 1920px in width and 1080px in height, resulting in a 16:9 aspect ratio. The file name should be background.png.
We ask that this repository is only used to store mappings for public Minecraft servers. Some server IPs, such as private SMPs, tournament servers, etc. should not be listed in this repository, out of respect for privacy.
Lunar Client also reserves the right to omit any servers that do not comply with our Terms of Service.
Go for it.
Please contact us at support.lunarclient.com for any additional questions.