Welcome to H3Plugins, a collection of plugins for Heroes of Might and Magic III built using the H3API library. H3API library has moved to a separate repository which can be found here. Although there is an H3API project distributed with the included solution, it may lag in being updated so it is recommended to pull the library from its home repository.
This repository will also be used to distribute the SoD_SP plugin which is coded using the same library.
H3.AssetLoader
Loads WAV, PCX, DEF from specified path directly into h3's asset manager.
H3.Battlefields
Adds custom battlefield backgrounds when fighting on the adventure map. Requires H3.LodTable plugin.
H3.CombatAnimation
Cycles through combat creatures' standing animation frames instead of being idle. Included with SoD_SP.
H3.DataLoader
Loads any .def or .msk file from \Data\ folder, the same way as PCX, WAV or TXT files are normally read from there.
H3.DisableHWrules
Disables all hooks set by HWrules plugin which can have undesirable effects in single player with no way to turn it off.
H3.DoubleClickShowcase
Boilerplate code to show how one could detect double-clicks in H3.
H3.ImageLoader
Loads image from given directory as H3LoadedPcx16*. Supported formats: JPG, PNG, TGA, BMP, PSD, GIF, HDR, PIC thanks to stb_image
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.QwertzLayout
Changes InputManager's keyboard layout to QWERTZ instead of QWERTY.
H3.RMGDescription
Allows customization/locatization of randomly created map's scenario information.
H3.ShiftToggle
When the Shift key is held on the adventure map, the active hero ignores any left mouse clicks.
H3.TextColor
Adds over 100 colors to game text using a simple tag {~color}your text here}. Included with SoD_SP.
SoD_SP
Description is currently only available here.
Releases are available here.
A release for the library's contents might be updated from time to time, however your best bet is to clone the solution directly. See here for more information on using H3API.
The H3API headers were successfully tested using the 2008, 2013, 2015, 2017 and 2019 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.
Almost every option in SoD_SP can be modified to users' taste. While in game, press F12 to see the list of options that can modified; these can be toggled or saved to the external ini options in SoD_SP.ini. This ini file will be installed in the same folder as SoD_SP if you wish to modify it by hand, all of its options have descriptions to indicate what is affected by it. The [language] and [other] sections of the ini may only be modified manually and require a game restart to take effect.
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.