PetLoader

PetLoader

A lightweight pet management and chunk force-loading mod.

Main Features

• Automatically records tamed pets
• Force-loads the chunks where pets are located, reducing the chance of pets being lost due to chunk unloading
• Periodically tracks the position of recorded pets and notifies when they cannot be found for a long time
• Provides admin commands to view pets, enable/disable force-loading, remove records, and clean up long-missing pet data

---

Commands

Command	Description
/petloader list	List all recorded pets (requires OP)
/petloader scan	Scan currently loaded chunks for tamed pets
/petloader enforce <name/UUID>	Enable force-loading for the specified pet
/petloader deforce <name/UUID>	Disable force-loading and unload related chunks
/petloader remove <name/UUID>	Remove the record of the specified pet
/petloader clean	Clean up pet records whose missingTime exceeds the configured threshold
/petloader reload	Invalid / non-functional command

---

Important Disclaimer

(This is a translation of the original Chinese description. In case of any discrepancy, the Chinese version shall prevail.)

In certain circumstances, we cannot guarantee that the pet's chunk will never be unloaded.

The following situations may cause abnormal behavior:

• Unexpected behavior from other mods
• Server crashes, forced shutdowns, or rollbacks
• Performance degradation caused by too many force-loaded chunks
• Improper configuration
• Changes in API behavior after vanilla or mod updates
• Other possible circumstances

Please back up your world before use and verify that the mod works correctly in a test environment. The author assumes no responsibility for any pet loss, world corruption, or server issues caused by the use of this mod.

---

Configurable Options

• Tracking interval
• Missing detection threshold
• Force-load radius
• missingTime threshold for one-click cleanup
• Debug message toggle

PetLoader

一个轻量级的宠物管理与区块强制加载模组

主要功能

• 自动记录被驯服的宠物
• 强制加载宠物所在区块，降低宠物因区块被卸载丢失的概率
• 定时追踪被记录宠物位置，并在长时间无法找到时进行提示
• 提供管理员命令，方便查看、开启/关闭强制加载、删除记录、清理长时间丢失的宠物数据

命令

• /petloader list — 查看所有已记录的宠物（需要 OP）
• /petloader scan — 扫描当前已加载区块中的驯服宠物
• /petloader enforce <名字/UUID> — 开启指定宠物的强制加载
• /petloader deforce <名字/UUID> — 关闭强制加载并卸载相关区块
• /petloader remove <名字/UUID> — 删除指定宠物的记录
• /petloader clean — 清理 missingTime 超过配置阈值的宠物记录
• /petloader reload — 无效的命令

重要声明

在某些情况下不能保证宠物所在区块永远不会被卸载。

以下情况可能导致功能异常：

• 其他模组意料之外的行为
• 服务器崩溃、强制关闭或回档
• 强制加载区块数量过多导致服务器性能下降
• 配置不当
• 原版或模组更新后 API 行为发生变化
• 其他可能的情况

使用前备份存档，并在测试环境中验证是否正常运作。

因使用本模组导致的宠物丢失、存档损坏或服务器问题作者不承担任何责任。

可配置项

• 追踪间隔
• 丢失判定时间
• 强制加载半径
• 可被一键清理的 missingTime 阈值
• 调试信息开关