Adding your server to Betacraft server list

⚠️ Prerequisites

The process of adding your server to the list is different depending on server software.

Vanilla or hMod servers

You can find vanilla servers here. hMod archives are available here.

a1.0.16 to 1.16.5

  1. Download the serverlist agent, save it to your server directory.

  2. Modify your server start script by adding: -javaagent:serverlist-agent.jar to it.

    The final start script should look like this:

    java -javaagent:serverlist-agent.jar -jar minecraft_server.jar nogui

  3. Start the server. If you see that BetacraftPing loaded, proceed with the next step.
    (if not, contact us for support on our Discord server)

  4. Open up betacraft/ping_details.json in a text editor. Modify it accordingly for your needs, and save.
    Explanation for each setting can be found here.

  5. Start the server again.


c0.0.16a_02 to c0.30 and a1.0.15

For information about setting up a c0.0.15a server with MrLordSith's server mod, see below.
For information about MCGalaxy, see below.

1.17 to 1.17.1


1.18 and later

❗️Before proceeding with the next step, make sure you've run your 1.18+ server at least once before.

  1. Download the serverlist agent, save it to your server directory.

  2. Extract META-INF from your server jar into your server directory.

  3. Open up META-INF/classpath-joined in a text editor. Select the whole text and copy it.

  4. Create your server start script using this template:

    java --add-opens=java.base/sun.net.www.protocol.http=ALL-UNNAMED -javaagent:serverlist-agent.jar -cp [PASTE THE TEXT HERE] net.minecraft.server.Main nogui

    ⚠️ If you're running the server on any other system than Windows, replace all instances of ";" with ":"

  5. Start the server using the newly crafted start script. If you see that BetacraftPing loaded, proceed with the next step.
    (if not, contact us for support on our Discord server)

  6. Open up betacraft/ping_details.json in a text editor. Modify it accordingly for your needs, and save.
    Explanation for each setting can be found here.

  7. Restart the server.

  8. You can now remove the META-INF directory extracted earlier.

Codie's a1.0.5-a1.0.14 server remakes

You can find the remakes here.

MrLordSith's c0.0.15a server mod

You can find the server mod here.

MCGalaxy 1.9.5.0+

MCGalaxy is available here.

  1. Download the heartbeat plugin, save it to your plugins directory.

  2. Run the MCGalaxy server.

  3. Execute commands:
    /pcompile BetacraftV2Heartbeat
    /pload BetacraftV2Heartbeat

  4. Open up plugins/bcv2/heartbeat.properties in a text editor. Modify it accordingly for your needs, and save.
    Explanation for each setting can be found in the config file, or here.

  5. Execute command: /server reload

Bukkit or Spigot servers

You can get Uberbukkit (for b1.0-b1.7.3) here. Bukkit archives are available here and here.

b1.0 (Uberbukkit) to 1.21.2

  1. Download the serverlist plugin, save it to your plugins directory.

  2. If you're not running Poseidon or Uberbukkit, also download GSON, and save it as "gson.jar" in plugins/BetacraftPing/ directory (which you need to create).

  3. Start the server. If you see that BetacraftPing loaded, proceed with the next step. (if not, contact us for support on our Discord server)

  4. Open up plugins/BetacraftPing/ping_details.json in a text editor. Modify it accordingly for your needs, and save.
    Explanation for each setting can be found here.

  5. Restart or /reload the server.

Heartbeat configuration settings

Server list agent and Bukkit plugin settings

{
    "game_version": "a1.0.15",
    "protocol": "alpha_13",
    "name": "A Minecraft server",
    "description": "",
    "private_key": "",
    "socket": "49.12.205.146:25565",
    "category": "alpha",
    "v1_version": "a1.0.15",
    "send_players": true
}
Setting Notes
game_version Game version ID, as presented in Betacraft launcher.
protocol Protocol ID, from the protocolVersion property held in .betacraft/versions/jsons/[version].info
name A server's name might be max 64 characters.
description A server's description might be max 256 characters.
private_key Private key provided by us, upon verifying your server. It is required to set an icon for the server, change server category and use a domain for your server address.
socket Address for joining the server, including the port.
category Category in which the server should appear. Requires a valid private_key. Possible values: classic, indev, infdev, alpha, beta, release
v1_version Game version provided for Betacraft launcher v1 to use. Can be set to a mod name from mod repository.
send_players Whether to share online playernames with the server list API or just the player count.

MCGalaxy

Comments for MCGalaxy plugin settings can be found inside the config file itself: plugins/bcv2/heartbeat.properties

Setting an icon

To set an icon, your server must be verified, and you must supply the server list agent/plugin with the server's private key.


⚠️ Prerequisites

Your server icon shall be provided in PNG format and not exceed 128x128 in resolution and 64 KiB in size. We reserve the right to revoke verification status of servers which icons we deem inappropriate or malicious.


Bukkit plugin

Put your icon in plugins/BetacraftPing/. Call the file server_icon.png. It will apply upon server restart or /reload


Server list agent

Put your icon in betacraft/. Call the file server_icon.png. It will apply upon server restart.


MCGalaxy plugin

Put your icon in plugins/bcv2/. Call the file icon.png. It will apply upon /server reload