Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
PvP-Fix
PvP-Fix is a Minecraft Java Edition datapack project focused on improving and standardizing PvP-related mechanics, with a particular focus on Bed Wars-style gameplay behavior.
PvP-Fix 是一个面向 Minecraft Java Edition 的数据包项目，主要用于改进和统一 PvP 相关机制，重点针对类似 Bed Wars 的游戏行为进行优化。
Development Notice / 开发说明
PvP-Fix is currently in active Alpha development.
PvP-Fix 目前处于积极开发中的 Alpha 阶段。
Features described on this page may be incomplete, experimental, insufficiently tested, or affected by known or undiscovered issues.
本页面所描述的功能可能尚未完成、仍处于实验阶段、尚未经过充分测试，或存在已知及尚未发现的问题。
Compatibility, behavior, and performance may change between development versions.
不同开发版本之间的兼容性、实际行为以及性能表现可能发生变化。
Downloading or using a development version means that the user should expect potential bugs, incomplete functionality, and ongoing changes.
下载或使用开发版本即意味着用户应当预期可能存在 Bug、功能不完整以及持续变化的情况。
If you encounter any issues, unexpected behavior, or other problems while using PvP-Fix, please click here to visit the official GitHub repository and submit an Issue. When submitting an Issue, please accurately specify the version of PvP-Fix you are using.
如果在使用 PvP-Fix 时遇到任何问题、异常行为或其他异常情况，请点击此处前往官方 GitHub 仓库提交 Issue。提交 Issue 时，请准确注明你所使用的 PvP-Fix 版本。
For the most accurate information about a specific version, refer to its version description and changelog.
有关特定版本的具体情况，请以该版本的版本说明及 Changelog 为准。
Features / 功能
TNT
PvP-Fix is designed to provide Bed Wars-style instant ignition for placed TNT.
"Instant ignition" means that TNT is ignited immediately after placement, while the normal vanilla TNT fuse and vanilla explosion behavior are preserved.
This is intentionally different from an instant explosion.
The intended behavior is:
- TNT is successfully placed.
- The placed TNT block is immediately converted into primed TNT.
- The primed TNT entity uses the normal vanilla fuse.
- The normal Minecraft TNT explosion occurs.
- Vanilla TNT damage and knockback behavior are preserved.
PvP-Fix 的 TNT 机制目标是实现类似 Bed Wars 的“顺爆”。
这里的“顺爆”指的是 TNT 放下后立即点燃，而不是立即爆炸。
具体行为为：
- TNT 成功放置。
- 放置后的 TNT 方块立即转换为已点燃的 TNT 实体。
- TNT 实体继续使用原版正常引信时间。
- 最终使用 Minecraft 原版 TNT 爆炸机制。
- 保留原版 TNT 的伤害和击退行为。
This design also preserves TNT jumping behavior.
该设计同时保留 TNT Jump（TNT 跳）等原有玩法。
Fireball
PvP-Fix is designed to provide a Bed Wars-style Fire Charge to Fireball system.
The intended system creates an actual Minecraft small fireball projectile when a player uses a Fire Charge.
Minecraft handles the projectile's normal movement and physics as much as possible, while PvP-Fix handles the PvP-specific behavior when the projectile reaches its collision stage.
PvP-Fix 的火球机制目标是实现类似 Bed Wars 的“火焰弹 → 火球”系统。
玩家使用 Fire Charge 后，系统应生成真正的 Minecraft small_fireball 投射物。
在可能的情况下，投射物的移动和物理过程由 Minecraft 原版系统处理，而 PvP-Fix 负责火球到达碰撞阶段后的 PvP 特殊行为。
Only fireballs created and marked by PvP-Fix should be processed.
PvP-Fix 只处理由自身创建并标记的火球。
This prevents unrelated fireballs, such as Blaze or Ghast projectiles, from being incorrectly modified.
这样可以避免错误处理 Blaze、Ghast 等其他来源的火球。
Container Cleanup
PvP-Fix is planned to provide configurable cleanup behavior for containers produced by item use.
The planned system includes:
- Potion
- Water Bottle
- Water Bucket
- Lava Bucket
- Milk Bucket
PvP-Fix 计划提供可配置的容器使用后清理机制。
计划涉及：
- 药水瓶
- 水瓶
- 水桶
- 岩浆桶
- 牛奶桶
The long-term goal is to modify the final item-use result where possible, while the compatibility implementation may perform cleanup after the normal vanilla action.
长期目标是在条件允许时直接修改物品使用完成后的最终物品结果；兼容模式则可以在原版行为完成后进行清理。
Design Goals / 设计目标
Correctness First / 正确性优先
PvP-Fix prioritizes correct game behavior over implementation shortcuts.
The project should reproduce the intended PvP behavior while preserving relevant vanilla mechanics whenever possible.
PvP-Fix 优先保证游戏机制正确，而不是为了代码简单而牺牲行为准确性。
在实现 PvP 行为的同时，应尽可能保留相关的原版机制。
Performance / 性能
PvP-Fix avoids unnecessary global per-tick entity and block scans whenever an event-driven solution is practical.
事件驱动机制可行时，PvP-Fix 会尽量避免不必要的全局逐 Tick 实体扫描和方块扫描。
Performance is treated as an important design constraint, especially for multiplayer servers.
性能是项目的重要设计约束，尤其针对多人服务器环境。
Compatibility Strategy / 兼容性策略
PvP-Fix is intended to support a pure datapack compatibility path while allowing optional enhanced integrations where supported.
PvP-Fix 计划同时提供纯数据包兼容路径，并在条件允许时提供增强型集成。
The project should not require a specific mod loader merely to use its basic datapack functionality.
项目的基础数据包功能不应强制要求特定 Mod Loader。
Modular Architecture / 模块化架构
PvP-Fix is designed as a modular system.
Planned modules include:
- TNT
- Fireball
- Container Cleanup
- Configuration
- Status and Diagnostics
PvP-Fix 采用模块化设计。
计划中的模块包括：
- TNT
- Fireball
- Container Cleanup
- Configuration
- Status and Diagnostics
Modules should be independently controllable where practical.
在实际条件允许的情况下，各模块应能够独立控制。
Runtime Modes / 运行模式
PvP-Fix targets Minecraft Java Edition 1.21.11.
The project is designed around two runtime paths:
- Enhanced
- Compatibility
PvP-Fix 面向 Minecraft Java Edition 1.21.11。
项目计划采用两种运行路径：
- Enhanced（增强模式）
- Compatibility（兼容模式）
Enhanced / 增强模式
Enhanced mode may use a server-side bridge to receive precise game events and positions from the Minecraft server.
增强模式可以通过服务端 Bridge 获取更加准确的游戏事件和位置数据。
The bridge provides event information to PvP-Fix, while the datapack remains responsible for the gameplay rules.
Bridge 负责提供事件信息，而具体游戏规则仍由 PvP-Fix 数据包负责。
Compatibility / 兼容模式
Compatibility mode uses standard Minecraft datapack functionality.
兼容模式使用 Minecraft 原版数据包机制。
Where exact event information is unavailable, fallback detection may be required.
当无法直接获得精确事件位置时，可以使用兼容性的回退检测方式。
Development Status / 开发状态
PvP-Fix is under active development.
PvP-Fix 当前处于持续开发阶段。
The project is currently focused on improving reliability, refining existing gameplay fixes, and developing the next-generation architecture.
PvP-Fix 当前主要致力于提升现有功能的可靠性、完善已有的游戏机制修复，并逐步开发下一代架构。
Released versions are preserved as historical milestones for testing, debugging, and comparison.
已发布版本将作为历史版本节点保留，用于后续测试、故障分析和版本对比。
Development releases may contain incomplete features, experimental implementations, or changes that are subject to further refinement.
开发版本可能包含尚未完成的功能、实验性实现，或仍会继续调整的内容。
Version Lifecycle / 版本生命周期
PvP-Fix uses the A.B.C version structure during development.
PvP-Fix 在开发阶段采用 A.B.C 版本结构。
A — Major Development Stage / 主要开发阶段
A represents the major development stage of PvP-Fix.
A 表示 PvP-Fix 所处的主要开发阶段。
For example, 0.1 and 0.2 represent different development stages.
例如，0.1 和 0.2 代表不同的开发阶段。
B — Development Line / 开发线
B identifies the development line within the current major stage.
B 表示当前主要开发阶段中的具体开发线。
The 0.1 development line is dedicated to fully implementing the features and design goals defined in the 0.1.0001 historical baseline and its corresponding development log.
0.1 开发线专用于完整实现 0.1.0001 历史基线及其对应开发日志中定义的功能与设计目标。
After the 0.1 development line is completed, development will move to the 0.2 development line.
当 0.1 开发线完成后，项目将进入 0.2 开发线。
C — Development Sequence / 开发序号
C represents the cumulative number of all releases and internal development versions within the current project versioning sequence.
C 表示当前项目版本序列中所有正式发布版本与内部开发版本的累计数量。
The value of C increases continuously with every new version and never decreases or resets.
每产生一个新版本，C 都会持续累加，不会减少，也不会重置。
Both public releases and internal development versions consume one position in the sequence.
无论是对外发布的版本，还是仅用于内部开发、测试或架构迭代的版本，都会占用一个序号。
For example:
0.1.0001 → 0.1.0002 → 0.1.0003 → 0.1.0004 → ...
The sequence continues across development stages; changing from 0.1 to 0.2 does not reset C.
该序号会跨开发阶段持续累加；从 0.1 进入 0.2 时，C 不会重新从 0001 开始。
Release Process / 发布流程
Development / 开发
Development changes are committed and pushed to GitHub.
开发变更通过 Commit 提交，并推送至 GitHub。
Version Tag / 版本标签
Creating an annotated version tag triggers the automated GitHub Actions release workflow.
创建带注释的版本 Tag 后，将触发 GitHub Actions 自动发布流程。
The workflow builds the datapack package and creates a GitHub Release as a Pre-release for verification.
该流程会自动构建数据包，并以 Pre-release（预发布） 状态创建 GitHub Release，用于测试与验证。
Modrinth Distribution / Modrinth 发布
After the corresponding datapack build has been verified, the version may be uploaded to Modrinth according to the project's distribution workflow.
对应的数据包构建完成并通过验证后，可以按照项目的发布流程将该版本上传至 Modrinth。
During active development, Modrinth versions may remain marked as Alpha.
在项目持续开发期间，Modrinth 上的版本可以继续标记为 Alpha。
Independent Release Status / 独立的发布状态
GitHub Release status and Modrinth version type are managed independently and do not necessarily represent the same release stage.
GitHub Release 的状态与 Modrinth 的版本类型相互独立，两者不一定代表相同的发布阶段。
Released and uploaded versions are preserved as historical development milestones.
已经发布或上传的版本将作为项目历史开发里程碑保留。
Performance Philosophy / 性能理念
PvP-Fix does not prioritize the shortest possible command implementation.
Instead, the project prioritizes:
- Correct behavior
- Server performance
- Compatibility
- Maintainability
PvP-Fix 并不以“命令数量最少”为首要目标。
项目优先级为：
- 正确的游戏行为
- 服务端性能
- 兼容性
- 可维护性
License / 许可证
PvP-Fix is licensed under the:
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
PvP-Fix 使用：
Creative Commons Attribution-ShareAlike 4.0 International（CC BY-SA 4.0）
View the full license / 查看完整许可证
The license requires appropriate attribution and requires adaptations to be distributed under the same license.
该许可证要求进行适当署名，并要求衍生作品在相同许可证下进行发布。
AI Disclosure / AI 使用说明
Generative AI has been used during the development and documentation process of PvP-Fix.
在 PvP-Fix 的开发和文档编写过程中使用了生成式 AI。
AI may contribute to:
- Development assistance
- Code generation
- Documentation
- Translation
- Technical analysis
AI 可能参与：
- 开发辅助
- 代码生成
- 文档编写
- 翻译
- 技术分析
PvP-Fix does not contain AI-powered gameplay functionality.
PvP-Fix 本身不包含 AI 驱动的游戏功能。
Disclaimer / 免责声明
PvP-Fix is an independent community project and is not affiliated with, endorsed by, or sponsored by Mojang Studios, Microsoft, or Hypixel.
PvP-Fix 是一个独立的社区项目，与 Mojang Studios、Microsoft 或 Hypixel 没有官方关联，也未获得其认可或赞助。
Minecraft is a trademark of Mojang Studios.
Minecraft 是 Mojang Studios 的商标。
The project attempts to reproduce specific gameplay behavior and does not claim to reproduce the complete internal implementation of any other server or game mode.
本项目旨在实现特定的游戏行为，并不声称复制任何其他服务器或游戏模式的完整内部实现。
Recommended Mod / 推荐模组
PVPUtils
PVPUtils is a PvP utility mod that provides a variety of practical features for high-version Minecraft PvP.
PVPUtils 是一个面向高版本 Minecraft PvP 的实用工具模组，提供了许多适用于 PvP 的实用功能。
PvP-Fix and PVPUtils focus on different aspects of PvP gameplay, making them suitable to use together.
PvP-Fix 与 PVPUtils 主要针对 PvP 的不同方面进行优化，因此可以搭配使用。
PVPUtils currently provides support for Minecraft 1.21.11 on Fabric.
PVPUtils 目前支持 Minecraft 1.21.11 Fabric。