Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗺️ pubg-map-toolkit

PUBG 战术地图辅助工具 — 9 张高清主图(瓦片化)、点位标注、左键测距、卡拉金地下隧道连通性标注。本地运行,无需联网。


✨ 特性

  • 🗺 九张高清地图:艾伦格 / 米拉玛 / 维寒迪 / 泰戈 / 帝斯顿 / 荣都 / 帕拉莫 / 萨诺 / 卡拉金,8192² 清晰度,瓦片金字塔 z0–z5 本地加载。
  • 📍 点位标注:默认显示「密室」等;维寒迪额外显示熊洞;卡拉金默认显示地下隧道入口(地下室)。
  • 🕳 卡拉金地下隧道连通性:半透明青色多边形标注 22 个隧道入口及其「内部空间 / 相通网络」,数据源自 pubgresource。
  • 📏 左键测距:左键标记测距点、点同处取消、右键清除,并按各图真实尺寸(km)换算距离。
  • 🔒 开发者功能:密码保护(仅存 SHA-256 加盐哈希),可添加点位、管理点位类型、撤销 / 清空,点位保存到项目文件 points.js

📸 预览

运行预览


🚀 快速开始(一键运行)

普通用户:从 GitHub Releases 下载最新「一键运行包」pubg-map-toolkit-<版本>.zip, 解压后双击 start_tool.bat,服务器启动后自动打开浏览器(http://127.0.0.1:8123)。 需本机装有 Python 3.8+(安装时勾选 Add python.exe to PATH)。

开发者 / 从源码跑

python server.py                       # 打开 http://127.0.0.1:8123
python server.py 9000                  # 自定义端口
python server.py 8123 --open           # 启动后自动打开浏览器

提示:通过 server.py 访问才能保存点位(服务端把数据写入项目文件 points.js)。 直接双击 index.html 只能查看点位,无法保存修改。 点位随项目文件夹一起分享:把整个目录拷给别人,对方打开即可看到全部点位。


🗂 地图列表

地图 面积 (km²)
艾伦格 Erangel 8 * 8
米拉玛 Miramar 8 * 8
泰戈 Taego 8 * 8
帝斯顿 Deston 8 * 8
荣都 Rondo 8 * 8
维寒迪 Vikendi 8 * 8
萨诺 Sanhok 4 * 4
帕拉莫 Paramo 3 * 3
卡拉金 Karakin 2 * 2

说明:地图素材不在本仓库

地图瓦片(tiles/)与高清源图(map/)体积大(约 650MB+,且有超过 GitHub 100MB 单文件上限的 PNG),因此未提交到本仓库(见 .gitignore)。获取瓦片方式:

  1. GitHub Releases 一键运行包(已内置全部瓦片,推荐);
  2. 自己用 python tile_gen.pymap/ 高清图重新生成 tiles/

克隆本仓库后若缺少 tiles/,页面可打开但地图为空白,属正常——请按上面任一种方式补齐瓦片。


🔐 开发者功能(密码保护)

侧栏「开发者选项」需要输入开发者密码才能进入编辑模式(密码由项目维护者保管), 代码中只保存密码的 SHA-256 加盐哈希,不存明文。

流程:解锁 → 开启「点位采集模式」→ 选择点位类型 → 左键点击地图添加 → 每次操作自动写入 points.js。 点击已有点位可删除,支持撤销 / 清空本地图。


🔁 重新生成数据

python tools/gen_data.py          # 生成 data.js(地图元数据 + 点位类型定义)
python tools/tile_gen.py          # 将 map/ 下大图切为 tiles/ 瓦片
python tools/release-pack.py      # 打「一键运行包」dist/pubg-map-toolkit-<版本>.zip(作 GitHub Release 附件)

📁 目录结构

src/ 存放全部前端源码(Web 应用根,server.py 直接伺服);开发 / 维护脚本在 tools/; 大体积地图素材(map/tiles/data/ 参考截图)不入仓库,随一键运行包一起分发:

pubg-map-toolkit/
├─ src/                  前端源码(Web 应用根)
│  ├─ index.html / app.js / styles.css
│  ├─ data.js / points.js / karakin_tunnels.js
│  └─ Icon / vendor / avatars      运行资源
├─ server.py             本地服务器(服务 src/,保存点位到 src/points.js)
├─ start_tool.bat        一键启动(Windows)
├─ map / tiles           高清源图与瓦片(大,不入仓库,见 .gitignore)
├─ tools/                开发/维护脚本
│  ├─ gen_data.py        生成 src/data.js
│  ├─ tile_gen.py        由 map/ 生成 tiles/
│  └─ release-pack.py    打一键运行包到 dist/
└─ dist/                 一键运行包输出(不入仓库)

🔗 数据来源


📄 License

LICENSE

本工具与 PUBG: Battlegrounds、PUBG Studios、Krafton Inc. 无任何隶属关系,商标与版权均归各自所有。

About

PUBG 地图工具包。迫击炮测距、密室点位、车辆/滑翔机固定/随机刷新等点位

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages