6056d385ed
This should fix rather common problem with mods, where two unrelated mods accidentally use same file name for a config file, leading to very unclear conflict since this result in a file override. Now all config files referenced in mod.json are loaded specifically from filesystem of mod that referenced it. In other words, it is no longer possible for one mod to override config from another mod. As a side effect, this allows mods to use shorter directory layout, e.g. `config/modName/xxx.json` can now be safely replaced with `config/ xxx.json` without fear of broken mod if there is another mod with same path to config. Similarly, now all mods can use `config/translation/ language.json` scheme for translation files Since this is no longer a problem, I've also simplified directory layout of our built-in 'vcmi' mod, by moving all files from `config/vcmi` directory directly to `config` directory. - Overrides for miscellaneous configs like mainmenu.json should works as before - Images / animations (png's or def's) work as before (and may still result in confict) - Rebalance mods work as before and can modify another mod via standard `modName:objectName` syntax |
||
|---|---|---|
| .github | ||
| AI | ||
| android | ||
| CI | ||
| client | ||
| clientapp | ||
| cmake_modules | ||
| config | ||
| debian | ||
| docs | ||
| include | ||
| ios | ||
| launcher | ||
| lib | ||
| lobby | ||
| mapeditor | ||
| Mods/vcmi | ||
| osx | ||
| rpm | ||
| scripting | ||
| scripts/lib | ||
| server | ||
| serverapp | ||
| test | ||
| vcmiqt | ||
| win | ||
| xcode | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .travis.yml | ||
| AUTHORS.h | ||
| CCallback.cpp | ||
| CCallback.h | ||
| ChangeLog.md | ||
| CMakeLists.txt | ||
| CMakePresets.json | ||
| conanfile.py | ||
| fuzzylite.pc.in | ||
| Global.h | ||
| license.txt | ||
| vcmibuilder | ||
| Version.cpp.in | ||
| Version.h | ||
VCMI Project
VCMI is an open-source recreation of Heroes of Might & Magic III engine, giving it new and extended possibilities.
Links
- Homepage: https://vcmi.eu/
- Forums: https://forum.vcmi.eu/
- Bugtracker: https://github.com/vcmi/vcmi/issues
- Discord: https://discord.gg/chBT42V
- GPT Store: https://chat.openai.com/g/g-1kNhX0mlO-vcmi-assistant
Latest release
Latest release can be found in Github Releases page. As of right now we plan to have major releases around 3 times per year. Daily builds are still available at builds.vcmi.download but they are not guaranteed to be stable. So we encourage everybody to use them and report found bugs so that we can fix them. Loading saves made with different major version of VCMI is usually not supported, so you may want to finish your ongoing games before updating. Please see corresponding installation guide articles for details for your platform.
Installation guides
Documentation and guidelines for players
- Frequently asked questions (external link)
- Game mechanics
- Bug reporting guidelines
- Cheat codes
- Privacy Policy
Documentation and guidelines for translators
Documentation and guidelines for game modders
Documentation and guidelines for developers
Development environment setup instructions:
- Building VCMI for Android
- Building VCMI for iOS
- Building VCMI for Linux
- Building VCMI for macOS
- Building VCMI for Windows
- Conan
Engine documentation: (NOTE: may be outdated)
- Development with Qt Creator
- Coding Guidelines
- Bonus System
- Code Structure
- Logging API
- Lua Scripting System
- Serialization
Documentation and guidelines for maintainers
Copyright and license
VCMI Project source code is licensed under GPL version 2 or later. VCMI Project assets are licensed under CC-BY-SA 4.0. Assets sources and information about contributors are available under following link: https://github.com/vcmi/vcmi-assets
Copyright (C) 2007-2024 VCMI Team (check AUTHORS file for the contributors list)