传奇世界H5单机版本质是基于浏览器运行的HTML5游戏，其逻辑由JavaScript控制，资源通过JSON或XML配置。与传统Mir2服务端不同，H5版无M2、QFunction等文件，需通过修改前端代码实现功能调整。
一、核心文件结构说明
解压H5单机包后常见目录：
js/：存放游戏逻辑脚本，如player.js（角色）、map.js（地图）、item.js（物品）；
data/：包含配置文件，如items.json（物品数据库）、npcs.json（NPC数据）、skills.json（技能参数）；
res/：图片、音频等资源文件；
index.html：游戏主入口，加载所有JS和CSS。
二、物品添加方法
在data/items.json中按格式新增条目：
{
"id": 1001,
"name": "雷霆之刃",
"type": "weapon",
"attack": 80,
"levelReq": 35,
"img": "res/item/1001.png"
}
ID必须唯一，type决定装备位置（weapon/armor/helmet等），img路径需对应实际资源。
三、NPC对话与功能绑定
在data/npcs.json定义NPC行为：
{
"id": 201,
"name": "武器商人",
"x": 120,
"y": 95,
"mapId": 1,
"dialog": "需要什么武器？购买屠龙（500元宝）"
}
点击链接会调用js/player.js中的buySword函数，需在该函数内编写扣元宝、给物品逻辑。
四、关键函数编写示例
在js/player.js末尾添加自定义功能：
function buySword() {
if (player.gold >= 500) {
player.gold -= 500;
addItem(1001); // 调用已有addItem函数，参数为物品ID
showMsg("购买成功！");
} else {
showMsg("元宝不足！");
}
}
addItem、showMsg等函数通常已在基础框架中定义，勿重复声明。
五、地图与传送设置
地图信息存于data/maps.json，每张地图为独立对象：
{
"id": 3,
"name": "祖玛寺庙",
"width": 200,
"height": 200,
"tileset": "res/map/zuma.png",
"teleports": [
{"x":190,"y":100,"targetMap":4,"tx":50,"ty":60}
]
}
teleports定义传送点，角色走到(x,y)自动跳转至targetMap的(tx,ty)。
六、本地存储与调试
玩家数据默认保存在浏览器localStorage中，可通过F12开发者工具→Application→Local Storage查看。清空数据可重置角色。修改JS后需强制刷新（Ctrl+F5）避免缓存干扰。
七、常见问题处理
页面空白：检查js文件路径是否正确，控制台是否有404错误；
功能无效：确认函数名拼写一致，括号和引号使用英文符号；
图片不显示：确保res路径下存在对应PNG文件，且大小符合地图块规格（通常32x32或48x48）；
移动卡顿：降低maps.json中地图宽高值，或减少同屏怪物数量。
H5单机版无需编译，直接编辑文本文件即可生效。建议使用VS Code等编辑器，开启JSON语法校验避免格式错误。所有修改均在本地运行，不涉及服务器部署。
