感謝小伙伴“月夜星歌”的分享！

vJassGo 是一個(gè)專為魔獸爭(zhēng)霸 vJass/JASS 開(kāi)發(fā)的 VS Code 擴(kuò)展，提供完整的開(kāi)發(fā)、編譯、調(diào)試和發(fā)布工具鏈。

下載地址：vJassGo

QQ群：206306788

快速開(kāi)始

創(chuàng)建項(xiàng)目：CTRL+SHIFT+P輸入vj.new

• 會(huì)提示你輸入地圖名字(名字將保存在.vjass.config.json)

• 首次使用會(huì)需要你選擇你的WE路徑

目錄解析：

MyMap/                       # 項(xiàng)目根目錄
├── .vjass.config.json       # 項(xiàng)目配置文件
├── build/                   # 編譯輸出目錄
│   ├── MyMap_slk.w3x        # 測(cè)試版地圖
│   └── MyMap_slk.crypt.w3x  # 發(fā)布版地圖
├── lni/                     # 地圖源文件
├── script/                  # 代碼文件夾
│   ├── jass/                # vJass/JASS 源碼
│   │   ├── main.j           # 主代碼文件
│   │   └── data/            # xlsx生成的數(shù)據(jù)
│   ├── fdf/                 # FDF 界面文件
│   └── lua/                 # Lua 腳本文件
└── meta/                    # 元數(shù)據(jù)文件夾
    ├── xlsx/                # Excel 數(shù)據(jù)表
    └── toblp/               # 待轉(zhuǎn)換圖片

地圖打包

測(cè)試啟動(dòng)：按 F5 自動(dòng)編譯地圖并啟動(dòng) war3

• 需光標(biāo)置入 .lua、.jass 或 .fdf 文件內(nèi)

• 打包后的地圖位于build\

• 當(dāng)你的vjass代碼有錯(cuò)誤時(shí)，會(huì)輸出jasshelper或pjass給出的報(bào)錯(cuò)且打包行為會(huì)中斷

• 當(dāng)你使用WE中的測(cè)試地圖功能，vjass代碼將不會(huì)生效

• 建議除地形基礎(chǔ)物體外一切都在vscode制作，舍棄WE

自動(dòng)加載：script\jass\ 文件夾下所有 .j、.jass 都會(huì)被正確的編譯進(jìn)地圖

• 不再需要手動(dòng) //!import 或者 #include（或許你習(xí)慣 cjass？這里將不再支持）

• 如果你想使用原生 jass 來(lái)制作游戲，這估計(jì)需要你使用 vjass 庫(kù)名排序文件加載順序， 該情況并不建議你使用本框架，因?yàn)檫@是服務(wù)于 vjass 的

• 加密發(fā)布：按 F9 自動(dòng)化打包地圖為可發(fā)布版本

使用該功能必須要有 AutoHotkey，并且使用 KKWE

• 打包后的地圖位于build\

• 代碼共存：在 WE 里初始化的任何數(shù)據(jù)都將會(huì)生效，即使你使用 GUI 觸發(fā)器（但不建議混用）

打包地圖后你的 .j 文件并不會(huì)受到影響，但腳本會(huì)以另一種方式寫入地圖，你只需要專注于編寫 script\ 文件夾的代碼

• 例如可以做到在WE編輯器放置區(qū)域，使用vjass調(diào)用gg_rct_name

• FDF代碼：script\fdf\ 該文件夾下的所有 fdf 文件將會(huì)直接生效

表格結(jié)構(gòu)

• 表格加載：meta\xlsx\該目錄下的所有表格都會(huì)被轉(zhuǎn)換為結(jié)構(gòu)體，

• 實(shí)例表格：

你不需要定義 .toc 以及任何操作，你可以自由的編寫 fdf 然后在 jass 里創(chuàng)建，例如 DzCreateFrame("fdf定義的frame名稱")

