Pixel MK Menu

Executive Summary

Pixel MK Menu is a client side GUI mod for minecraft. It changes the main menu, buttons, the pause menu and other miscellaneous GUIs.

Executive Summary
Table of Contents
Introduction
Changes
- Main Menu
  - Default Menu
  - With Create and Quark
- Pause Menu
Adding Buttons
Credits
License

Introduction

The Minecraft main menu and other menus aren't that modern, sleek or beautiful. We can see due to the popularity of menu editor mods and GUI redesign mods and other mod GUIs that the menus leave a lot to be desired. This desire to change the menu and the soon-to-be-released Pixel MK 4 modpack leaves a hole to be filled that was filled with Pixel MK 1 and 2's Voxel Menu mod that was brought over from the Voxel Modpack.

This mod serves as a port/successor to that mod, redesigning the menu and, bringing in modern mod support as well as support for Forge.

Changes

Pixel MK Menu currently only changes the Main Menu, Create's main menu (if Create is loaded) and the Pause Menu.

Main Menu

The Main menu has up to 10 buttons, when both Create and Quark are enabled/installed alongside Pixel MK Menu, normally this count is only 8.

Default Menu

As you can see the main menu looks much more sleek and polished. This modernity directly reflects the modpack as a whole and is translated into the modpack using resourcepacks and others. For anyone who doesn't like the menu it can be removed without consequence.

One of the new buttons on the menu is a mute button to mute menu music entirely, the menu music can also be muted using the config to restore the original menu music.

It is also possible to add a modpack definition in the top-left corner to bring a little extra touch to the menu using a JSON file, this will eventually also be extended into an entire button and dynamic screen.

With Create and Quark

The Buttons added with Quark and Create are built into the mod but any other buttons will have to be added via determination from other mod authors unless requested and approved through the issue tracker.

The way to add this is documented here

Pause Menu

The pause menu has been redesigned to take up a smaller space of the screen and no longer dims the background meaning that it is easier to see you surroundings when online. The pause menu also has animations associated with it.

Adding Buttons

This Functionality does not yet exist in 1.20.6

To add a button it is as simple as catching an event (AddModButtonsEvent event) on the Forge Event Bus.

The file for this event can be found at AddModButtonsEvent.java.

The code used would be something along the lines of

import com.pixelmk.pixelmkmenu.event.AddModButtonsEvent;
import net.minecraft.client.gui.components.Button;
import net.minecraftforge.common.MinecraftForge;
import net.minecraftforge.eventbus.api.SubscribeEvent;

// ...

public void init() {
    // ...
    MinecraftForge.EVENT_BUS.addListener(this::addButton);
    // ...
}

@SubscribeEvent
public void addButton(AddModButtonsEvent event) {
    event.createButton("examplemod.usingStringButton",
        $ -> {LOGGER.info("This button was created using a string")});
    event.createButton(new TranslatableComponent("examplemod.usingComponentButton"),
        $ -> {LOGGER.info("This button was created using a component")});
    event.addButton(new Button("examplemod.usingMCButton"),
        $ -> {LOGGER.info("This button was created using a Minecraft Button")});
}

Credits

Programming - Joe Targett of the Pixel MK team
Some code lifted and edited from Pack Menu and Somnia Awoken.
Music by eXtaticus, Kuraishin, ph00tbag, and FelixMoog.
Art by Joe Targett
Idea by xIGBClutchIx, Mumfrey and the rest of the VoxelModPack Team.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Executive Summary

Table of Contents