Back to mods
Punchy × Essential Compat project artwork

CurseForge · Minecraft mod

Punchy × Essential Compat

Draws your Essential cosmetics on Punchy's first-person arms, instead of leaving your hands invisible.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Punchy × Essential Compat release should I use?

Updated last month
Latest stable file Punchy x Essential Compat 1.0.0
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

Punchy × Essential Compat Punchy x Essential Compat 1.0.0 targets 26.1, 26.1.1, 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Punchy × Essential Compat required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Punchy × Essential Compat Punchy x Essential Compat 1.0.0 need?

Punchy x Essential Compat 1.0.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Punchy × Essential Compat without breaking your instance.

Built for Punchy × Essential Compat Punchy x Essential Compat 1.0.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Punchy x Essential Compat 1.0.0. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Punchy x Essential Compat 1.0.0. It opens that exact file at the source.

About this project

What does Punchy × Essential Compat add?

The problem

Install Punchy and Essential together, put on an outfit that covers your arms, and your hands disappear. The item you are holding just floats in front of you.

Neither mod is broken. They simply disagree about who draws your arms — and the result is that nobody does.

What this mod does

It gets them to share the work, so your outfit shows up on your own hands:

Switching outfits in the Essential wardrobe while the cosmetics follow Punchy's animated first-person arms
  • Your outfit is drawn on your first-person arms. Sleeves, gloves, claws — whatever your cosmetic puts on the arms, you now see it in first person too.
  • It moves with Punchy. Swinging, mining, blocking, sprinting — the outfit follows every animation instead of hovering in place.
  • Outfits without sleeves still work. If nothing covers your arms, you simply get your normal skin hands back.

Change outfits in the wardrobe and your hands change with them. There is nothing to set up, no keybinds, no menu.

Installation

  1. Make sure you already have Fabric Loader 0.19.3 or newer, Punchy and Essential installed.
  2. Download the mod and drop the .jar into your mods folder.
  3. Start the game. That's it.

Client-side only — nothing to install on a server, and it works on servers that don't have it.

Will it work for me?

Minecraft 26.1, 26.1.1, 26.1.2, 26.2
Loader Fabric
Punchy 2.6.1 and 2.7d
Essential 1.3.10.x and 1.4.0.x
Java 25

Essential is optional. Without it the mod just sits there doing nothing, so it is safe to leave in a modpack.

No versions for 1.20 or 1.21. Minecraft changed how it draws things in 26.0, and this mod plugs straight into that new system. Supporting older versions would mean writing it a second time from scratch. See TECHNICAL.md if you want the details.

Something looks wrong?

<details> <summary>My hands are still invisible</summary>

Check that Punchy is actually enabled (Mod Menu → Punchy → the mod's own toggle), and that this mod appears in your mod list. If both are fine, open an issue and include the log — the section below explains how to make it useful.

</details>

<details> <summary>The outfit sits in the wrong place, or my skin shows through it</summary>

That's worth reporting. Before you do, check whether it also looks wrong in third person (press <kbd>F5</kbd>) — if it does, the cosmetic itself is off and there is nothing this mod can fix.

</details>

<details> <summary>How do I report a bug properly</summary>

Open config/punchy-essential-compat.json, set "debugLogging": true, restart, wear the outfit that misbehaves, and play for a few seconds. Your logs/latest.log will then list every cosmetic you are wearing and what it covers. Attach that log to the issue along with a screenshot.

</details>

Settings

You do not need to touch these — the defaults are what you want. The file appears at config/punchy-essential-compat.json after the first launch.

Setting Default What it does
renderCosmeticsOnFirstPersonArms true Draw your outfit on your first-person arms. Turn off to keep plain skin hands.
unmaskFirstPersonArms true Safety net so your hands never go invisible, even if something unexpected happens.
debugLogging false Writes a report about your worn cosmetics to the log. Turn on when reporting a bug.
logErrors true Report problems in the log instead of failing quietly.
firstPersonParts ["LEFT_ARM", "RIGHT_ARM"] Which body parts to draw in first person. Leave it alone.

If something goes wrong while drawing, the mod switches that part off for the rest of the session and falls back to normal visible hands. It will not crash your game.

Built with AI assistance

This mod was written with the help of AI (Claude). The conflict was tracked down by taking both mods apart and reading what they actually do, and every connection point was checked against the real game files.

What has been tried, and what hasn't:

  • ✅ Minecraft 26.2 with Punchy 2.7d and Essential 1.4.0.3 — played in the game. The clip above was recorded on it.
  • ⚠️ Minecraft 26.1.x with Punchy 2.6.1 and Essential 1.3.10.x — checked against those files, but nobody has played it yet. It should work. Tell me if it doesn't.

For developers

TECHNICAL.md has the full write-up: what each mod does to the render pipeline, why they collide, how the fix hooks in, and how to build it without Gradle.

Contributions are welcome — especially ports to older Minecraft versions.

Credits

This is an independent compatibility patch. It is not affiliated with, endorsed by, or supported by either project, and it contains no code from either.

License

MIT — do what you like with it.

Project description from CurseForge.

Pick your setup

Punchy × Essential Compat by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Punchy × Essential Compat versions and loaders

1 of 1 releases match

Looking for an older file? The official CurseForge project page is in Resources.