Перейти к содержимому
Mineforgian

VPB Hand Animation Compatibility Layer

Client-side Vic's Point Blank compatibility layer for Hold My Items and Punchy hand animations.

Загрузки
2K
Подписчики
5
Обновлён
4 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 15 мая 2026 г.

Исходный кодСообщить об ошибке

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:

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.

Ченджлог

1.0.0+mc1.20.1Релиз1.20.1 · 4 июля 2026 г.

VPB Hand Animation Compatibility Layer 1.0.0

Release type: Release Minecraft: 1.20.1 Loader: Fabric Environment: Client

Changes

  • Public rename to VPB Hand Animation Compatibility Layer.
  • Adds Punchy compatibility for Vic's Point Blank first-person gun animations.
  • Keeps the existing Hold My Items compatibility path for VPB guns.
  • Adds config toggles for Hold My Items and Punchy compatibility.
  • Preserves user config choices after first creation or migration.
  • Recognizes both holdmyitems and legacy hold-my-items Hold My Items mod ids.
  • Validated with split HMI-only and Punchy-only profiles using Point Blank Blue Archive content-pack guns.
  • Keeps the technical mod id vpb_hmi_compat stable.
  • This jar is built separately for Minecraft 1.20.1 because the renderer and runtime APIs differ from newer 1.21 builds.

Notes

  • This is a narrow VPB compatibility layer for Hold My Items and Punchy.
  • It does not alter weapon mechanics, damage, ammo, recoil, input, collision, or server behavior.
  • Current/future 1.0.0+ release metadata is source-available / All Rights Reserved. Prior MIT releases are not retroactively changed.
1.0.0+mc1.21-1.21.1Релиз1.21, 1.21.1 · 4 июля 2026 г.

VPB Hand Animation Compatibility Layer 1.0.0

Release type: Release Minecraft: 1.21, 1.21.1 Loader: Fabric Environment: Client

Changes

  • Public rename to VPB Hand Animation Compatibility Layer.
  • Adds Punchy compatibility for Vic's Point Blank first-person gun animations.
  • Keeps the existing Hold My Items compatibility path for VPB guns.
  • Adds config toggles for Hold My Items and Punchy compatibility.
  • Preserves user config choices after first creation or migration.
  • Recognizes both holdmyitems and legacy hold-my-items Hold My Items mod ids.
  • Validated with split HMI-only and Punchy-only profiles using Point Blank Blue Archive content-pack guns.
  • Keeps the technical mod id vpb_hmi_compat stable.
  • This jar is built against Minecraft 1.21.1 and is published for both 1.21 and 1.21.1.

Notes

  • This is a narrow VPB compatibility layer for Hold My Items and Punchy.
  • It does not alter weapon mechanics, damage, ammo, recoil, input, collision, or server behavior.
  • Current/future 1.0.0+ release metadata is source-available / All Rights Reserved. Prior MIT releases are not retroactively changed.
1.0.0+mc1.21.11Релиз1.21.11 · 4 июля 2026 г.

VPB Hand Animation Compatibility Layer 1.0.0

Release type: Release Minecraft: 1.21.11 Loader: Fabric Environment: Client

Changes

  • Public rename to VPB Hand Animation Compatibility Layer.
  • Adds Punchy compatibility for Vic's Point Blank first-person gun animations.
  • Keeps the existing Hold My Items compatibility path for VPB guns.
  • Adds config toggles for Hold My Items and Punchy compatibility.
  • Preserves user config choices after first creation or migration.
  • Recognizes both holdmyitems and legacy hold-my-items Hold My Items mod ids.
  • Validated with split HMI-only and Punchy-only profiles using Point Blank Blue Archive content-pack guns.
  • Keeps the technical mod id vpb_hmi_compat stable.

Notes

  • This is a narrow VPB compatibility layer for Hold My Items and Punchy.
  • It does not alter weapon mechanics, damage, ammo, recoil, input, collision, or server behavior.
  • Current/future 1.0.0+ release metadata is source-available / All Rights Reserved. Prior MIT releases are not retroactively changed.
0.3.0Релиз1.21.11 · 18 мая 2026 г.

What's Changed

  • Fixed duplicated first-person hand/action-pose visuals while holding Vic's Point Blank guns in the main hand.

  • VPB/Point Blank gun animations now take priority over HMI sneaking, swimming, climbing, flying, and gliding hand poses.

  • Preserved aiming, shooting, reloading, and other VPB gameplay behavior.

  • Scoped suppression to first-person + main-hand allowlisted VPB guns.

  • Kept offhand-only VPB behavior and non-VPB HMI item behavior intact.

  • Added suppressHmiFirstPersonActionPoses config option.

Tested

Validated in-game in GoodCraft:

  • Sneaking with main-hand VPB gun

  • Swimming with main-hand VPB gun

  • Climbing ladders with main-hand VPB gun

  • Flying/gliding with main-hand VPB gun

  • Aiming, shooting, and reloading

  • Offhand-only VPB gun regression

  • Non-VPB HMI item regression

Build

Generated jar:

build/libs/vpb-hmi-compat-0.3.0.jar

0.2.0Релиз1.21.11 · 15 мая 2026 г.

Adds compatibility to these guns: -Point Blank Official || Blue Archive Pack -Vic's Point Blank

Комментарии

Загружаем…