使用 fdf 的 IncludeFile 功能時(shí)，路徑根目錄為 fdf\

Lua代碼：script\lua\，與fdf相同，將會(huì)自動(dòng)寫入地圖

• 如上表格所示，假設(shè)已放入xlsx文件夾中，那么你就可以在vjass中調(diào)用這些數(shù)據(jù)。

• 第一行為成員注釋

• 第二行為成員類型

• 第三行為變量名稱

• 往后每一行都是實(shí)例

// 正確使用代碼示例
function testXlsx1 takes nothing returns nothing
    local Boss b1 = Boss.get('bsid') // 表格內(nèi)整數(shù)參數(shù)填寫四字id將自動(dòng)轉(zhuǎn)換為魔獸的整數(shù)id
    local Boss b2 = Boss.get(StringHash("山丘")) // 表格內(nèi)字符串參數(shù)填寫名稱將自動(dòng)轉(zhuǎn)換為字符串hash
    local Boss b3 = Boss[1] // 表格內(nèi)數(shù)據(jù)行從1開(kāi)始索引
    local Boss b4 = Boss[2] 
    local Boss b5 = Boss(1)
    local Boss b6 = Boss(2)
    call BJDebugMsg(b1.name) // 輸出：基爾加丹
    call BJDebugMsg(b2.name) // 輸出：山丘之王
    call BJDebugMsg(b1.art) // 輸出：icon\\bsid.blp (path類型自動(dòng)轉(zhuǎn)譯路徑)
    call BJDebugMsg(I2S(b1.index)) // 輸出：1
    call BJDebugMsg(I2S(b2.instanceId)) // 輸出:等價(jià)于StringHash("山丘")
endfunction
// 錯(cuò)誤使用代碼示例
function testXlsx2 takes nothing returns nothing
    local Boss b1 = Boss.get("~") // 該實(shí)例將是0，"~"會(huì)使該行數(shù)據(jù)都為注釋，所以并不是key
    local Boss b2 = Boss[3] // 該實(shí)例將是0，因?yàn)楸砀裰械诙惺亲⑨屝校缘谌袛?shù)據(jù)的index為2
    local Boss b3 = Boss(2)
    call BJDebugMsg(b3.mark) // 這將報(bào)錯(cuò)，因?yàn)閙ark列是注釋列
endfunction

類型格式對(duì)照：

• 同樣也支持?jǐn)?shù)組

• 變量名填寫varName[]即可。

忽略表格：

• 如果你不想生成結(jié)構(gòu)體但又需要數(shù)據(jù)，只需要在工作表的名稱上加一個(gè)"!"，例如!Hero，那么這個(gè)Hero表將不會(huì)生成對(duì)應(yīng)的結(jié)構(gòu)體，但你需要手動(dòng)自己編寫一個(gè)。

• 被忽略的表格中的數(shù)據(jù)依舊會(huì)被寫進(jìn)對(duì)應(yīng)的結(jié)構(gòu)體。

BLP轉(zhuǎn)換

1. meta\toblp\ 該文件夾下的所有blp、tga、png、bmp、jpg都能被轉(zhuǎn)換為blp

2. CTRL+SHIFT+P輸入vj.blp vJassGo Logo

3. 完成后會(huì)彈出轉(zhuǎn)換后的路徑，已自動(dòng)幫你放入對(duì)應(yīng)路徑

4. .vjass.config.json中可以配置邊框以及是否添加黑色背景

致謝

感謝魔獸爭(zhēng)霸地圖開(kāi)發(fā)社區(qū)的支持，以下開(kāi)源項(xiàng)目：

• JassHelper - vJass 編譯器

• w3x2lni - 地圖轉(zhuǎn)換工具

• YDWE - 魔獸地圖編輯器

以及部分思路提供者：

• 龐各莊大棚

• 不追夢(mèng)的小安

讓 vJass 開(kāi)發(fā)更簡(jiǎn)單、更高效！