koishi-plugin-haulmp-bot

HaulMP 平台功能插件（欧卡 2 / 美卡 HaulMP 社区论坛配套机器人插件）。

功能

| 指令 | 说明 | | --- | --- | | 绑定H [ID] | 绑定 HaulMP 论坛账号（每 QQ 最多 3 个，第一个为主账号） | | 我的绑定H | 查看全部绑定（标出主账号） | | 更换主账号H | 更换主账号（默认查询/定位账号） | | 解绑H [ID/序号/全部] | 解绑指定账号（多绑定可回复数字选择） | | 注册 | 私聊注册 HaulMP 账号（账号/密码/邮箱 三步问答，返回恢复码） | | 找回密码 | 私信用恢复码重置密码（重置后返回新恢复码；平台无邮件重置） | | 登录 | 私聊设备码登录（免密，Steam / 账号密码均可，有效期 30 天） | | 我的通知 | 私聊查看论坛通知（回复 / @ / 徽章 / 处罚等） | | 我的行驶记录 | 私聊查看总里程 / 时长 / 最近会话 / 当前录制状态 | | 退出登录 | 私聊退出当前登录 | | 查询H [注册账号/游戏ID/QQ号/序号/@群友] | 个人资料卡（多绑定时回复数字选择账号） | | 定位H [名字/ID/QQ号/@群友] | 实时定位：地图卡片 + 位置 / 速度 / 朝向 / 车型 + 附近玩家（名字+距离标注） | | 里程排行榜H | 全站里程前十 + 我的精确名次 | | 服务器H | 服务器状态：在线人数 / 协议 / 客户端版本 | | 注册人数 | 注册统计：总注册用户 / 中国注册人数 | | 路况H | 全平台实时路况（事故 / 施工 / 交警 / 障碍物 / 检查站），图片=全图路况点，文字=列表 | | 版本H | HaulMP 客户端版本 + 欧卡 / 美卡游戏版本（Steam） | | 捆绑包 | Steam 欧洲卡车模拟2 / 美洲卡车模拟捆绑包价格与折扣（图片） | | DLC | 查询欧洲卡车模拟2 / 美洲卡车模拟全部 DLC 现价与折扣（分两张图发送，大小写均可） | | 绑定车队H [车队ID或链接] | 绑定本群车队（仅队长可验证绑定） | | 解绑车队H | 解除本群车队绑定（绑定人或队长） | | 今日里程H | 本群车队当天里程排行 | | 车队排行H [累计] | 车队成员里程排行（默认近30天）| | 菜单 | 功能菜单（图片卡片） |

• 指令末尾 H / h 通用（如 查询h 123456），命令与参数之间可加可不加空格。
• 支持直接 @群友（或打字 @ 群名片）查询/定位已绑定的群友（按名字模糊查询已停用）。
• 自动推送：HaulMP 客户端更新（含 EVM 翻译）、绑定车队的车队公告。
• 地名全量中文翻译（自动翻译入库，遇到未收录地名自动补录）。

依赖

• database（必需）：数据存储
• puppeteer（必需）：图片卡片渲染（输出方式选「文字」时不会调用它）

配置

| 配置项 | 默认值 | 说明 | | --- | --- | --- | | apiBase | https://forum.haulmp.com/api/forum | 论坛 API 根地址 | | vtcBase | https://vtc.haulmp.com/api | VTC API 根地址 | | statusUrl | https://haulmp.com/api/status | 服务器状态接口 | | mapLiveUrl | https://map.haulmp.com/api/live | 实时地图数据接口 | | output | 全部图片 | 各功能输出方式（图片/文字）独立开关：绑定 / 资料查询 / 里程排行榜 / 服务器状态 / 车队绑定 / 今日里程 / 车队排行 / 菜单 / 客户端更新推送 / 车队公告推送 / 实时定位 / 路况 / 版本 / 游戏版本更新 / 捆绑包 / DLC 价格表 / DLC 发布推送 / 打折·恢复原价推送 / 绑定列表

安装

在 Koishi 控制台插件市场搜索 haulmp 安装，或：

npm i koishi-plugin-haulmp-bot

作者

DarkSide · QQ 1691443074

许可

MIT