Warcraft 3 documentation

vJASS & Zinc Documentation
For the latest documentation about how it works vJASS and Zinc language layers for Warcraft III, please follow these links:
Jasshelper documentation - Zinc documentation - WC3 Optimizer documentation

Recent Posts

1
Tutorial Zone / Re: Blz Native Documentation
« Last post by moyack on May 05, 2019, 10:41:08 PM »
Thanks @Darklycan51 for the doc :)

Right now I'm planning a way to update the site with the latest common.j so we can fill the wiki with current information.
2
Tutorial Zone / Blz Native Documentation
« Last post by Darklycan51 on May 02, 2019, 08:05:03 PM »
I started this document due to 1.31 coming with tons of undocumented natives, it has a decent amount of natives with at least somewhat of an understandable explanation to them, I was initially planning to just have 1.31 natives but then decided to include ALL Blz natives due to most of the old ones also being undocumented until now, outside of the helpfulness of the resource, having extra man power in testing natives and documenting them would be helpful too.

The link to the resource is:
https://docs.google.com/document/d/1AjAScGNEgT8puu5rn0rdeTr2TWxSz3BIlWdcfDCUoLA/edit
3
Tutorial Zone / Re: How to import music/sounds in newer patches
« Last post by Darklycan51 on February 24, 2019, 12:04:06 PM »
Alright, I did, thanks
4
Tutorial Zone / Re: How to import music/sounds in newer patches
« Last post by moyack on February 24, 2019, 11:19:01 AM »
Hi @Darklycan51 !!!

Very complete tutorial. If you want to make one of this images to be the main one for this tutorial, just upload it as attachment in the first post and it will be the preview when you share it on other sites like facebook or Discord :)
5
Tutorial Zone / How to import music/sounds in newer patches
« Last post by Darklycan51 on February 24, 2019, 09:22:53 AM »
Category: Miscellaneous Tutorials
« Created: February 24, 2019, 09:22:54 AM by Darklycan51 »
« Last Edit: February 25, 2019, 08:07:44 AM by Darklycan51 »
Hello fellow wc3 modders, today I will bring you a tutorial for something that is very widely used and has been changed as of recently. Making music and sounds work in your map, yes, as of recently Blizzard has changed which sounds and music work in Warcraft 3, due to that, you are now required to have the files in specific format which Blizzard mp3s use.

This also serves as a tutorial to optimize the music in your map in case this got reverted, because a 320kbps MP3 can go above 10mb even if it is less than 10 minutes, however in this format it will most likely be 1/3rd of the original size, saving you tons of space.

Step 1)
Download and install audacity from here:
https://www.audacityteam.org/download/
Step 2)
Install it and Run It


Alright now that we are at our main screen, you will be asked for a DLL once you try to convert music, when you get asked for it, you will have to choose a path to select the DLL in your computer, the DLL can be downloaded from:
https://lame.buanzo.org/#lamewindl



Once you downloaded the DLL, just place it on an easy to access folder and once you are prompted for the missing DLL you just select it.

Alright, let's continue with the tutorial.
 First open preferences for Audacity:

 Then set both the default sample rate and default sample format to the following values:


After that you will open your desired input (original) music/sound:


As you can see to the left of the track you can see the current settings of the music/sound, still aren't at our desired Output format that Warcraft 3 supports. So we will resample the music/sound:


For the new sample rate, select 22050:



Now you should be done with almost everything except the bit-rate, for this we will click on export -> export MP3:

Inside export MP3 you will select the following settings:



And lastly you just click save where you want the converted and optimized MP3 to be at so you can import it to your map.
 :)


(By the way, I prefer mp3s for music, however for sounds instead of exporting as MP3 select export as WAV)
6
Tutorial Zone / Custom Movie Tutorial (patch 1.30.1+)
« Last post by Tommi Gustafsson on November 14, 2018, 10:13:10 PM »
Category: Miscellaneous Tutorials
« Created: February 24, 2019, 05:09:55 PM by moyack »
Warcraft III has capability of playing movies similar to Blizzard's intro and ending movies. However, you need to know to what format to encode your movie that it works in the game. The video format changed with the patch 1.30, and a working support for custom movies was added in patch 1.30.1.

Warcraft III Movie Resolution and Frame Rate
By default, Warcraft III supports movies with a maximum width of 800 pixels. Therefore, a 16:9 movie will be 800x450 pixels in size. Blizzard used about 24 frames per second in their movies, but in this tutorial we will encode them with 25 frames per second. We also found that using about 25 fps for the movie helps it to play correctly with low-end computers, which might have performance problems decoding higher frame rate movies.

Preparing Your Movie
You can create your movie in any video editing software and then export it to MP4 or similar common format. It can be in any resolution and frame rate as long as it is at least 800x450 @ 25 fps. For the Gnoll Campaign intro movie, we used Final Cut Pro X and exported it to 1920x1080 @ 50 fps MP4. It was also the format we uploaded it to YouTube.

Encoding Your Movie for Warcraft III 1.30 and later
Warcraft III 1.30 uses a very specific format for movies. You also need to encode video stream and audio stream separately.

Encoding Video Stream
You need to encode the video stream into VP9 AVI using the Constant Quality (CQ) mode. You can do this using the FFMPEG command line tool. This is how you do it:

