Home

This is a set of libraries designed to assist in the WarCraft 3 mapmaking using C#. For actual compiling and running of a WarCraft 3 map using C#, please refer to the information found in this thread. There is also a quick setup that I use myself that you can find here.

Development

Much of the development on these libraries is currently motivated courtesy of Lord Damage, responsible for various maps such as Desert Smite, Fort Wars and Assault The Throne. The systems used to run these maps is designed by myself, while Lord Damage tends to do most of the map work.

Because of this, I expect some users to be less familiar C# and even programming in general, and try to keep this wiki and the WCSharp systems straightforward to use. Suggestions to improve the understandability are much appreciated.

How do I get started?

For mapmakers who are new to C#, this wiki provides a WCSharp template that requires minimal to no setup and comes with all WCSharp packages installed.

How do I use these libraries/packages?

If you do not have the packages installed yet, you can simply right-click your Source project, or however you named the project containing the code that Warcraft III should execute, and select "Manage NuGet packages". In here, select "Browse" and type in WCSharp to find all available WCSharp packages. Important: The package listed as only "WCSharp" is the deprecated all-in-one package. Although you are free to use this package, it is no longer supported will not work with War3Net 5.x or higher.

Thanks to the power of NuGet, dependencies are automatically resolved (e.g. WCSharp.SaveLoad depends on WCSharp.Sync and WCSharp.JsonConvert), meaning that you don't have to worry about that.

No further installation is required, as the systems will automatically self-initialise the moment you try to use them. The only exception to this is the dummy system, as this depends on a dummy unit being defined in your map. For more information on this, please see the WCSharp.Dummies documentation.

Aside from that, please refer to the individual wiki pages on how to use each system. In addition to the wiki pages, the systems have extensive documentation via IntelliSense within Visual Studio, allowing you to select/hover over methods, properties and even classes to learn more.