lyizai
bc86c26d1e
- 新增 GoalXZAltitude 寻路目标：启发式成本 = 水平距离 - 高度权重×y，y 越大优先级越高、y 越小施惩罚，引导寻路优先走高 - ExpansionConfig 新增 altitudePreference/altitudeWeight 配置(默认开/0.1)，BaritoneBridge 按配置选择原生 GoalXZ 或高度偏好 Goal - 寻路/重试前先检查目标区块是否仍与己方领土接壤(startPathing/retrySameTarget)，不接壤立即跳过 - 寻路超时不再直接传送：重试耗尽后先往边上走两步自救(每轮重试原目标，最多 sideStepMaxRounds=3 轮)，多轮无效才按连续超时阈值回城或切换目标
48 行
3.5 KiB
Markdown
48 行
3.5 KiB
Markdown
# AutoStore — Minecraft 自动扩地模组
|
|
|
|
一个 Fabric 客户端模组，用于在支持 `/u claimmode` 的领地插件服务器上自动扩张领土。
|
|
|
|
## 功能
|
|
|
|
- 从远程 `markers.json` 拉取各国领土边界
|
|
- 四种扩地策略：方形外扩、区域扩地、玩家周围、绕国一圈
|
|
- 区域扩地采用 S 形扫描：从与己方领土接壤的区块开始，横向/纵向 S 形扫过整个矩形，不沿邦国边界，但保证每个新占领区块都与**己方领土**接壤（仅四个正方向，不把其他邦国领土计入接壤）
|
|
- 自动寻路（Baritone）前往目标区块；监听 Baritone 路径事件，目标不可达（CALC_FAILED，如被悬崖/高山/水体隔断）时重试、耗尽后先"往边上走两步"再试，仍失败才切换目标；寻路超时则重新寻路（不立即回城）
|
|
- 高度偏好寻路：寻路优先往高处走（y 越大优先级越高，y 越小有惩罚），适合山区/高原目标；可通过配置关闭或调整权重
|
|
- 连续寻路超时回城：连续寻路超时累计超过 1 分钟（可配置）时，先反复尝试"往边上走两步"脱困（默认最多 3 轮），仍无法脱困才自动发送 `/u return`，约 10 秒后传送到可寻路位置，随后重新规划并从最高优先级区块重新开始扩地
|
|
- 运行时接壤校验：寻路/等待阶段每帧校验目标是否仍与己方领土接壤，地图刷新导致边界变化时立即跳过
|
|
- 目标有效性校验：目标若已被其他邦国占领则立即跳过
|
|
- 现实时间限制：仅 11:00-22:00（本地现实时间）允许开拓，其余时段启动会被拒绝、运行中到点自动停止
|
|
- 自动进食（饥饿时自动吃背包食物）
|
|
- 实时地图 GUI（通过 Ctrl+R 打开）
|
|
- 监听聊天/字幕消息判断开垦结果
|
|
- 刷新地图时与最新 `markers.json` 核对已占领区块，丢弃地图未确认的超期假占领，避免高地扩地残留空洞
|
|
- 刷新请求带缓存击穿（时间戳参数 + no-cache 头），修复约半数刷新命中网络缓存拿到旧数据、导致目标被误标"已占领"且长时间不修正的问题；占领成功后立即触发刷新确认，假占领确认宽限期缩短至 60 秒
|
|
- 飞地（疏漏区块）检测：按 dynmap 奇偶填充规则解析领土多边形，正确识别国中由边界围出的内圈空腔；内置地图用红色标出己方飞地，自动扩地时优先填补这些缺口
|
|
- 区域扩地严格 S 形（蛇形）扫描：起始边为矩形四条边中离王城最近的一条，由内而外推进；即使待开垦区块构成不规则多边形也按 S 形一路扫过去
|
|
- 性能优化：地图渲染按视口快速过滤（不再每帧全量遍历 8 万区块）、飞地检测移至后台线程预计算、接壤校验零集合复制、响应内容未变化时跳过重复解析、ChunkPos 跨模型驻留复用——修复打开 GUI 与刷新地图时游戏卡顿、内存占用偏高的问题
|
|
- 日志导出：GUI 右上角“导出日志”按钮，或 `/autostore log` 命令，记录寻路、坐标、状态、路径事件等
|
|
|
|
## 安装
|
|
|
|
1. 安装 Fabric Loader 0.16.14+ 和 Fabric API
|
|
2. 将 `autostore-1.2.5.jar` 放入 `.minecraft/mods/` 目录
|
|
3. 启动游戏，按 `Ctrl+R` 打开 GUI
|
|
|
|
## 构建
|
|
|
|
```bash
|
|
# 依赖：JDK 21+
|
|
./build_mod.sh
|
|
```
|
|
|
|
输出文件：`autostore-1.2.5.jar`
|
|
|
|
## 赞助支持
|
|
|
|
如果你觉得这个模组对你有帮助，欢迎赞助支持一下创作者 ❤️
|
|
|
|
|
|
|
|
你的支持是持续开发的动力！
|