World Handler Wiki

World Handler - Command GUI Mod is a robust management tool designed to streamline the administration of Minecraft worlds. By replacing traditional chat-based commands with an intuitive visual interface, it allows players and server administrators to toggle weather, change time, switch gamemodes, and spawn entities with a single click.

The mod is built on a modular architecture, allowing for extensive customization through its Usercontent API. This enables users to create their own buttons, menus, and complex scripts using JavaScript to automate repetitive tasks or add unique server-management features.

The primary method of interacting with the mod is through its dedicated GUI. By default, the interface is accessed using a specific keybind, which can be reconfigured in the standard Minecraft controls menu.

Upon opening the GUI, users are presented with a grid of icons representing different management categories. Hovering over an icon provides a tooltip description of its function.

The World Management section provides instant access to environmental variables. This eliminates the need for commands like /time set or /weather.

Time Control

Users can set the world time to specific presets:

• Sunrise: Sets time to 0.
• Noon: Sets time to 6000.
• Sunset: Sets time to 12000.
• Midnight: Sets time to 18000.
• Time Freeze: Toggles the doDaylightCycle gamerule.

Weather Control

Weather can be toggled instantly between three states:

• Clear: Removes rain and thunder.
• Rain: Initiates standard precipitation.
• Thunder: Initiates a thunderstorm.
• Weather Lock: Toggles the doWeatherCycle gamerule.

Difficulty and Rules

This sub-menu allows for the rapid adjustment of the world's difficulty (Peaceful, Easy, Normal, Hard) and the toggling of common Gamerules such as keepInventory, mobGriefing, and fireTick.

The Player Management interface allows for the modification of player states and inventory contents. This is particularly useful for creative building or server testing.

Gamemode Switching

Quick buttons are provided for all standard gamemodes:

• Survival
• Creative
• Adventure
• Spectator

Player Stats

Users can manipulate their current status effects and vitals:

• Heal: Restores full health and hunger.
• Clear Effects: Removes all active potion effects.
• Experience: Adds specific levels of XP to the player.
• Fly: Toggles flight capabilities regardless of gamemode (requires server-side support).

Inventory Tools

• Clear Inventory: Wipes the player's inventory (with a confirmation prompt).
• Give Item: Opens a searchable list of all items in the game, allowing users to add them to their inventory with custom stack sizes.

The Entity Management system provides a visual way to interact with the world's population.

Mob Spawner

This menu lists every entity registered in the game. Selecting an entity allows the user to:

• Spawn a single instance at the player's crosshair.
• Spawn multiple instances in a specified radius.
• Configure entity NBT data (in advanced mode).

Entity Cleanup

To assist with server performance, the mod includes a "Kill Entities" function. Users can filter which entities to remove:

• All Mobs: Removes all living entities except players.
• Hostile Mobs: Removes only aggressive entities.
• Items: Clears dropped item entities from the ground.
• Projectiles: Removes arrows, fireballs, and other flying entities.

World Handler API version 2.0 allows users to extend the mod's functionality by creating custom JSON files. These files must be placed in the .minecraft/config/worldhandler/usercontent/ directory.

Guidelines

• All custom content must follow valid JSON syntax.
• Images used for custom buttons should be in .png format and placed in the textures sub-folder.
• Custom scripts are written in JavaScript and stored in the scripts sub-folder.

Widget States

Widgets (buttons and menu elements) can have different visual properties based on their state:

Button Configuration

Custom buttons are defined by their action and dimensions.

Action Types:

• COMMAND: Executes a standard Minecraft command.
• SCRIPT: Runs a JavaScript file from the scripts folder.
• MENU: Opens a different sub-menu.
• CLOSE: Closes the GUI.

Dimensions: Buttons require x, y, width, and height parameters relative to the menu container.

For advanced automation, the mod exposes several internal objects to the JavaScript engine. This allows for logic-based command execution.

Available Objects

• player: Provides access to the player's name, position, and inventory.
• world: Provides access to world time, weather, and block data.
• server: Allows for the execution of console-level commands.

Common Functions

Example Script:

// Toggles creative mode and notifies the player
if (player.getGamemode == "survival") {
 executeCommand("/gamemode creative");
 printChat("Creative Mode Enabled");
} else {
 executeCommand("/gamemode survival");
 printChat("Survival Mode Enabled");
}

The mod's behavior can be tweaked via the worldhandler.cfg file. Key settings include:

• Permission Level: Defines the minimum OP level required to use the GUI on servers (Default: 2).
• Button Sounds: Toggles the click sound effects when navigating menus.
• Tooltip Delay: Adjusts how long the mouse must hover over an icon before the description appears.
• Theme Selection: Allows users to switch between different visual skins for the GUI (e.g., Dark Mode, Classic Minecraft, or Transparent).