VPB Hand Animation Compatibility Layer

# VPB Hand Animation Compatibility Layer VPB Hand Animation Compatibility Layer is a client-side Fabric compatibility mod for Vic's Point Blank, Hold My Items, and Punchy. It keeps Point Blank and Point Blank content-pack guns in control of their own first-person hand animations while leaving normal items to Hold My Items and Punchy. The mod is intentionally narrow: it does not change weapon mechanics, damage, fire/reload logic, recoil, ammo, input, collision, or server-side behavior. ## What It Fixes - Lets VPB gun animations take priority over Hold My Items first-person render redirects. - Suppresses HMI first-person action-pose hands while a Point Blank gun owns the main hand. - Lets Punchy stand down for Point Blank items through Punchy's own item-blacklist path. - Keeps non-Point-Blank items using HMI and Punchy normally. - Supports Point Blank Blue Archive content-pack guns through the normal `pointblank` namespace allowlist. - Keeps optional debug diagnostics available through config. ## What's New In 1.0.0 - Public project name changed to VPB Hand Animation Compatibility Layer. - Punchy compatibility is included beside the existing Hold My Items compatibility. - Minecraft 1.21.11, 1.21/1.21.1, and 1.20.1 release builds are available. - Missing config toggles are auto-populated from installed mods on first launch or migration. - `holdmyitems` and the legacy `hold-my-items` mod ids are both recognized for HMI compatibility. - The technical mod id remains `vpb_hmi_compat` for update continuity. ## Compatibility Available release lines: - Minecraft 1.21.11 - Minecraft 1.21 and 1.21.1 - Minecraft 1.20.1 Use the file that matches your Minecraft version. The mod is client-only and is safe for singleplayer or multiplayer clients; it is not required on a server. ## Installation Put the matching `vpb-hmi-compat` jar into the client or modpack `mods` folder together with Vic's Point Blank and either Hold My Items, Punchy, or both in separate client profiles. ## Configuration On first client launch, the mod creates: ```text config/vpb_hmi_compat.json ``` If the config file or a compatibility toggle is missing, the mod auto-populates the missing toggle from installed mods. It does not overwrite user-defined choices on later launches. To test a specific item id, add it to `bypassItemIds`, for example `"pointblank:ba_ariusar"`. To collect diagnostics, temporarily set `debugLogging`, `heldItemLogging`, and `mixinLogging` to `true`. ## Compatibility Notes - This mod targets VPB first-person hand-animation conflicts only. - It does not claim broad compatibility with every animation mod. - Fresh Animations, EMF, and ETF are not patched here. ## License Current and future `1.0.0+` project code and public metadata are source-available / All Rights Reserved unless a file says otherwise. Prior releases that were published under MIT are not retroactively changed. Official unmodified builds may be included in modpacks. Independent compatibility mods/add-ons are allowed when they interact through normal runtime behavior. Copying, modifying, porting, redistributing altered builds, publishing forks, or creating derivative works from this code/assets requires permission. ## Credits Created by Swiyss and elizinro.