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 已做启动/进世界实机验证。模型/判定箱已按实机截图对齐,头箱位于身体箱内部前端,顶面与身体顶面齐平。
- 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 Minecraft Forge 1.20.1 (47.x).
- 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. - 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.
- 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 tolatest.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.
Windows, JDK 17, Gradle 8.8 / ForgeGradle 6.0:
build-offline.bat build
build-offline.bat selfTestThe 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/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.0headVerticalOffset = 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) orBODY.
config/taczpronehitbox-client.toml: debug style, colors, show headshot zone, hide vanilla
prone hitbox, show mode.
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.
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.
-
维护账号: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.