Skip to content

About

TaCZ prone hitbox / prone crawl tweaks for Minecraft Forge 1.20.1

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TaCZ Prone Hitbox (Minecraft Forge 1.20.1)

Pawn / crawl hitbox fix for Minecraft Forge 1.20.1. It replaces the tiny 0.6-block vanilla AABB used while a player is prone with an oriented body box that follows the body, adds a front headshot zone, and takes over the vanilla hit tests that otherwise ignore the pose.

状态:版本 v1.5.6(公开)。兼容 TaCZ 1.1.8 与 1.2.0;1.2.0 已做启动/进世界实机验证。模型/判定箱已按实机截图对齐,头箱位于身体箱内部前端,顶面与身体顶面齐平。

Features

  • Oriented body box while prone: width / height / length / forward offset are configurable.
  • Headshot zone at the head end of the body; configurable width / length / height / vertical offset.
  • TaCZ bullets (EntityUtil.getHitResult) use the same box + latency rewind.
  • Vanilla projectiles (arrows, throwables, tridents, fishing bobber, ...) go through ProjectileUtil.getEntityHitResult, so they use the body box too.
  • Explosion visibility sampling uses the body box corners instead of the vanilla AABB.
  • Client debug rendering: F3+B shows the body box (white) and head zone (red). The box and prone model use the render partial tick for interpolation, so they do not jitter on remote players / while moving.
  • Hold-to-crawl: hold TaCZ's crawl key and the player stays prone (setPose + setForcedPose) with a 1.0 step height, so falling, jumping, shooting or stairs cannot cancel the crawl. Release the key to automatically stand up. The hold works like the old proven pose lock: it does not call TaCZ's cooldown-protected crawl(true/false), so the second press always stands up. TaCZ's own crawl-key handler and client crawl() state changes are suspended (this was the gun-only stuck issue), and raw GLFW key events are tracked as a fallback to KeyMapping.isDown(). No extra key is needed; /pronehitbox lock shows the state.
  • Custom prone model renderer that places the model from the same shape data (disabled for non-prone players; vanilla rendering is untouched).

Physical collision still uses the normal vanilla AABB: Minecraft only supports one AABB per entity. Only hit tests are replaced.

Install

  1. Install Minecraft Forge 1.20.1 (47.x).
  2. Put the jar in mods/. The same jar works on client and server; on a dedicated server it is a normal server mod, on a client it also registers the client debug renderer/key.
  3. Optional: TaCZ 1.1.8+ is needed for the TaCZ bullet path; the vanilla projectile / explosion paths and the prone hitbox still work without TaCZ.

Built jar: dist/taczpronehitbox-1.20.1-1.5.6.jar.

Usage

  • Prone with TaCZ's crawl key (or any mod that sets Pose.SWIMMING), then:
    • F3+B: show body / head boxes;
    • /pronehitbox status: crawl / shape status;
    • /pronehitbox shape: dump the current body box, world AABB and 8 corners to latest.log;
    • /pronehitbox crawl / /pronehitbox stand: force crawl / stand (diagnostics).
  • Hold-to-crawl: hold the TaCZ crawl key (default C; if you rebound it, e.g. B, use that key) while prone. Step height becomes 1.0 and the prone pose is re-applied every tick, so movement, jumping, shooting and stairs keep you prone. Release the key to stand up automatically.

Build

Windows, JDK 17, Gradle 8.8 / ForgeGradle 6.0:

build-offline.bat build
build-offline.bat selfTest

The self test is a pure-JVM geometry test (no Minecraft client needed) and should print ALL PASS. build-offline.bat uses a project-local GRADLE_USER_HOME and an offline Maven repository; on a clean machine use gradlew.bat build instead.

Config

config/taczpronehitbox-common.toml:

[shape]
bodyWidth = 0.65
bodyHeight = 0.50
bodyLength = 1.80
forwardOffset = 0.0
baseHeight = 0.0
headWidth = 0.65
headLength = 0.60
headHeight = 0.30
headVerticalOffset = 0.0
  • headVerticalOffset = 0: head slab sits on top of the body box at the head end.
  • Negative values sink it into the body; positive values raise it.
  • shape.yawSource: HEAD (default, model-facing yaw) or BODY.

config/taczpronehitbox-client.toml: debug style, colors, show headshot zone, hide vanilla prone hitbox, show mode.

Layout

  • src/main/java/.../shape/ProneShape.java — oriented body box + head zone + clip.
  • src/main/java/.../prone/ — per-player position/yaw history (thread-safe).
  • src/main/java/.../hit/ — TaCZ bullet hit handler.
  • src/main/java/.../mixin/ — TaCZ bullet, vanilla projectile, explosion, model renderer, vanilla hitbox hiding.
  • src/main/java/.../lock/ — prone lock key + client/server state.
  • src/main/java/.../client/ — debug renderer, debug commands, model transform.
  • src/main/java/.../test/HitboxSelfTest.java — geometry self test.

Version

Current: 1.5.6 (Forge 1.20.1, TaCZ 1.1.8 hotfix2 tested). See REPORT.md for the full development log. This repository is public; only the latest release is kept.

声明 / Declaration

  • 维护账号:wdho,历史贡献以提交记录为准。项目代码、文档与测试使用 AI 辅助生成或修改;本次声明整理使用 OpenAI Codex 辅助。

  • 本项目是非官方 Minecraft Forge / TaCZ 附属模组,与 Mojang Studios、Microsoft、Forge 团队或 TaCZ 开发者无隶属、合作或背书关系。相关名称、商标、代码及资源归各自权利人所有。

  • 本仓库目前未提供许可证文件,不将公开可见解释为授予复制、修改或再分发许可;需要相关授权时请联系权利人。本文不为本项目或第三方内容新增开源许可。

  • 本模组会改变卧姿命中判定及相关玩法,安装与配置应遵守服务器管理规则;不要将其描述为只影响本地外观的工具。

  • 支持版本、构建和实测范围以本文已有记录为准,不承诺全部 TaCZ 版本、模组组合或服务器环境均兼容;使用前保留配置和存档备份。

  • Maintained under the wdho account; historical contributions are recorded in the commit history. Code, documentation and tests use AI assistance; this declaration rewrite used OpenAI Codex assistance.

  • This is an unofficial Minecraft Forge / TaCZ addon, not affiliated with, partnered with or endorsed by Mojang Studios, Microsoft, the Forge team or TaCZ developers. Third-party names, trademarks, code and assets remain with their respective owners.

  • No license file is currently provided. Public visibility is not a grant of permission to copy, modify or redistribute; contact the rights holders for permission. This declaration adds no open-source license to this project or third-party material.

  • The mod changes prone hit detection and related gameplay. Installation and configuration must follow server rules; it is not a purely local cosmetic tool.

  • Supported versions and verification are limited to the existing records in this README, not every TaCZ version, mod combination or server environment. Keep configuration and save backups before use.

About

TaCZ prone hitbox / prone crawl tweaks for Minecraft Forge 1.20.1

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages