分享一款在lua/python脚本里使用的mud地图管理/路线规划库

优点:

  • 跨客户端,跨语言。可以在mush/mudlet/ls等客户端,通过lua/python的方式使用,也可以独立的使用nodejs/lua/python进行调用
  • 毫秒级别的路径查询(取决于地图大小/路径长度/CPU性能)
  • 完全开源。基于Mit协议的宽松开源协议,你可以自由的扩展/改写/利用代码。
  • 有Hell和红尘两款Mud的机器深度使用本库的算法
  • 地图文件也可以通过 hmm.ts项目,在原生的javascript/lua中使用
  • 有跨平台(windows/macos/linux)的编辑软件支持,编辑软件支持版本分差对比。
  • 完善的文档/单元测试
  • 支持多点对多点寻路(querypathany)规划路线
  • 支持模拟移动逼近的方式动态生成便利路径(quarypathall)规划路线
  • 支持按顺序进入房间的形式(querypathordered)规划路线
  • 支持标签,支持带值的标签,以动态的决定某个出口只能被符合某个条件,或技能不低于某个值的情况下才启用/禁用。
  • 支持房间黑/白名单,移动指令的黑/白名单来的形式动态规划路线
  • 支持地图膨胀,一般配合模拟逼近的形式,遍历出生于目标区域会随机移动的NPC可以到达的房间
  • 支持临时禁用出口,应对npc拦路/技能不符无法通行的情况
  • 支持临时房间和路径,用以解决随机迷宫,自建房屋等问题
  • 支持 直达捷径,用于实现flyto/rideto/miss等功能
  • 支持对房间的可变信息保留多个版本的快照,并在快照内进行搜索
  • 支持转码,可以支持utf-8以及gbk编码

限制:

作为作者,个人对用用只有以下三个希望

  • 希望不要以Mud owner禁止的方式使用本库
  • 希望不要在不欢迎本库的Mud宣传本库
  • 希望不要在禁止或者不欢迎公开传播地图文件的mud 传播本库生成的地图文件

API: API文档

代码范例

预览版本下载链接:

https://github.com/hellclient-scripts/hellmapmanager/releases/tag/embedding.2026.04.22

京ICP备13031296号-4