Combatant Client

Combatant is an open-source utility and PvP client for Minecraft 26.2 on Fabric.

The project provides a broad set of configurable combat, movement, visual, automation, HUD, UI, and integration features, together with its own addon API.

Combatant is already usable, but it is not feature-complete. Some areas still need refinement, compatibility coverage is incomplete, and the public documentation is still being prepared.

Screenshots

HUD

ClickGUI modules

Theme menu

Guides

• Configs and HUD Guide - config profiles, .cbcfg files, loading profiles, and HUD element setup.
• Client Commands - command syntax, aliases, descriptions, and optional mod requirements.

Logo wanted

Combatant does not have a proper project logo yet.

Original logo proposals are welcome. Please do not submit copied artwork, traced logos, generic template edits, or low-effort AI-generated images.

Features

Combatant includes:

• configurable PvP, movement, utility, and automation systems;
• visual information, world customization, and post-processing effects;
• a custom ClickGUI, HUD editor, theme system, and interface components;
• custom rendering and scripting infrastructure;
• an addon API for extending the client;
• optional integration with supported third-party mods.

A complete feature list and detailed documentation will be added separately.

Requirements

Combatant requires:

• Minecraft 26.2
• Fabric Loader 0.19.3
• Fabric API 0.152.2+26.2
• Java 25
• Sodium sodium-fabric-0.9.1+mc26.2

Addon/API projects should target the same Minecraft, Fabric Loader, Fabric API, Java, and Sodium versions as the client.

Supported mods

Combatant includes optional compatibility integrations for Iris, ImmediatelyFast, ViaFabricPlus, Entity Culling, Xaero's Minimap, and Xaero's World Map. The Xaero integration can create, list, and remove waypoints through the @xaero command; see the complete Client Commands reference for its syntax and all other client commands.

How to install

1. Install Minecraft 26.2 with Fabric Loader 0.19.3.
2. Use Java 25 for the game profile.
3. Download the Combatant jar from the GitHub release.
4. Download the required dependency jars:
   • Fabric API 0.152.2+26.2
   • Sodium sodium-fabric-0.9.1+mc26.2
5. Put combatant-0.1.1.jar, Fabric API, and Sodium into your Minecraft mods folder.
6. Start the Fabric 26.2 profile.

Renderer backends

Combatant supports both renderer backends available for Minecraft 26.2:

• OpenGL
• Vulkan

Shaderpack-related Combatant features are currently supported only on the OpenGL backend. This is an Iris-side limitation.

Project status

Active development has slowed down substantially because I (primary maintainer) have left for military service.

Version 0.1.1 is expected to remain the current release for a long time, and further updates should not be expected in the near future. Pull requests can still be submitted and reviewed when time permits, but review and merge times may be inconsistent.

Contributing

Contributions are welcome.

Contributions can be small or large: serious feature work, bug fixes, compatibility updates, visual polish, UI refinements, documentation, localization, diagnostics, and addon API improvements are all useful.

Changes should be useful beyond one private setup. Features tied to one specific server, map, minigame, or network configuration are generally discouraged and are usually better implemented as addons.

Anticheat-specific improvements are acceptable when they provide practical value beyond one server and are supported by clear in-game evidence.

Read CONTRIBUTING.md before opening a pull request.

Addons

Combatant includes an addon loader and a versioned addon API.

Use the combatant-addon-template repository for a minimal addon project structure, examples, and build instructions.

The addon API should be considered usable but not stability-guaranteed until the first tagged public release.

Shaderpack patches

Combatant includes Iris shaderpack patch manifests for selected shaderpacks. See SHADERPACK_PATCHES.md for the currently targeted shaderpack versions and validation workflow.

Building

The current source targets:

• Minecraft 26.2;
• Fabric Loader;
• Fabric API;
• Sodium;
• Java 25.

See BUILDING_GUIDELINES.md for build commands, Javet native handling, and notes for the MediaPlayerInfo native bridge.

License

Combatant's original source code is licensed under the GNU General Public License v3.0 only, unless a file-level notice states otherwise.

Some parts of the project are derived from, adapted from, or designed with reference to other open-source projects and retain their applicable attribution and licensing information.

See:

• LICENSE
• CREDITS.md
• THIRD_PARTY_NOTICES.md
• THIRD_PARTY_LICENSES/

Disclaimer

Combatant is provided without warranty.

Users are responsible for following the rules of the servers and services they use. The maintainers are not responsible for bans, account restrictions, data loss, incompatibilities, or other consequences resulting from use of the client.