Create a Minecraft Launcher
Create a Minecraft Launcher
Want to see the full process first? Watch the tutorial below, then follow the written steps underneath at your own pace.
Watch on YouTubeIf you want to build a simple Minecraft Launcher, this is the easiest place to start.
The overall setup is simple:
- design your launcher page
- insert the Minecraft Server object
- enter your server details
- link your Play button to that object
- build with Minecraft support enabled
The Minecraft object is called MinecraftButton internally, but it is not actually a clickable button by itself. It stores your Minecraft connection settings. Your real clickable object should still be a normal Button, such as your Play button.
Step 1: Design Your Launcher Page
Start by building the look of your launcher page.
You can begin from scratch or use a template. A simple beginner layout usually includes:
- a Minecraft-style background
- a launcher title
- a short welcome message
- a Play or Connect button
The easiest way to set your page background is through Pages > Edit Page Settings > Background. That keeps it locked into the page so you do not keep selecting it while editing.
Once the page looks right, move on to the Minecraft object.
Step 2: Insert the Minecraft Server Object
Open the Object Panel and insert the Minecraft Server object.
If it shows as unavailable or not installed, the Minecraft plugin is not currently installed in your editor.
Once inserted, you can place it anywhere you like. This object mainly exists to store your Minecraft settings and connect them to your button later.
Think of this as the Minecraft connection object that sits behind the scenes. Your users do not interact with it directly like a visible button.
Step 3: Enter Your Server Settings
Select the Minecraft object and open its settings.
You now need to fill in the connection details for your server.
Server IP
Enter your Minecraft server IP address or DNS name.
192.168.1.10
play.yourserver.com
Server Port
Enter your Minecraft server port.
If you are not sure, the usual default Minecraft port is 25565.
Server Version
This part matters most.
You must enter the exact Minecraft version string used by your server.
For a normal vanilla server, that may be:
1.21.1
If your server uses mods or loaders, enter the full version string, not just the base Minecraft version.
1.18.1-forge-39.0.19
fabric-loader-0.11.3-1.16.5
1.12.2-LiteLoader1.18.1
If your server uses Forge, Fabric, LiteLoader, or another mod-related setup, do not only enter the base Minecraft version. You must use the correct full version string that matches your actual setup.
RAM and Window Settings
You can also review the Minecraft memory and window settings in the object properties.
For a basic launcher, keep these simple to begin with. The important part is getting the IP, port, and exact version string correct. You can fine tune the rest later.
Step 4: Copy the Internal Name
Once your Minecraft object is configured, select it again and in it's settings, give it a good name you will remember for the next part.
Step 5: Link Your Play Button
Now select the button you want players to press.
In most launchers, this will be your Play button or Connect button.
- Select the button
- Open its settings or events
- Create a new action on the click event
- Choose Connect to Minecraft Server
- Select your Minecraft Server Object with your server configuration in here.
That is the main link done. Your button now points to the Minecraft object, and that object supplies the server details.
The button triggers the action. The Minecraft object provides the connection data.
Step 6: Build Your Launcher
When you are ready to build, just build your launcher and test.
Important Notes
Your launcher can handle the Minecraft connection flow, but players must still have Minecraft installed correctly on their system.
If your server requires extra setup such as client-side mods, loaders, or other files, those still need to be installed separately by the player.
We cover that side in another guide:
Minecraft Installation & Mod Setup Guide
This tutorial covers the launcher side only. It does not replace a proper Minecraft installation, and it does not automatically install mod requirements for the player.
We cannot guarantee connection for all mods and server types because these are being developed and updated as such fast rates. However, from what has been tested so far, Vanilla, Fabric, Forge and LiteLoader are working just fine.
Quick Summary
- design your launcher page
- insert the Minecraft Server object
- enter the server IP, port, and exact version
- copy the internal name
- link your Play button to that object
- build with Minecraft Support enabled
Once you understand that flow, creating a clean Minecraft Launcher is actually pretty straightforward.