Server Side

• Combat AI

  • Performs mace attacks, crits, and elytra mace strikes.
  • Uses totems and heals itself when low.

• Difficulty

  • Three difficulty levels: Noob, Pro, and Master.
  • Adjusts the bot's reach and accuracy (how often it misses), and restricts certain actions — like elytra macing — depending on the level chosen.

• Modes

  • NPC — A stationary punching bag for basic combat practice.
  • Fight — The full simulated bot that fights back.
  • Practice — Three focused training sub-modes:
    • Stun Slam — Hold your shield to practice landing stun slams.
    • Aim — The bot floats in mid-air in a flying state, giving you a smaller hitbox to practice your aim against.
    • Pearl Catch — The bot uses wind charges to repeatedly launch itself around 6 blocks into the air, letting you practice pearling and macing timing.

• Equipment Management

  • Automatic inventory refill.
  • Supports elytra flight and customizable kits.

• Kits

  • Create, delete, and view kits entirely through commands.
  • Build a new kit from scratch, or generate one directly from your current inventory.
  • There's no in-game kit editor on the server side, so if you don't have the client-side mod installed, you can still edit a kit: equip it, adjust the items in your regular inventory, then run /macebot kits <kit> copyInv to save those changes back to the kit.

• Bot Identity

  • Spawn the bot with a custom name. If that name matches a real Minecraft account, the bot will use that account's actual skin — for example, spawning the bot as "Wemmbu" gives it the name and skin of the player Wemmbu.

• Customization

  • Toggle crits, ordinary mace attacks, elytra usage, and more.
  • Control whether the bot can damage you.
  • Full command-based control over every MaceBot setting — see Commands below.

• Safety Defaults

  • Buffs and auto-refill are disabled by default to prevent accidental use in regular survival worlds.
  • All commands require Level 3 operator permissions for the same reason.

Client Side

The client-side mod is entirely optional — MaceBot works fully through commands without it — but it adds a complete GUI for players who'd rather not type. Open it with the default keybind P.

• Taskbar GUI — Settings, Control Panel, Kits, and Info all live in one unified, taskbar-style screen instead of separate windows, with full flexible control over everything — well beyond what commands alone offer.
• Control Panel — Start, pause, spawn, or despawn the bot, and rename it on the fly through a Name Field. If the name matches a real Minecraft account, MaceBot fetches and displays that player's real skin.
• Theme Editor — Customize the colors used throughout the GUI, including the Combat Hitbox color, from the Settings screen.
• Kits Screen & Kit Menu — Browse all built-in and custom kits, then rename (with color codes), delete, duplicate, edit, or load them.
• Kit Loader Menu — Load a kit onto MaceBot, yourself, or all players, with a choice of Unbreaking III & Mending or an Unbreakable tag (breakable items only).
• Kit Editor — A flexible editor covering item names (with color codes), enchantments, attributes, item count, any creative-menu item, and a built-in NBT editor for fine-grained control. Includes a one-click Copy Inventory button that copies your current inventory straight into the kit. Built-in kits can't be edited directly, but you can duplicate and customize them.
• Kit Viewer — Preview kits before loading them.
• Combat Hitboxes — Highlights your current target's hitbox in a customizable color (default: red) to help with spacing and aim practice.
• Hotkeys — Quickly open GUI screens, toggle the client mod, or toggle Combat Hitboxes without opening a menu.
• Safety Restrictions — The client mod restricts certain actions without operator permissions by default; operators can disable these restrictions in settings if they want non-op players to use the mod freely.

All commands are grouped under /macebot and require Level 3 operator permissions.

Note: Commands give you full control on their own — no client mod required. If you do have the client mod installed, the GUI wraps all of this in a more visual, point-and-click experience.

Server

• Place the correct version of MaceBot in the mods folder and restart the server.
• Access MaceBot using the commands listed above (requires Level 3 operator permissions).
• The client-side mod is optional — install it too if you want the full GUI experience.

Client

• Place the correct version of MaceBot in the mods folder and restart the client.
• In singleplayer, you can use both commands and the GUI to control MaceBot.
• On dedicated servers, you can also control MaceBot via the GUI.
  (Be mindful of version compatibility.)

• v1.0 — Initial release. Server-side only, command-controlled.
• v1.1 — Server-side only, follow-up release with additional fixes and refinements.
• v1.2 — Added the first client-side GUI for easier control.
• v1.3 — Full command-based control, Difficulty levels, Modes, bot identity/skins, a redesigned taskbar GUI with a Theme Editor, Combat Hitbox overlay, and safer defaults. See "What's New in v1.3" above.