假玩家区块加载器

Fakeplayer Chunkloader

一个Minecraft模组，通过假玩家保持区块加载，同时提供实时HUD和地图控制以进行监控，无需依赖真实玩家。

支持的版本

Minecraft	加载器
1.21.10	Fabric, Forge, NeoForge
1.21.11	Fabric, Forge, NeoForge
26.1 / 26.1.1 / 26.1.2 / 26.2	Fabric

每个版本在fakeplayer chunkloader <版本>/<加载器>/目录下有独立的Gradle项目。

主要特点

• 双模式：Fakeplayer（生物生成 + 模拟距离）或 Chunkplayer（仅区块加载票）
• 视觉标记与HUD：颜色编码的标记、实时模拟/区块玩家HUD，以及交互式区块地图
• 交互式地图：基于地形渲染的区块地图，支持切换开关、调整半径和模式切换
• 面板颜色与皮肤：实时UI颜色编辑器以及假玩家的自定义皮肤PNG
• 弹性配置文件：按世界保存的JSON文件，包含备份、限制和自动恢复功能

使用方法

注意： 命令需要OP权限。OP可以使用/fakeplayer permission grant <玩家>向其他玩家授予权限。

1. 添加区块加载器：在需要保持区块加载的位置在聊天框中输入/fakeplayer add（或/fp add）
2. 打开菜单：右键点击假玩家以打开交互菜单
3. 停用区块加载器：攻击（左键点击）假玩家即可停用。它将被移至已停用的区块加载器列表（通过F8访问）
4. 移除区块加载器：潜行并攻击（或潜行并右键点击）假玩家以永久移除，或使用/fakeplayer remove <名称>
5. 全部信息：点击菜单中的信息按钮以访问所有模组信息、功能及详情
6. 命令：在信息按钮下方，您会找到一个命令按钮，其中包含所有可用命令的完整列表

主要按键

按键	功能
F6	切换模拟状态HUD
F7	切换区块玩家状态HUD
F8	打开已停用区块加载器列表

所有按键绑定均可在游戏内的控制 > 杂项部分进行自定义配置。

配置

该模组会自动在<世界目录>/chunkloader/中创建和管理配置。主文件：chunkloader_config.json。所有设置均可通过命令或交互式地图进行更改。

自动功能：

• 添加第一个区块加载器时将自动创建配置文件
• 在chunkloader/backups/中最多保留两个带时间戳的备份（外加一个latest别名）
• 损坏的配置会自动从备份中恢复
• 每个世界一份配置；每个加载器条目按维度 + 区块坐标进行索引

重要说明

• 假玩家永远不会破坏方块或使用物品
• 名称查找不区分大小写，若未找到名称时会提供替代建议
• 系统会防止区块加载器重叠，并在位置冲突时发出警告
• 适用于主世界、下界和末地
• 默认UI半径为0（1个区块中心）。带有生物生成的Fakeplayer模式仍使用更大的有效生成/加载票半径（默认系统最小值约8个模拟/10个加载环），以便保持类似原版的生物生成 — 相比相同UI半径下的Chunkplayer模式，预计会加载更多区块
• Chunkplayer模式更严格地遵循所选的UI半径（仅加载票）
• 地图/网络操作需要区块加载器的所有权或管理员权限（chunkloader.admin）；reload/removeall等破坏性命令同样需要管理员权限
• 自定义皮肤通过服务器同步（按世界存储于chunkloader/skins/下）
• 打开的区块地图会在创建/删除/调整半径/停用时实时刷新其他玩家标记和占用覆盖层；地形瓦片不会实时更新
• 替换模组JAR文件会保留世界数据（玩家、名称、皮肤、已停用列表）；仅代码发生变化
• 区块加载器只能由玩家停用/移除，生物无法执行此操作

兼容性

• 假玩家是用于区块模拟的合成ServerPlayer；其他模组可能仍会在PlayerList中看到它们
• 与SuperMartijn642 Chunk Loaders（模组ID chunkloaders）不同
• 已知的敏感整合包：Polymer、ConnectibleChains、Refurbished Furniture、CreativeCore — 已抑制对假玩家的数据包同步
• 公共API：de.chunkloader.api.ChunkloaderApi.isSyntheticPlayer

致谢

• 区块地图设计灵感来自 SuperMartijn642