Welcome to the home of the Heroes of Might and Magic III H3API headers and plugins made using them. This repository will also be used to distribute the SoD_SP plugin which is coded using the same headers.
H3.LodTable
Modifies the LOD tables to provide room for additional LOD or PAC archives. By default, all folders of active HDmod plugins are browsed to add .pac or .lod game archives. You may also add archives from your own folders by using the HDmod variables created by the plugin. Included with SoD_SP.
H3.TextColor
Adds over 100 colors to game text using a simple tag {~color}your text here}. Included with SoD_SP.
H3.Battlefields
Adds custom battlefield backgrounds when fighting on the adventure map. Requires H3.LodTable plugin.
SoD_SP
Description is currently only available here.
Releases are available here.
A release for the headers might be updated from time to time, however your best bet is to clone them directly. In order to use the headers, add them to a folder of your choice and then add this line to your project:
#include "{...relativepath...}/H3API.h"
The H3API headers were successfully tested using the 2013, 2015 and 2017 versions of MSVC. You may freely use and distribute the headers, however it would be nice of you to leave the disclaimers intact.
All necessary files for building using Visual Studio are available in the repository. Upon cloning the directory, you should be able to build the included projects yourself. The one exception being the very next topic...
In the spirit of transparency and contributing to the Heroes 3 modding community, I am releasing portions of the SoD_SP source code. You will not be able to build it with the released files and you will most likely see missing files, definitions and functions when inspecting them.
So why not all of the code?
SoD_SP is still an ongoing project and I would like to maintain control on some of its aspects. Over time, more should be made public and existing code will be updated periodically.
Can I use the available code?
The released code may be freely used in your own plugins, although beware the potential conflicts with SoD_SP.
What about using non-public code?
You can always try to make your case and convince me to make these public, or to release them in a separate plugin - similar to H3.TextColor or H3.LodTable which were originally meant to be a part of SoD_SP. Keep in mind that SoD_SP is specifically intended to be available as a single player plugin only and some elements may not be able to be similarly separated.
Got issues? Suggestions? Head over to the Issues tab and let them be known.
This software is not in any way official and is not endorsed by anyone. Heroes, Might and Magic, Heroes of Might and Magic, Ubisoft and the Ubisoft logo are trademarks of Ubisoft Entertainment in the U.S. and/or other countries.