# h-vjass

**Repository Path**: iceidolon/h-vjass

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2020-08-02
- **Last Updated**: 2026-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### GUIDE 引导
 * [Github](https://github.com/hunzsig-warcraft3/h-vjass)
 * [Demo：时空之轮TD](https://github.com/hunzsig-warcraft3/w3x-hyper-space-td)
 * [h-vjass技术文档](http://hvjass.book.hunzsig.org)
 * Author hunzsig

### INTRODUCE 介绍

> h-vjass拥有优秀的demo，在开源的同时引导您学习的更多。
此框架完全独立，不依赖任何游戏平台和插件（如JAPI、DzApi）
拥有强大的属性系统，可以轻松做出平时难以甚至不能做出的地图效果
内置多达50种以上的自定义事件，轻松实现神奇的主动和被动效果
更有物品合成、拆分，丰富的自定义技能模板！

> h-vjass has excellent demo, which guides you to learn more while opening up.
This framework is completely independent and independent of any game platform and plug-ins (such as japi, dzapi)
With a powerful attribute system, you can easily make map effects that are difficult or even impossible to make at ordinary times
More than 50 kinds of custom events are built in, enabling magical active and passive effects easily
More items synthesis, split, rich custom skill template!


### STRUCTURE 结构
```
    ├── h-vjass.j - 入口文件，你的main文件需要包含它
    ├── hSync.j - 同步方法，处理无法暂停的功能（结构体内不得暂停）
    ├── hMain.j - 一个简单例子，在F4中include这个main文件。而main需要包含h-vjass.j
    ├── hTest.j - 测试代码之一
    ├── demo.w3x - *仅供参考，最好直接拿 “ 实践时空之轮TD ” 二次开发
    └── lib
        ├── abstract - 加载其他功能模块
        ├── ability - 基础技能
        ├── attrbuteIds - 基础属性用到的物编技能ID
        ├── attrbute - 基础/拓展属性系统，攻击护甲移动暴击韧性等
        ├── attrbuteEffect - 伤害特效属性系统
        ├── attrbuteNatural - 自然属性系统
        ├── attrbuteHunt - 伤害系统
        ├── attrbuteUnit - 单位与属性系统关联模块
        ├── award - 奖励模块，用于控制玩家的黄金木头经验
        ├── camera - 镜头模块，用于控制玩家镜头
        ├── console - 简单调试打印模块
        ├── dzapi - 一个重构dzapi的例子，实际上你可以直接调用Dz无需重构
        ├── effect - 特效模块
        ├── effectString - 一些常用不错的特效串（可以直接在effect中使用字符串而忽略这个）
        ├── enemy - 敌人模块，用于设定敌人玩家，自动分配单位
        ├── env - 环境模块，可随机为区域生成装饰物及地表纹理
        ├── event - 事件模块，自定义事件，包括物品合成分拆/暴击，精确攻击捕捉等
        ├── filter - 组过滤器，主要用于单位组条件
        ├── group - 单位组
        ├── hero - 英雄/选英雄模块，包含点击/酒馆选择，repick/random功能等
        ├── is - 判断模块 * 常用
        ├── item - 物品模块，与属性系统无缝结合，合成/分拆等功能
        ├── itemMix - 物品合成子模块
        ├── lightning - 闪电链
        ├── logic - 逻辑模块
        ├── mark - 遮罩模块
        ├── media - 声音模块
        ├── message - 消息/漂浮字模块
        ├── multiboard - 多面板，包含自带的属性系统
        ├── player - 玩家
        ├── rect - 区域
        ├── skill - 高级技能
        ├── time - 时间/计时器 * 常用
        ├── unit - 单位
        └── weather - 天气
```

### TIPS 敬告

> 本套代码免费提供给了解Jass/vJass的作者试用，如果不了解Jass/vJass请使用T来制作地图或自行学习，此处不提供jass教学
当然即使你完全不懂jass也可以去 [vJass教程](https://github.com/hunzsig-warcraft3/help-learn/tree/master/vJass%E7%B3%BB%E5%88%97%E6%95%99%E7%A8%8B) 学习

> This set of code is free for authors who know about jass / vjass to try. If you don't know about jass / vjass, please use t to make maps or learn by yourself. Jass teaching is not provided here.
By the way, even if you don't know jass at all, you can go to [vjass tutorial]（ https://github.com/hunzsig-warcraft3/help-learn/tree/master/vJass%E7%B3%BB%E5%88%97%E6%95%99%E7%A8%8B ）Learning vjass language.
  
---

#### *For example with YDWE , 引导以YDWE为例*

---

### READY 前期准备

> 关闭YDWE的“逆天”触发。
如果报错，请注意除了jass编译器其他无谓的优化不要打开，
会使得某些原生方法胡乱添加YDWE前缀

> Turn off the "NI TIAN" trigger of YDWE.
If an error is reported, please note that other useless optimizations other than the jass compiler should not be turned on,
It will cause some native methods to randomly add prefix codes.

### QUICK START 快速接入

> 打开YDWE 打开地图 按F4打开触发编辑器
在最上方第一的位置添加一个【新触发】
选中新建的触发点击菜单【编辑】将他转为自定义文本，如下：

> Open ydve open map press F4 to open Trigger Editor.
Add a [new trigger] at the top first position.
Select the new trigger menu and click Edit to change it to user-defined text, as follows.

```
function Trig_[YOUR_TRIGGER]_Actions takes nothing returns nothing
endfunction

//===========================================================================
function InitTrig_[YOUR_TRIGGER] takes nothing returns nothing
set gg_trg_[YOUR_TRIGGER] = CreateTrigger(  )
call TriggerAddAction( gg_trg_[YOUR_TRIGGER], function Trig_[YOUR_TRIGGER]_Actions )
endfunction
```

> 这些默认的function都是没有用的，将他们全部删除，留下一个[空白的文本区]
在文本区顶部 **include** h-vjass的根目录文件h-vjass.j,注意相对路径要正确，以你的【YDWE.exe】相对的目录为准(不建议路径存在有中文)。
如果此时你已经完成上述步骤，那么文本区内现在应该是这样的：

>These default function are useless, delete them all, leave a [blank text area]
At the top of the text area * include * h-vjass root directory file h-vjass.j, note that the relative path should be correct.
If you have completed the above steps at this time, the text area should now look like this:

```
include "[RELATIVELY_PATH]/h-vjass/h-vjass.j"
```

> **保存地图查看是否出错，如果没有出错则h-vjass库添加成功,
以上仅为添加v-vjass，而在制作地图的实践中，你应该是建立自己的main文件来引用v-vjass（如可参考目录中的hMain.j）
那么文本区内现在应该改为这样的：**

> Save the map to see if there has any error. If there is no error, the h-vjass library is added successfully.
The above is just to add v-vjass. In the practice of map making, you should build your own main file to reference v-vjass (for example, refer to the hMain.j)
So the text area should now read as follows:

```
include "[RELATIVELY_PATH]/h-vjass/hMain.j"
```