Code: [Select]
ffmpeg -i "Your Source Movie.mp4" -c:v libvpx-vp9 -crf 30 -b:v 0 -s 800x450 -r 25 -an WC3Movie.avi
-c:v libvpx-vp9 makes FFMPEG to use the VP9 codec.
-crf 30 determines the quality. We found that 30 was quite good.
-b:v 0 must be 0 to enable the CQ mode.
-s 800x450 scales the video down to 800x450.
-r 25 set the frame rate to 25.
-an removes the audio track.

The end result is WC3Movie.avi, which is a VP9 CQ AVI file. It can have any name, but the extension must be avi.

Encoding Audio Stream
The audio stream needs to be encoded to MP3. You can do it also with FFMPEG.

Code: [Select]
ffmpeg -i "Your Source Movie.mp4" -c:a libmp3lame -b:a 128k -vn WC3Movie.mp3
-c:a libmp3lame makes FFMPEG to encode using the MP3 codec.
-b:a 128k sets the bitrate to 128 kbps.
-vn removes the video stream.

The end result is WC3Movie.mp3. It must have the same name as the video stream file, except the extension is mp3.

Importing the Encoded Files to Warcraft III
When you have the files ready, you need to import them to Warcraft III. In campaigns, you can import them using the campaign import manager (F7). After importing, you need to change their paths to

Movies\WC3Movie.avi
Movies\Audio\WC3Movie.mp3

Creating a Movie Map to Campaign
The next step is to create a separate movie map to your campaign. You need to create some triggers and import a few files. The purpose of the files is to remove all useless user interface and make the screen look totally black. The triggers are used to do the same and finally play the movie.

You can find an example one in our Gnoll Campaign. Download it (version C1R5 or later) and open it in the World Editor using the Campaign Editor (F7). Export the CinematicIntro.w3x map or open it through the Edit Map command. You will see that the triggers look like this:



You can see here that

  • Game music is first stopped.
  • Game screen is made black with the Black Mask.
  • Letter Box Mode is used to remove the user interface (letter box mode graphics are removed by imports).
  • Custom Script "call PlayCinematic" is used to play the movie at the end of the map. In the Gnoll Campaign, the movie is named GCIntro. If you used WC3Movie, then you need to use it also here.
  • Wait 0.00 seconds is needed or things do not work.
  • Next level is set to Chapter 1.
  • The game is finished immediately, skipping dialogs and scores.


Now the movie will play immediately on startup and the game will automatically move to the next chapter after the movie.

You can import CinematicIntro.w3x into your campaign or create a similar one. You need to change the loading screen, though.

Playing the Movie
You can now play the movie by clicking its button in the campaign main screen.

Playback Problems
Movies may not work on Windows 7. They have been tested to work on Windows 10 and macOS High Sierra.
7
Tutorial Zone / Re: How to [download | install | configure] JNGP
« Last post by moyack on October 01, 2017, 10:58:39 PM »
Thanks for the guide! I'm looking forward to trying out JNGP.
You're welcome :D
8
Tutorial Zone / Re: How to [download | install | configure] JNGP
« Last post by Chaisson on October 01, 2017, 09:22:43 AM »
Updated the tutorial to fits with the latest changes to and packing configurations.

Thanks for the guide! I'm looking forward to trying out JNGP.
9
Tutorial Zone / Warcraft III Cheats
« Last post by moyack on September 17, 2017, 05:02:15 PM »
Category: Miscellaneous Tutorials
« Created: September 17, 2017, 05:02:15 PM by moyack »
Warcraft III Cheats
Compiled by Moyack

Why cheat? what's the reason of promoting this in WC3?? well, in the mapping or modding process using the World editor, it's necessary to have agile ways to test stuff, and the cheats allow this process. This cheats works only on singleplayer mode and they're blocked in online gaming, for obvious reasons.

  • allyourbasearebelongtous: Instant win
  • greedisgood: Get 500 wood and gold
  • iseedeadpeople: Full map
  • somebodysetusupthebomb: Instant failure
  • thereisnospoon: Infinite Mana
  • whosyourdaddy: Invincibility, one-hit kills
  • motherland (race) (#) - Level select
  • strengthandhonor: Keep playing after losing in campaign mode
  • greedisgood (#): # of gold and lumber
  • keysersoze (#): # of gold
  • leafittome (#): # of lumber
  • iocainepowder: Fast death
  • pointbreak: Build over food limit
  • whoisjohngalt: Fast research
  • sharpandshiny: All upgrades
  • synergy: Tech tree unlocked
  • riseandshine: Set time to morning
  • lightsout: Set time to evening
  • daylightsavings (time): Set time of day
  • itvexesme: Disable victory conditions
  • thedudeabides: Fast spell cooldown
  • daylightsavings: Day/night transitions
  • warpten: Fast build
10
Tutorial Zone / Re: The AI editor
« Last post by guest3545 on September 12, 2017, 01:28:40 AM »
This tutorial is about the different parts of the .wai AI editor, how to configure the conditions, the condition explaination. and also it will give a explaination about the functions. (How I'm going to write it is by the left)

Thanks for the tutorial!
Vivir aprendiendo.co - A place for learning stuff, in Spanish   Chaos Realm - The world of Game modders and wc3 addicts   Diplo, a gaming community   Power of Corruption, an altered melee featuring Naga and Demon. Play it now!!!   WC3JASS.com - The JASS Vault + vJASS and Zinc   Jetcraft - A Starcraft II mod   WormTastic Clan (wTc)