mc-fix-todo

name	mc-fix-todo
description	认领并收敛项目代码中的一个TODO

任务简介

全文搜索本项目中的所有代码（关键词包括但不限于：TODO 简化 暂时 等），认领并收敛项目代码中的一个TODO。若用户已经指定了todo，则做用户的。 todo除了来自代码注释外，你还可关注下面这个文件：docs\UNIMPLEMENTED_ITEMS.md，里面记录了未实现的物品。如果你选择收敛这个文件里面的一个物品或者一类物品，请务必保证你收敛完之后，将这个列表中的对应项目标记为已完成（不要删掉相应条目，而是加上已完成标记 ✅ 已完成，便于后续追踪）。

任务详细流程

1. 注意：项目中的todo大部分都很容易处理，其所依赖的子系统已经相当完善.
2. 认领其中一个你认为相对容易解决的todo。若用户已经指定了todo，则做用户的。
3. 选定了一个todo之后，请你先阅读相关readme文件，以初步了解内容和范围，然后启动七个子代理，彻查该todo涉及到的代码。这七个子代理中，需要有3~5个左右专门负责探索项目中已有的对应基建，以实现完美的、最高程度的复用。不要限制子代理的输出字数，让它们尽可能详细地输出它们的探索结果。
4. 收敛的过程可能会非常复杂，可能需要你深入理解相关代码、探索并复用已有基建、设计并输出一份合理的实现方案（但不要进入计划模式）、编写大量代码、编写测试用例、修复编译错误和测试失败等。你需要充分利用你的编程能力和项目理解能力来完成这个任务。不允许简单删除这个todo或者留下一个不完整的实现来应付了事，必须要完整地收敛它，确保相关功能完全实现、没有遗漏、没有使用简化实现、没有临时占位符、没有未集成的孤岛代码等。如果你在收敛这个todo的过程中发现某个地方很难短时间内实现，我们非常鼓励你在这个地方先留下一个新的TODO（但必须加上明确且显眼的TODO注释，注释中要有明文TODO，便于全文搜索）。
5. 最后，生成简体中文提交信息并提交代码，然后推送到远程仓库。注意：可能有人在和你并行工作，你可能需要处理潜在的合并冲突。
6. 如果拉取/推送代码的时候因为网络问题没有成功，那么你无需重试，将该提交留在本地后即可停下来了，以后我会帮你去做。另外，/include/minecraft-reborn/version.h这个文件如果git显示未提交，你不用理会，将其留在工作区即可，重点是处理其他文件。
7. 如果你在执行过程中发现这个todo过于复杂、实现时间太长等，你可以随时回滚代码，然后选下一个其他的todo去处理。

你需要随时留意：

1. 尽可能准确复刻D:\Minecraft\MC研究\Minecraft1.21.11源码\net\minecraft下的算法、逻辑、时序等，与原版任何一点点偏差都会导致偏离预期（因此你派出的子代理需要注意对比下mc与本项目源码）。但不要照搬，因为cpp和java的特性不同，项目的架构也不同，你需要根据cpp的特性和当前项目的架构进行合理的架构设计和调整。
2. 是否完整，没有遗漏类、文件、函数、数据、结构、逻辑分支等
3. 是否闭环、是否完整集成到游戏逻辑当中，没有形成无法被调用的“孤岛代码”

注意本项目基建已经相当完善（代码量已经100w+行），各种常数、常用工具函数、音频系统、粒子系统、资源包系统、命令系统、实体系统、物品系统、物理系统、碰撞、tick调度、存档等都已经有了相当完善的实现(另外world对象上面也挂了相当多的工具方法以便访问世界、操作世界等)，务必充分探索以实现复用，避免重复实现。

善用README

几乎每个目录下都有一个简体中文编写的 README.md，它很重要，在你探索项目实现的时候，提前看看它，能节省不少多余的文件查找与查看，节省不少上下文开销。

【重要】为了节省上下文，请你尽量阅读各级目录的 README.md 来获取你需要的信息，而不是直接查看代码文件。

例如：当你修改想修改或查看src\common\world\chunk\ChunkLoadTicketManager.cpp，你必须提前依次查看目录链上的各级目录上的readme文件：

• 项目根目录的 README.md
• src\common\README.md
• src\common\world\README.md
• src\common\world\chunk\README.md

请你不仅自己要严格遵照上述要求，而且在给子代理的prompt中也要要求它们先查看相关目录链上的README.md来获取信息，而不是直接查看代码文件。

实现要求

1. 阻塞等待所有子代理完成（禁止子代理在后台运行）。所有子代理完成之后，请你总结出一个详细的TODO收敛行动指南，并且给出详细的逐步收敛建议。然后不要停下来，而是继续立即开始一步步执行！
2. 你时间充足、上下文也充足，先把所有任务代码一口气写完，最后再编译
3. 务必尽可能复用项目中已有的基建！
4. 在任务执行过程中，你可以随时派出子代理来帮你完成一些子任务，比如说探索项目中已有的对应基建、探索项目中需要依赖的某个子系统是否存在、甚至帮你编写代码！

关于代码

【重要】必须参考下面mc源码！ windows环境源码位于 D:\Minecraft\MC研究\Minecraft1.21.11源码 macos环境源码位于 ~/MC_Dev/Minecraft1.21.11源码

1. 必须优雅、考虑到未来拓展、结构清晰美观整洁、架构强大，必须参考mc源码（主要是为了学习mc真实游戏逻辑而非架构。mc的架构水平和代码质量并不高！），但不要照搬，必须根据cpp的特性和当前项目的架构进行合理的架构设计和调整。
2. 当前项目是一个复刻项目，目标是完全使用cpp尽可能一致地复刻java版mc的游戏体验，并在存档、数据包等层面上尽可能兼容和复用现有java版minecraft生态。务必要有清晰、优雅、能让人赏心悦目的目录结构，不要把很多文件全部堆在一个目录下，要划分好细分的子目录。
3. 务必要有清晰、优雅、能让人赏心悦目的目录结构，不要把很多文件全部堆在一个目录下，要划分好细分的子目录！
4. 编译过程中遇到的warning你也要一并解决