# h-lua-sdk

**Repository Path**: zhenglikun/h-lua-sdk

## Basic Information

- **Project Name**: h-lua-sdk
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2022-01-14
- **Last Updated**: 2022-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# H-Lua 魔兽地图 开发集成环境

![image](https://img.shields.io/badge/license-MIT-blue.svg)
[![image](https://img.shields.io/badge/doc-技术文档-blue.svg)](https://h-lua.hunzsig.org)
[![image](https://img.shields.io/badge/hLua-lt.alpha-orange.svg)](https://github.com/hunzsig-warcraft3/h-lua)
[![image](https://img.shields.io/badge/Author-hunzsig-red.svg)](https://www.hunzsig.com)

### 作者的话

本项目开发已进入尾声的尾声，而本人也早就在专心开发私人的东西。 所以后续将不会主动更新此项目。

所有代码开源。虽然更新那么久依然到处有需要改进的地方，我随便都能说出几十个地方。如果你对技术对贡献抱有热诚，可以PR贡献你的力量。

一切自愿为原则，强扭的瓜不甜。不要做违背自己欲望的事。

> QQ群：325338043

* [docs]技术文档 https://h-lua.hunzsig.org
* [domo]教学例子大集合 https://github.com/hunzsig-warcraft3/h-lua-sdk-demo


* [demo]你好世界 https://github.com/hunzsig-warcraft3/h-lua-sdk-demo/tree/main/地图项目/h-lua-sdk-helloworld
* [demo]秘地探奇 https://github.com/hunzsig-warcraft3/h-lua-sdk-demo/tree/main/地图项目/h-lua-sdk-mysterious-land
* [test]崩溃压力 https://github.com/hunzsig-warcraft3/h-lua-sdk-demo/tree/main/地图项目/h-lua-sdk-crash

### 结构

```
    ├── depend - 依赖的开发工具
    │   ├── h-lua - h-lua(v:latest，随sdk更新的最新版)
    │   ├── w3x2lni - w3x2lni工具(v:2.7.2)
    │   └── YDWE - 马仔工具
    ├── projects - 用来放置你的地图项目目录，如 helloworld
    |   └── helloworld
    └── sdk.exe - 编译好的开发命令工具
```

### 项目目录用来放置地图项目

> 一个正规的项目应该包括以下结构

```
    └── project_demo - 项目目录
        ├── hslk - 用来编写 hslk lua 物编配置[不建议编写业务代码]
        ├── map - 地图文件
        │   ├── resource - F12导入
        │   │   ├── hLua - h-lua需要的资源文件，请不要乱删除
        │   │   ├── ReplaceableTextures
        │   │   │   ├── Cliff - 悬崖贴图，结合TerrainArt使用，不需要可直接删除
        │   │   │   ├── CommandButtonsDisabled - 暗图标安置处
        │   │   │   └── selection - 选择圈，不需要可直接删除
        │   │   ├── TerrainArt - 地形贴图，不需要可直接删除
        │   │   ├── UI - 命令等系统图形的修改（不包括dzui）不需要可删除，然后需要修改 map/w3x/war3mapSkin.txt
        │   │   ├── war3mapImported - 通用目录
        │   │   └── war3mapMap.blp - 小地图文件，一般不会手动处理，交给 -yd
        │   ├── slk - ini物编
        │   └── w3x - 地图lni
        │       ├── UI - fdf格式UI文件存放位置，dzui相关的放在此处（可修改）
        │       ├── units
        │       │   └── CommandFunc.txt - 单位指令按钮设置，攻击、停止等（可修改）
        │       ├── fonts.ttf - 游戏字体文件（可替换，结合war3mapSkin.txt）
        │       ├── war3mapSkin.txt - 游戏界面配置（可修改）
        │       └── 其他文件，备份用，没事别乱改，易崩
        ├── scripts - lua脚本（*此乃建议，实际上你的lua只要在项目目录内，都能按路径访问）
        └── main.lua - 项目代码入口
```

> 如果你不确定项目结构的准确性，可使用new命令新建一个项目来参考

```
./h-lua-sdk> sdk.exe new [:PROJECT_NAME]
```

### 命令行

```
* 必填 ~ 选填
./h-lua-sdk> sdk.exe help  //提示cmd工具命令
./h-lua-sdk> sdk.exe new [*PROJECT_NAME]  //新建一个地图项目
./h-lua-sdk> sdk.exe we [*PROJECT_NAME]  //以YDWE打开地图项目
./h-lua-sdk> sdk.exe model [*PROJECT_NAME] [~PAGE:0|~search:'']  //以WE浏览项目模型，一页最大289个，可翻页可搜索
./h-lua-sdk> sdk.exe clear [*PROJECT_NAME]  //清理构建的临时文件
./h-lua-sdk> sdk.exe multi [*QUANTITY]  //打开N个魔兽客户端，方便多人测试
./h-lua-sdk> sdk.exe kill  //关闭所有魔兽客户端
./h-lua-sdk> sdk.exe test [*PROJECT_NAME]  //构建测试版本并开启游戏进行调试
./h-lua-sdk> sdk.exe build [*PROJECT_NAME]  //打包预上线测试版本并开启游戏进行调试
./h-lua-sdk> sdk.exe dist [*PROJECT_NAME]  //打包上线版本并开启游戏进行调试(自动slk优化)
```

### 模型命令拓展

```
./h-lua-sdk> sdk.exe model demo //查看项目demo的模型，默认第0页
./h-lua-sdk> sdk.exe model demo 2 //查看项目demo的模型，第2页
./h-lua-sdk> sdk.exe model demo ttg //查看项目demo的模型，只要路径带有ttg的
./h-lua-sdk> sdk.exe model demo abc 1  //查看项目demo的模型，第1页且只要路径带有abc的
```