Main Site

Minecraft Pro

Object Preview
Minecraft Server Object
Gamer and Developer
Requires Minecraft Plugin

The Minecraft Server object is a dedicated configuration element that seamlessly bridges your Custom Game Launcher with a specific Minecraft game client and server. Visually, it acts as a static image on your page, but underneath, it securely holds the network and game settings required to boot the game and connect the user instantly.

This object removes the friction of IP management, manual RAM allocation, and version selection for your players. By setting up a Minecraft Server object, you give your community a true one-click entry point into your world directly from your Custom Launcher.

Pro Tip

To utilize the Minecraft Server object, you must have the Minecraft Plugin installed and activated in your account.

Minecraft Settings Overview

When you place a Minecraft Server object onto your canvas, you gain access to specialized properties designed to configure the game client exactly how you need it before launch.

Connection Settings

  • Server IP: The IPv4, IPv6, or domain hostname of your Minecraft server.
  • Port: The connection port. This defaults to the standard 25565, but can be adjusted if you are running a proxy or custom setup.

Game Settings

  • MC Version: The specific game version string required to join your server (for example, 1.21.8). The launcher will ensure this version is utilized.
  • Min RAM (MB): The starting memory allocation for the Java virtual machine. Defaults to 1024.
  • Max RAM (MB): The maximum memory limit allowed for the game client. Adjusting this helps prevent out-of-memory crashes for heavy modpacks.

Window Settings

  • Screen Width and Height: Defines the resolution the Minecraft client will launch at. Default is 1024x768.

Minecraft Events

The Minecraft Server object does not feature any built-in events. It functions strictly as a data container and visual placeholder. To trigger logic or launch the game, you must use actions on a separate interactive object, such as a Button or Image Button.

Minecraft Actions

To boot the game using the settings you have defined, you need to call the dedicated plugin action from another object.

Action How it works
Connect to a Minecraft Server Targets a specific Minecraft object and initiates the launch sequence using all the configuration data (IP, RAM, Version) baked into that object.

Building Logic with the Minecraft Object

Because the Minecraft Server object is a data container, you will pair it with standard interactive elements to build a robust launching experience.

Example 1: The Standard Play Button

Replace manual game launchers with a beautifully branded play button that handles everything in the background.

  1. Place the Minecraft Server object on your page (you can hide it or place it off-screen if you do not want the icon visible).
  2. In the properties panel of the Minecraft Server object, fill in your Server IP, Port, and target MC Version.
  3. Place a standard Button object on your page and style it to say "Play Game".
  4. Select your standard Button, open its onClick event block, and add the Connect to a Minecraft Server action. Set the target to your Minecraft Server object.
  5. Now, clicking the play button instantly boots Minecraft and connects the player directly to your server lobby!

Example 2: User-Defined RAM Allocation

Allow players to adjust how much RAM they dedicate to the game based on their system specs before they hit play.

  1. Set up your Minecraft Server object as normal.
  2. Add a Slider object to your page, setting its minimum to 1024 and maximum to 8192 (representing MBs).
  3. Under the Slider's onValueSet event, use the Push to Variable action to store the user's chosen value into a global variable (e.g., chosen_ram).
  4. Immediately follow that with the Set Object Property from Variable action. Point it at your Minecraft Server object, target the max_ram property, and use the chosen_ram variable. The launch configuration is now dynamically updated, ready for when they click your Play button!

Custom CSS Example

If you have the Developer Edition, you can use Custom CSS to apply striking visual overlays to the Minecraft Server object wrapper.

Important Notice

Always use !important in your declarations. Never override structural geometry like position, width, or height, as this will break the launcher's layout engine. Stick to visual enhancements like filters, box shadows, and static overlays.

Custom CSS Glow Preview

Pro Tip

Hover over the image above to see how a smooth transition and box-shadow combination can elevate the object without touching any inner structure!

css

 /* Developer Edition Custom CSS Example for Minecraft Object */
 /* Add a smooth baseline shadow and border setup */
 border-radius: 8px !important;
 box-shadow: 0 4px 15px rgba(0,0,0,0.4) !important;
 border: 1px solid transparent !important;
 transition: all 0.3s ease !important;
 /* Apply the glowing electric blue effect on hover */
 :hover {
 box-shadow: 0 0 25px rgba(59,130,246,0.6), inset 0 0 10px rgba(255,255,255,0.05) !important;
 border-color: rgba(59,130,246,0.8) !important;
 filter: brightness(1.1) !important;
 }

Summary

The Minecraft Server object turns a multi-step game boot process into a completely unified experience. By locking in version dependencies and server connections within a centralized data object, you guarantee your players are always hitting the right server with the right settings from the moment they click play.