CModHandler.cpp 37 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159
  1. /*
  2. * CModHandler.cpp, part of VCMI engine
  3. *
  4. * Authors: listed in file AUTHORS in main folder
  5. *
  6. * License: GNU General Public License v2.0 or later
  7. * Full text of license available in license.txt file, in main folder
  8. *
  9. */
  10. #include "StdInc.h"
  11. #include "CModHandler.h"
  12. #include "mapObjects/CObjectClassesHandler.h"
  13. #include "filesystem/FileStream.h"
  14. #include "filesystem/AdapterLoaders.h"
  15. #include "filesystem/CFilesystemLoader.h"
  16. #include "CCreatureHandler.h"
  17. #include "CArtHandler.h"
  18. #include "CTownHandler.h"
  19. #include "CHeroHandler.h"
  20. #include "mapObjects/CObjectHandler.h"
  21. #include "StringConstants.h"
  22. #include "CStopWatch.h"
  23. #include "IHandlerBase.h"
  24. #include "spells/CSpellHandler.h"
  25. #include "CSkillHandler.h"
  26. #include "ScriptHandler.h"
  27. #include "BattleFieldHandler.h"
  28. #include "ObstacleHandler.h"
  29. #include <vstd/StringUtils.h>
  30. VCMI_LIB_NAMESPACE_BEGIN
  31. CIdentifierStorage::CIdentifierStorage():
  32. state(LOADING)
  33. {
  34. }
  35. CIdentifierStorage::~CIdentifierStorage()
  36. {
  37. }
  38. void CIdentifierStorage::checkIdentifier(std::string & ID)
  39. {
  40. if (boost::algorithm::ends_with(ID, "."))
  41. logMod->warn("BIG WARNING: identifier %s seems to be broken!", ID);
  42. else
  43. {
  44. size_t pos = 0;
  45. do
  46. {
  47. if (std::tolower(ID[pos]) != ID[pos] ) //Not in camelCase
  48. {
  49. logMod->warn("Warning: identifier %s is not in camelCase!", ID);
  50. ID[pos] = std::tolower(ID[pos]);// Try to fix the ID
  51. }
  52. pos = ID.find('.', pos);
  53. }
  54. while(pos++ != std::string::npos);
  55. }
  56. }
  57. CIdentifierStorage::ObjectCallback::ObjectCallback(
  58. std::string localScope, std::string remoteScope, std::string type,
  59. std::string name, const std::function<void(si32)> & callback,
  60. bool optional):
  61. localScope(localScope),
  62. remoteScope(remoteScope),
  63. type(type),
  64. name(name),
  65. callback(callback),
  66. optional(optional)
  67. {}
  68. void CIdentifierStorage::requestIdentifier(ObjectCallback callback)
  69. {
  70. checkIdentifier(callback.type);
  71. checkIdentifier(callback.name);
  72. assert(!callback.localScope.empty());
  73. if (state != FINISHED) // enqueue request if loading is still in progress
  74. scheduledRequests.push_back(callback);
  75. else // execute immediately for "late" requests
  76. resolveIdentifier(callback);
  77. }
  78. void CIdentifierStorage::requestIdentifier(std::string scope, std::string type, std::string name, const std::function<void(si32)> & callback)
  79. {
  80. auto pair = vstd::splitStringToPair(name, ':'); // remoteScope:name
  81. requestIdentifier(ObjectCallback(scope, pair.first, type, pair.second, callback, false));
  82. }
  83. void CIdentifierStorage::requestIdentifier(std::string scope, std::string fullName, const std::function<void(si32)>& callback)
  84. {
  85. auto scopeAndFullName = vstd::splitStringToPair(fullName, ':');
  86. auto typeAndName = vstd::splitStringToPair(scopeAndFullName.second, '.');
  87. requestIdentifier(ObjectCallback(scope, scopeAndFullName.first, typeAndName.first, typeAndName.second, callback, false));
  88. }
  89. void CIdentifierStorage::requestIdentifier(std::string type, const JsonNode & name, const std::function<void(si32)> & callback)
  90. {
  91. auto pair = vstd::splitStringToPair(name.String(), ':'); // remoteScope:name
  92. requestIdentifier(ObjectCallback(name.meta, pair.first, type, pair.second, callback, false));
  93. }
  94. void CIdentifierStorage::requestIdentifier(const JsonNode & name, const std::function<void(si32)> & callback)
  95. {
  96. auto pair = vstd::splitStringToPair(name.String(), ':'); // remoteScope:<type.name>
  97. auto pair2 = vstd::splitStringToPair(pair.second, '.'); // type.name
  98. requestIdentifier(ObjectCallback(name.meta, pair.first, pair2.first, pair2.second, callback, false));
  99. }
  100. void CIdentifierStorage::tryRequestIdentifier(std::string scope, std::string type, std::string name, const std::function<void(si32)> & callback)
  101. {
  102. auto pair = vstd::splitStringToPair(name, ':'); // remoteScope:name
  103. requestIdentifier(ObjectCallback(scope, pair.first, type, pair.second, callback, true));
  104. }
  105. void CIdentifierStorage::tryRequestIdentifier(std::string type, const JsonNode & name, const std::function<void(si32)> & callback)
  106. {
  107. auto pair = vstd::splitStringToPair(name.String(), ':'); // remoteScope:name
  108. requestIdentifier(ObjectCallback(name.meta, pair.first, type, pair.second, callback, true));
  109. }
  110. boost::optional<si32> CIdentifierStorage::getIdentifier(std::string scope, std::string type, std::string name, bool silent)
  111. {
  112. auto pair = vstd::splitStringToPair(name, ':'); // remoteScope:name
  113. auto idList = getPossibleIdentifiers(ObjectCallback(scope, pair.first, type, pair.second, std::function<void(si32)>(), silent));
  114. if (idList.size() == 1)
  115. return idList.front().id;
  116. if (!silent)
  117. logMod->error("Failed to resolve identifier %s of type %s from mod %s", name , type ,scope);
  118. return boost::optional<si32>();
  119. }
  120. boost::optional<si32> CIdentifierStorage::getIdentifier(std::string type, const JsonNode & name, bool silent)
  121. {
  122. auto pair = vstd::splitStringToPair(name.String(), ':'); // remoteScope:name
  123. auto idList = getPossibleIdentifiers(ObjectCallback(name.meta, pair.first, type, pair.second, std::function<void(si32)>(), silent));
  124. if (idList.size() == 1)
  125. return idList.front().id;
  126. if (!silent)
  127. logMod->error("Failed to resolve identifier %s of type %s from mod %s", name.String(), type, name.meta);
  128. return boost::optional<si32>();
  129. }
  130. boost::optional<si32> CIdentifierStorage::getIdentifier(const JsonNode & name, bool silent)
  131. {
  132. auto pair = vstd::splitStringToPair(name.String(), ':'); // remoteScope:<type.name>
  133. auto pair2 = vstd::splitStringToPair(pair.second, '.'); // type.name
  134. auto idList = getPossibleIdentifiers(ObjectCallback(name.meta, pair.first, pair2.first, pair2.second, std::function<void(si32)>(), silent));
  135. if (idList.size() == 1)
  136. return idList.front().id;
  137. if (!silent)
  138. logMod->error("Failed to resolve identifier %s of type %s from mod %s", name.String(), pair2.first, name.meta);
  139. return boost::optional<si32>();
  140. }
  141. boost::optional<si32> CIdentifierStorage::getIdentifier(std::string scope, std::string fullName, bool silent)
  142. {
  143. auto pair = vstd::splitStringToPair(fullName, ':'); // remoteScope:<type.name>
  144. auto pair2 = vstd::splitStringToPair(pair.second, '.'); // type.name
  145. auto idList = getPossibleIdentifiers(ObjectCallback(scope, pair.first, pair2.first, pair2.second, std::function<void(si32)>(), silent));
  146. if (idList.size() == 1)
  147. return idList.front().id;
  148. if (!silent)
  149. logMod->error("Failed to resolve identifier %s of type %s from mod %s", fullName, pair2.first, scope);
  150. return boost::optional<si32>();
  151. }
  152. void CIdentifierStorage::registerObject(std::string scope, std::string type, std::string name, si32 identifier)
  153. {
  154. ObjectData data;
  155. data.scope = scope;
  156. data.id = identifier;
  157. std::string fullID = type + '.' + name;
  158. checkIdentifier(fullID);
  159. std::pair<const std::string, ObjectData> mapping = std::make_pair(fullID, data);
  160. if(!vstd::containsMapping(registeredObjects, mapping))
  161. {
  162. logMod->trace("registered %s as %s:%s", fullID, scope, identifier);
  163. registeredObjects.insert(mapping);
  164. }
  165. }
  166. std::vector<CIdentifierStorage::ObjectData> CIdentifierStorage::getPossibleIdentifiers(const ObjectCallback & request)
  167. {
  168. std::set<std::string> allowedScopes;
  169. bool isValidScope = true;
  170. if (request.remoteScope.empty())
  171. {
  172. if (request.localScope == "map")
  173. {
  174. for (auto const & modName : VLC->modh->getActiveMods())
  175. allowedScopes.insert(modName);
  176. }
  177. // normally ID's from all required mods, own mod and virtual "core" mod are allowed
  178. else if(request.localScope != "core" && !request.localScope.empty())
  179. {
  180. allowedScopes = VLC->modh->getModDependencies(request.localScope, isValidScope);
  181. if(!isValidScope)
  182. return std::vector<ObjectData>();
  183. }
  184. allowedScopes.insert(request.localScope);
  185. allowedScopes.insert("core");
  186. }
  187. else
  188. {
  189. //...unless destination mod was specified explicitly
  190. if(request.remoteScope == "core" )
  191. {
  192. //"core" mod is an implicit dependency for all mods, allow access into it
  193. allowedScopes.insert(request.remoteScope);
  194. }
  195. else if(request.remoteScope == request.localScope )
  196. {
  197. // allow self-access
  198. allowedScopes.insert(request.remoteScope);
  199. }
  200. else
  201. {
  202. // allow access only if mod is in our dependencies
  203. auto myDeps = VLC->modh->getModDependencies(request.localScope, isValidScope);
  204. if(!isValidScope)
  205. return std::vector<ObjectData>();
  206. if(myDeps.count(request.remoteScope))
  207. allowedScopes.insert(request.remoteScope);
  208. }
  209. }
  210. std::string fullID = request.type + '.' + request.name;
  211. auto entries = registeredObjects.equal_range(fullID);
  212. if (entries.first != entries.second)
  213. {
  214. std::vector<ObjectData> locatedIDs;
  215. for (auto it = entries.first; it != entries.second; it++)
  216. {
  217. if (vstd::contains(allowedScopes, it->second.scope))
  218. {
  219. locatedIDs.push_back(it->second);
  220. }
  221. }
  222. return locatedIDs;
  223. }
  224. return std::vector<ObjectData>();
  225. }
  226. bool CIdentifierStorage::resolveIdentifier(const ObjectCallback & request)
  227. {
  228. auto identifiers = getPossibleIdentifiers(request);
  229. if (identifiers.size() == 1) // normally resolved ID
  230. {
  231. request.callback(identifiers.front().id);
  232. return true;
  233. }
  234. if (request.optional && identifiers.empty()) // failed to resolve optinal ID
  235. {
  236. return true;
  237. }
  238. // error found. Try to generate some debug info
  239. if (identifiers.size() == 0)
  240. logMod->error("Unknown identifier!");
  241. else
  242. logMod->error("Ambiguous identifier request!");
  243. logMod->error("Request for %s.%s from mod %s", request.type, request.name, request.localScope);
  244. for (auto id : identifiers)
  245. {
  246. logMod->error("\tID is available in mod %s", id.scope);
  247. }
  248. return false;
  249. }
  250. void CIdentifierStorage::finalize()
  251. {
  252. state = FINALIZING;
  253. bool errorsFound = false;
  254. //Note: we may receive new requests during resolution phase -> end may change -> range for can't be used
  255. for(auto it = scheduledRequests.begin(); it != scheduledRequests.end(); it++)
  256. {
  257. errorsFound |= !resolveIdentifier(*it);
  258. }
  259. if (errorsFound)
  260. {
  261. for(auto object : registeredObjects)
  262. {
  263. logMod->trace("%s : %s -> %d", object.second.scope, object.first, object.second.id);
  264. }
  265. logMod->error("All known identifiers were dumped into log file");
  266. }
  267. assert(errorsFound == false);
  268. state = FINISHED;
  269. }
  270. ContentTypeHandler::ContentTypeHandler(IHandlerBase * handler, std::string objectName):
  271. handler(handler),
  272. objectName(objectName),
  273. originalData(handler->loadLegacyData((size_t)VLC->modh->settings.data["textData"][objectName].Float()))
  274. {
  275. for(auto & node : originalData)
  276. {
  277. node.setMeta("core");
  278. }
  279. }
  280. bool ContentTypeHandler::preloadModData(std::string modName, std::vector<std::string> fileList, bool validate)
  281. {
  282. bool result;
  283. JsonNode data = JsonUtils::assembleFromFiles(fileList, result);
  284. data.setMeta(modName);
  285. ModInfo & modInfo = modData[modName];
  286. for(auto entry : data.Struct())
  287. {
  288. size_t colon = entry.first.find(':');
  289. if (colon == std::string::npos)
  290. {
  291. // normal object, local to this mod
  292. modInfo.modData[entry.first].swap(entry.second);
  293. }
  294. else
  295. {
  296. std::string remoteName = entry.first.substr(0, colon);
  297. std::string objectName = entry.first.substr(colon + 1);
  298. // patching this mod? Send warning and continue - this situation can be handled normally
  299. if (remoteName == modName)
  300. logMod->warn("Redundant namespace definition for %s", objectName);
  301. logMod->trace("Patching object %s (%s) from %s", objectName, remoteName, modName);
  302. JsonNode & remoteConf = modData[remoteName].patches[objectName];
  303. JsonUtils::merge(remoteConf, entry.second);
  304. }
  305. }
  306. return result;
  307. }
  308. bool ContentTypeHandler::loadMod(std::string modName, bool validate)
  309. {
  310. ModInfo & modInfo = modData[modName];
  311. bool result = true;
  312. auto performValidate = [&,this](JsonNode & data, const std::string & name){
  313. handler->beforeValidate(data);
  314. if (validate)
  315. result &= JsonUtils::validate(data, "vcmi:" + objectName, name);
  316. };
  317. // apply patches
  318. if (!modInfo.patches.isNull())
  319. JsonUtils::merge(modInfo.modData, modInfo.patches);
  320. for(auto & entry : modInfo.modData.Struct())
  321. {
  322. const std::string & name = entry.first;
  323. JsonNode & data = entry.second;
  324. if (vstd::contains(data.Struct(), "index") && !data["index"].isNull())
  325. {
  326. // try to add H3 object data
  327. size_t index = static_cast<size_t>(data["index"].Float());
  328. if(originalData.size() > index)
  329. {
  330. logMod->trace("found original data in loadMod(%s) at index %d", name, index);
  331. JsonUtils::merge(originalData[index], data);
  332. std::swap(originalData[index], data);
  333. originalData[index].clear(); // do not use same data twice (same ID)
  334. }
  335. else
  336. {
  337. logMod->warn("no original data in loadMod(%s) at index %d", name, index);
  338. }
  339. performValidate(data, name);
  340. handler->loadObject(modName, name, data, index);
  341. }
  342. else
  343. {
  344. // normal new object
  345. logMod->trace("no index in loadMod(%s)", name);
  346. performValidate(data,name);
  347. handler->loadObject(modName, name, data);
  348. }
  349. }
  350. return result;
  351. }
  352. void ContentTypeHandler::loadCustom()
  353. {
  354. handler->loadCustom();
  355. }
  356. void ContentTypeHandler::afterLoadFinalization()
  357. {
  358. handler->afterLoadFinalization();
  359. }
  360. CContentHandler::CContentHandler()
  361. {
  362. }
  363. void CContentHandler::init()
  364. {
  365. handlers.insert(std::make_pair("heroClasses", ContentTypeHandler(&VLC->heroh->classes, "heroClass")));
  366. handlers.insert(std::make_pair("artifacts", ContentTypeHandler(VLC->arth, "artifact")));
  367. handlers.insert(std::make_pair("creatures", ContentTypeHandler(VLC->creh, "creature")));
  368. handlers.insert(std::make_pair("factions", ContentTypeHandler(VLC->townh, "faction")));
  369. handlers.insert(std::make_pair("objects", ContentTypeHandler(VLC->objtypeh, "object")));
  370. handlers.insert(std::make_pair("heroes", ContentTypeHandler(VLC->heroh, "hero")));
  371. handlers.insert(std::make_pair("spells", ContentTypeHandler(VLC->spellh, "spell")));
  372. handlers.insert(std::make_pair("skills", ContentTypeHandler(VLC->skillh, "skill")));
  373. handlers.insert(std::make_pair("templates", ContentTypeHandler((IHandlerBase *)VLC->tplh, "template")));
  374. #if SCRIPTING_ENABLED
  375. handlers.insert(std::make_pair("scripts", ContentTypeHandler(VLC->scriptHandler, "script")));
  376. #endif
  377. handlers.insert(std::make_pair("battlefields", ContentTypeHandler(VLC->battlefieldsHandler, "battlefield")));
  378. handlers.insert(std::make_pair("obstacles", ContentTypeHandler(VLC->obstacleHandler, "obstacle")));
  379. //TODO: any other types of moddables?
  380. }
  381. bool CContentHandler::preloadModData(std::string modName, JsonNode modConfig, bool validate)
  382. {
  383. bool result = true;
  384. for(auto & handler : handlers)
  385. {
  386. result &= handler.second.preloadModData(modName, modConfig[handler.first].convertTo<std::vector<std::string> >(), validate);
  387. }
  388. return result;
  389. }
  390. bool CContentHandler::loadMod(std::string modName, bool validate)
  391. {
  392. bool result = true;
  393. for(auto & handler : handlers)
  394. {
  395. result &= handler.second.loadMod(modName, validate);
  396. }
  397. return result;
  398. }
  399. void CContentHandler::loadCustom()
  400. {
  401. for(auto & handler : handlers)
  402. {
  403. handler.second.loadCustom();
  404. }
  405. }
  406. void CContentHandler::afterLoadFinalization()
  407. {
  408. for(auto & handler : handlers)
  409. {
  410. handler.second.afterLoadFinalization();
  411. }
  412. }
  413. void CContentHandler::preloadData(CModInfo & mod)
  414. {
  415. bool validate = (mod.validation != CModInfo::PASSED);
  416. // print message in format [<8-symbols checksum>] <modname>
  417. logMod->info("\t\t[%08x]%s", mod.checksum, mod.name);
  418. if (validate && mod.identifier != "core")
  419. {
  420. if (!JsonUtils::validate(mod.config, "vcmi:mod", mod.identifier))
  421. mod.validation = CModInfo::FAILED;
  422. }
  423. if (!preloadModData(mod.identifier, mod.config, validate))
  424. mod.validation = CModInfo::FAILED;
  425. }
  426. void CContentHandler::load(CModInfo & mod)
  427. {
  428. bool validate = (mod.validation != CModInfo::PASSED);
  429. if (!loadMod(mod.identifier, validate))
  430. mod.validation = CModInfo::FAILED;
  431. if (validate)
  432. {
  433. if (mod.validation != CModInfo::FAILED)
  434. logMod->info("\t\t[DONE] %s", mod.name);
  435. else
  436. logMod->error("\t\t[FAIL] %s", mod.name);
  437. }
  438. else
  439. logMod->info("\t\t[SKIP] %s", mod.name);
  440. }
  441. const ContentTypeHandler & CContentHandler::operator[](const std::string & name) const
  442. {
  443. return handlers.at(name);
  444. }
  445. static JsonNode loadModSettings(std::string path)
  446. {
  447. if (CResourceHandler::get("local")->existsResource(ResourceID(path)))
  448. {
  449. return JsonNode(ResourceID(path, EResType::TEXT));
  450. }
  451. // Probably new install. Create initial configuration
  452. CResourceHandler::get("local")->createResource(path);
  453. return JsonNode();
  454. }
  455. JsonNode addMeta(JsonNode config, std::string meta)
  456. {
  457. config.setMeta(meta);
  458. return config;
  459. }
  460. CModInfo::Version CModInfo::Version::GameVersion()
  461. {
  462. return Version(VCMI_VERSION_MAJOR, VCMI_VERSION_MINOR, VCMI_VERSION_PATCH);
  463. }
  464. CModInfo::Version CModInfo::Version::fromString(std::string from)
  465. {
  466. int major = 0, minor = 0, patch = 0;
  467. try
  468. {
  469. auto pointPos = from.find('.');
  470. major = std::stoi(from.substr(0, pointPos));
  471. if(pointPos != std::string::npos)
  472. {
  473. from = from.substr(pointPos + 1);
  474. pointPos = from.find('.');
  475. minor = std::stoi(from.substr(0, pointPos));
  476. if(pointPos != std::string::npos)
  477. patch = std::stoi(from.substr(pointPos + 1));
  478. }
  479. }
  480. catch(const std::invalid_argument & e)
  481. {
  482. return Version();
  483. }
  484. return Version(major, minor, patch);
  485. }
  486. std::string CModInfo::Version::toString() const
  487. {
  488. return std::to_string(major) + '.' + std::to_string(minor) + '.' + std::to_string(patch);
  489. }
  490. bool CModInfo::Version::compatible(const Version & other, bool checkMinor, bool checkPatch) const
  491. {
  492. return (major == other.major &&
  493. (!checkMinor || minor >= other.minor) &&
  494. (!checkPatch || minor > other.minor || (minor == other.minor && patch >= other.patch)));
  495. }
  496. bool CModInfo::Version::isNull() const
  497. {
  498. return major == 0 && minor == 0 && patch == 0;
  499. }
  500. CModInfo::CModInfo():
  501. checksum(0),
  502. enabled(false),
  503. validation(PENDING)
  504. {
  505. }
  506. CModInfo::CModInfo(std::string identifier,const JsonNode & local, const JsonNode & config):
  507. identifier(identifier),
  508. name(config["name"].String()),
  509. description(config["description"].String()),
  510. dependencies(config["depends"].convertTo<std::set<std::string> >()),
  511. conflicts(config["conflicts"].convertTo<std::set<std::string> >()),
  512. checksum(0),
  513. enabled(false),
  514. validation(PENDING),
  515. config(addMeta(config, identifier))
  516. {
  517. version = Version::fromString(config["version"].String());
  518. if(!config["compatibility"].isNull())
  519. {
  520. vcmiCompatibleMin = Version::fromString(config["compatibility"]["min"].String());
  521. vcmiCompatibleMax = Version::fromString(config["compatibility"]["max"].String());
  522. }
  523. loadLocalData(local);
  524. }
  525. JsonNode CModInfo::saveLocalData() const
  526. {
  527. std::ostringstream stream;
  528. stream << std::noshowbase << std::hex << std::setw(8) << std::setfill('0') << checksum;
  529. JsonNode conf;
  530. conf["active"].Bool() = enabled;
  531. conf["validated"].Bool() = validation != FAILED;
  532. conf["checksum"].String() = stream.str();
  533. return conf;
  534. }
  535. std::string CModInfo::getModDir(std::string name)
  536. {
  537. return "MODS/" + boost::algorithm::replace_all_copy(name, ".", "/MODS/");
  538. }
  539. std::string CModInfo::getModFile(std::string name)
  540. {
  541. return getModDir(name) + "/mod.json";
  542. }
  543. void CModInfo::updateChecksum(ui32 newChecksum)
  544. {
  545. // comment-out next line to force validation of all mods ignoring checksum
  546. if (newChecksum != checksum)
  547. {
  548. checksum = newChecksum;
  549. validation = PENDING;
  550. }
  551. }
  552. void CModInfo::loadLocalData(const JsonNode & data)
  553. {
  554. bool validated = false;
  555. enabled = true;
  556. checksum = 0;
  557. if (data.getType() == JsonNode::JsonType::DATA_BOOL)
  558. {
  559. enabled = data.Bool();
  560. }
  561. if (data.getType() == JsonNode::JsonType::DATA_STRUCT)
  562. {
  563. enabled = data["active"].Bool();
  564. validated = data["validated"].Bool();
  565. checksum = strtol(data["checksum"].String().c_str(), nullptr, 16);
  566. }
  567. //check compatibility
  568. bool wasEnabled = enabled;
  569. enabled = enabled && (vcmiCompatibleMin.isNull() || Version::GameVersion().compatible(vcmiCompatibleMin));
  570. enabled = enabled && (vcmiCompatibleMax.isNull() || vcmiCompatibleMax.compatible(Version::GameVersion()));
  571. if(wasEnabled && !enabled)
  572. logGlobal->warn("Mod %s is incompatible with current version of VCMI and cannot be enabled", name);
  573. if (enabled)
  574. validation = validated ? PASSED : PENDING;
  575. else
  576. validation = validated ? PASSED : FAILED;
  577. }
  578. CModHandler::CModHandler() : content(std::make_shared<CContentHandler>())
  579. {
  580. modules.COMMANDERS = false;
  581. modules.STACK_ARTIFACT = false;
  582. modules.STACK_EXP = false;
  583. modules.MITHRIL = false;
  584. for (int i = 0; i < GameConstants::RESOURCE_QUANTITY; ++i)
  585. {
  586. identifiers.registerObject("core", "resource", GameConstants::RESOURCE_NAMES[i], i);
  587. }
  588. for(int i=0; i<GameConstants::PRIMARY_SKILLS; ++i)
  589. {
  590. identifiers.registerObject("core", "primSkill", PrimarySkill::names[i], i);
  591. identifiers.registerObject("core", "primarySkill", PrimarySkill::names[i], i);
  592. }
  593. }
  594. CModHandler::~CModHandler()
  595. {
  596. }
  597. void CModHandler::loadConfigFromFile (std::string name)
  598. {
  599. std::string paths;
  600. for(auto& p : CResourceHandler::get()->getResourceNames(ResourceID("config/" + name)))
  601. {
  602. paths += p.string() + ", ";
  603. }
  604. paths = paths.substr(0, paths.size() - 2);
  605. logMod->debug("Loading hardcoded features settings from [%s], result:", paths);
  606. settings.data = JsonUtils::assembleFromFiles("config/" + name);
  607. const JsonNode & hardcodedFeatures = settings.data["hardcodedFeatures"];
  608. settings.MAX_HEROES_AVAILABLE_PER_PLAYER = static_cast<int>(hardcodedFeatures["MAX_HEROES_AVAILABLE_PER_PLAYER"].Integer());
  609. logMod->debug("\tMAX_HEROES_AVAILABLE_PER_PLAYER\t%d", settings.MAX_HEROES_AVAILABLE_PER_PLAYER);
  610. settings.MAX_HEROES_ON_MAP_PER_PLAYER = static_cast<int>(hardcodedFeatures["MAX_HEROES_ON_MAP_PER_PLAYER"].Integer());
  611. logMod->debug("\tMAX_HEROES_ON_MAP_PER_PLAYER\t%d", settings.MAX_HEROES_ON_MAP_PER_PLAYER);
  612. settings.CREEP_SIZE = static_cast<int>(hardcodedFeatures["CREEP_SIZE"].Integer());
  613. logMod->debug("\tCREEP_SIZE\t%d", settings.CREEP_SIZE);
  614. settings.WEEKLY_GROWTH = static_cast<int>(hardcodedFeatures["WEEKLY_GROWTH_PERCENT"].Integer());
  615. logMod->debug("\tWEEKLY_GROWTH\t%d", settings.WEEKLY_GROWTH);
  616. settings.NEUTRAL_STACK_EXP = static_cast<int>(hardcodedFeatures["NEUTRAL_STACK_EXP_DAILY"].Integer());
  617. logMod->debug("\tNEUTRAL_STACK_EXP\t%d", settings.NEUTRAL_STACK_EXP);
  618. settings.MAX_BUILDING_PER_TURN = static_cast<int>(hardcodedFeatures["MAX_BUILDING_PER_TURN"].Integer());
  619. logMod->debug("\tMAX_BUILDING_PER_TURN\t%d", settings.MAX_BUILDING_PER_TURN);
  620. settings.DWELLINGS_ACCUMULATE_CREATURES = hardcodedFeatures["DWELLINGS_ACCUMULATE_CREATURES"].Bool();
  621. logMod->debug("\tDWELLINGS_ACCUMULATE_CREATURES\t%d", static_cast<int>(settings.DWELLINGS_ACCUMULATE_CREATURES));
  622. settings.ALL_CREATURES_GET_DOUBLE_MONTHS = hardcodedFeatures["ALL_CREATURES_GET_DOUBLE_MONTHS"].Bool();
  623. logMod->debug("\tALL_CREATURES_GET_DOUBLE_MONTHS\t%d", static_cast<int>(settings.ALL_CREATURES_GET_DOUBLE_MONTHS));
  624. settings.WINNING_HERO_WITH_NO_TROOPS_RETREATS = hardcodedFeatures["WINNING_HERO_WITH_NO_TROOPS_RETREATS"].Bool();
  625. logMod->debug("\tWINNING_HERO_WITH_NO_TROOPS_RETREATS\t%d", static_cast<int>(settings.WINNING_HERO_WITH_NO_TROOPS_RETREATS));
  626. settings.BLACK_MARKET_MONTHLY_ARTIFACTS_CHANGE = hardcodedFeatures["BLACK_MARKET_MONTHLY_ARTIFACTS_CHANGE"].Bool();
  627. logMod->debug("\tBLACK_MARKET_MONTHLY_ARTIFACTS_CHANGE\t%d", static_cast<int>(settings.BLACK_MARKET_MONTHLY_ARTIFACTS_CHANGE));
  628. settings.NO_RANDOM_SPECIAL_WEEKS_AND_MONTHS = hardcodedFeatures["NO_RANDOM_SPECIAL_WEEKS_AND_MONTHS"].Bool();
  629. logMod->debug("\tNO_RANDOM_SPECIAL_WEEKS_AND_MONTHS\t%d", static_cast<int>(settings.NO_RANDOM_SPECIAL_WEEKS_AND_MONTHS));
  630. const JsonNode & gameModules = settings.data["modules"];
  631. modules.STACK_EXP = gameModules["STACK_EXPERIENCE"].Bool();
  632. logMod->debug("\tSTACK_EXP\t%d", static_cast<int>(modules.STACK_EXP));
  633. modules.STACK_ARTIFACT = gameModules["STACK_ARTIFACTS"].Bool();
  634. logMod->debug("\tSTACK_ARTIFACT\t%d", static_cast<int>(modules.STACK_ARTIFACT));
  635. modules.COMMANDERS = gameModules["COMMANDERS"].Bool();
  636. logMod->debug("\tCOMMANDERS\t%d", static_cast<int>(modules.COMMANDERS));
  637. modules.MITHRIL = gameModules["MITHRIL"].Bool();
  638. logMod->debug("\tMITHRIL\t%d", static_cast<int>(modules.MITHRIL));
  639. }
  640. // currentList is passed by value to get current list of depending mods
  641. bool CModHandler::hasCircularDependency(TModID modID, std::set <TModID> currentList) const
  642. {
  643. const CModInfo & mod = allMods.at(modID);
  644. // Mod already present? We found a loop
  645. if (vstd::contains(currentList, modID))
  646. {
  647. logMod->error("Error: Circular dependency detected! Printing dependency list:");
  648. logMod->error("\t%s -> ", mod.name);
  649. return true;
  650. }
  651. currentList.insert(modID);
  652. // recursively check every dependency of this mod
  653. for(const TModID & dependency : mod.dependencies)
  654. {
  655. if (hasCircularDependency(dependency, currentList))
  656. {
  657. logMod->error("\t%s ->\n", mod.name); // conflict detected, print dependency list
  658. return true;
  659. }
  660. }
  661. return false;
  662. }
  663. bool CModHandler::checkDependencies(const std::vector <TModID> & input) const
  664. {
  665. for(const TModID & id : input)
  666. {
  667. const CModInfo & mod = allMods.at(id);
  668. for(const TModID & dep : mod.dependencies)
  669. {
  670. if(!vstd::contains(input, dep))
  671. {
  672. logMod->error("Error: Mod %s requires missing %s!", mod.name, dep);
  673. return false;
  674. }
  675. }
  676. for(const TModID & conflicting : mod.conflicts)
  677. {
  678. if(vstd::contains(input, conflicting))
  679. {
  680. logMod->error("Error: Mod %s conflicts with %s!", mod.name, allMods.at(conflicting).name);
  681. return false;
  682. }
  683. }
  684. if(hasCircularDependency(id))
  685. return false;
  686. }
  687. return true;
  688. }
  689. // Returned vector affects the resource loaders call order (see CFilesystemList::load).
  690. // The loaders call order matters when dependent mod overrides resources in its dependencies.
  691. std::vector <TModID> CModHandler::validateAndSortDependencies(std::vector <TModID> modsToResolve) const
  692. {
  693. // Topological sort algorithm.
  694. // TODO: Investigate possible ways to improve performance.
  695. boost::range::sort(modsToResolve); // Sort mods per name
  696. std::vector <TModID> sortedValidMods; // Vector keeps order of elements (LIFO)
  697. sortedValidMods.reserve(modsToResolve.size()); // push_back calls won't cause memory reallocation
  698. std::set <TModID> resolvedModIDs; // Use a set for validation for performance reason, but set does not keep order of elements
  699. // Mod is resolved if it has not dependencies or all its dependencies are already resolved
  700. auto isResolved = [&](const CModInfo & mod) -> CModInfo::EValidationStatus
  701. {
  702. if(mod.dependencies.size() > resolvedModIDs.size())
  703. return CModInfo::PENDING;
  704. for(const TModID & dependency : mod.dependencies)
  705. {
  706. if(!vstd::contains(resolvedModIDs, dependency))
  707. return CModInfo::PENDING;
  708. }
  709. return CModInfo::PASSED;
  710. };
  711. while(true)
  712. {
  713. std::set <TModID> resolvedOnCurrentTreeLevel;
  714. for(auto it = modsToResolve.begin(); it != modsToResolve.end();) // One iteration - one level of mods tree
  715. {
  716. if(isResolved(allMods.at(*it)) == CModInfo::PASSED)
  717. {
  718. resolvedOnCurrentTreeLevel.insert(*it); // Not to the resolvedModIDs, so current node childs will be resolved on the next iteration
  719. sortedValidMods.push_back(*it);
  720. it = modsToResolve.erase(it);
  721. continue;
  722. }
  723. it++;
  724. }
  725. if(resolvedOnCurrentTreeLevel.size())
  726. {
  727. resolvedModIDs.insert(resolvedOnCurrentTreeLevel.begin(), resolvedOnCurrentTreeLevel.end());
  728. continue;
  729. }
  730. // If there're no valid mods on the current mods tree level, no more mod can be resolved, should be end.
  731. break;
  732. }
  733. // Left mods have unresolved dependencies, output all to log.
  734. for(const auto & brokenModID : modsToResolve)
  735. {
  736. const CModInfo & brokenMod = allMods.at(brokenModID);
  737. for(const TModID & dependency : brokenMod.dependencies)
  738. {
  739. if(!vstd::contains(resolvedModIDs, dependency))
  740. logMod->error("Mod '%s' will not work: it depends on mod '%s', which is not installed.", brokenMod.name, dependency);
  741. }
  742. }
  743. return sortedValidMods;
  744. }
  745. std::vector<std::string> CModHandler::getModList(std::string path)
  746. {
  747. std::string modDir = boost::to_upper_copy(path + "MODS/");
  748. size_t depth = boost::range::count(modDir, '/');
  749. auto list = CResourceHandler::get("initial")->getFilteredFiles([&](const ResourceID & id) -> bool
  750. {
  751. if (id.getType() != EResType::DIRECTORY)
  752. return false;
  753. if (!boost::algorithm::starts_with(id.getName(), modDir))
  754. return false;
  755. if (boost::range::count(id.getName(), '/') != depth )
  756. return false;
  757. return true;
  758. });
  759. //storage for found mods
  760. std::vector<std::string> foundMods;
  761. for (auto & entry : list)
  762. {
  763. std::string name = entry.getName();
  764. name.erase(0, modDir.size()); //Remove path prefix
  765. if (!name.empty())
  766. foundMods.push_back(name);
  767. }
  768. return foundMods;
  769. }
  770. void CModHandler::loadMods(std::string path, std::string parent, const JsonNode & modSettings, bool enableMods)
  771. {
  772. for(std::string modName : getModList(path))
  773. loadOneMod(modName, parent, modSettings, enableMods);
  774. }
  775. void CModHandler::loadOneMod(std::string modName, std::string parent, const JsonNode & modSettings, bool enableMods)
  776. {
  777. boost::to_lower(modName);
  778. std::string modFullName = parent.empty() ? modName : parent + '.' + modName;
  779. if(CResourceHandler::get("initial")->existsResource(ResourceID(CModInfo::getModFile(modFullName))))
  780. {
  781. CModInfo mod(modFullName, modSettings[modName], JsonNode(ResourceID(CModInfo::getModFile(modFullName))));
  782. if (!parent.empty()) // this is submod, add parent to dependencies
  783. mod.dependencies.insert(parent);
  784. allMods[modFullName] = mod;
  785. if (mod.enabled && enableMods)
  786. activeMods.push_back(modFullName);
  787. loadMods(CModInfo::getModDir(modFullName) + '/', modFullName, modSettings[modName]["mods"], enableMods && mod.enabled);
  788. }
  789. }
  790. void CModHandler::loadMods(bool onlyEssential)
  791. {
  792. JsonNode modConfig;
  793. if(onlyEssential)
  794. {
  795. loadOneMod("vcmi", "", modConfig, true);//only vcmi and submods
  796. }
  797. else
  798. {
  799. modConfig = loadModSettings("config/modSettings.json");
  800. loadMods("", "", modConfig["activeMods"], true);
  801. }
  802. coreMod = CModInfo("core", modConfig["core"], JsonNode(ResourceID("config/gameConfig.json")));
  803. coreMod.name = "Original game files";
  804. }
  805. std::vector<std::string> CModHandler::getAllMods()
  806. {
  807. std::vector<std::string> modlist;
  808. for (auto & entry : allMods)
  809. modlist.push_back(entry.first);
  810. return modlist;
  811. }
  812. std::vector<std::string> CModHandler::getActiveMods()
  813. {
  814. return activeMods;
  815. }
  816. static JsonNode genDefaultFS()
  817. {
  818. // default FS config for mods: directory "Content" that acts as H3 root directory
  819. JsonNode defaultFS;
  820. defaultFS[""].Vector().resize(2);
  821. defaultFS[""].Vector()[0]["type"].String() = "zip";
  822. defaultFS[""].Vector()[0]["path"].String() = "/Content.zip";
  823. defaultFS[""].Vector()[1]["type"].String() = "dir";
  824. defaultFS[""].Vector()[1]["path"].String() = "/Content";
  825. return defaultFS;
  826. }
  827. static ISimpleResourceLoader * genModFilesystem(const std::string & modName, const JsonNode & conf)
  828. {
  829. static const JsonNode defaultFS = genDefaultFS();
  830. if (!conf["filesystem"].isNull())
  831. return CResourceHandler::createFileSystem(CModInfo::getModDir(modName), conf["filesystem"]);
  832. else
  833. return CResourceHandler::createFileSystem(CModInfo::getModDir(modName), defaultFS);
  834. }
  835. static ui32 calculateModChecksum(const std::string modName, ISimpleResourceLoader * filesystem)
  836. {
  837. boost::crc_32_type modChecksum;
  838. // first - add current VCMI version into checksum to force re-validation on VCMI updates
  839. modChecksum.process_bytes(reinterpret_cast<const void*>(GameConstants::VCMI_VERSION.data()), GameConstants::VCMI_VERSION.size());
  840. // second - add mod.json into checksum because filesystem does not contains this file
  841. // FIXME: remove workaround for core mod
  842. if (modName != "core")
  843. {
  844. ResourceID modConfFile(CModInfo::getModFile(modName), EResType::TEXT);
  845. ui32 configChecksum = CResourceHandler::get("initial")->load(modConfFile)->calculateCRC32();
  846. modChecksum.process_bytes(reinterpret_cast<const void *>(&configChecksum), sizeof(configChecksum));
  847. }
  848. // third - add all detected text files from this mod into checksum
  849. auto files = filesystem->getFilteredFiles([](const ResourceID & resID)
  850. {
  851. return resID.getType() == EResType::TEXT &&
  852. ( boost::starts_with(resID.getName(), "DATA") ||
  853. boost::starts_with(resID.getName(), "CONFIG"));
  854. });
  855. for (const ResourceID & file : files)
  856. {
  857. ui32 fileChecksum = filesystem->load(file)->calculateCRC32();
  858. modChecksum.process_bytes(reinterpret_cast<const void *>(&fileChecksum), sizeof(fileChecksum));
  859. }
  860. return modChecksum.checksum();
  861. }
  862. void CModHandler::loadModFilesystems()
  863. {
  864. activeMods = validateAndSortDependencies(activeMods);
  865. coreMod.updateChecksum(calculateModChecksum("core", CResourceHandler::get("core")));
  866. for(std::string & modName : activeMods)
  867. {
  868. CModInfo & mod = allMods[modName];
  869. CResourceHandler::addFilesystem("data", modName, genModFilesystem(modName, mod.config));
  870. }
  871. }
  872. std::set<TModID> CModHandler::getModDependencies(TModID modId, bool & isModFound)
  873. {
  874. auto it = allMods.find(modId);
  875. isModFound = (it != allMods.end());
  876. if(isModFound)
  877. return it->second.dependencies;
  878. logMod->error("Mod not found: '%s'", modId);
  879. return std::set<TModID>();
  880. }
  881. void CModHandler::initializeConfig()
  882. {
  883. loadConfigFromFile("defaultMods.json");
  884. }
  885. void CModHandler::load()
  886. {
  887. CStopWatch totalTime, timer;
  888. logMod->info("\tInitializing content handler: %d ms", timer.getDiff());
  889. content->init();
  890. for(const TModID & modName : activeMods)
  891. {
  892. logMod->trace("Generating checksum for %s", modName);
  893. allMods[modName].updateChecksum(calculateModChecksum(modName, CResourceHandler::get(modName)));
  894. }
  895. // first - load virtual "core" mod that contains all data
  896. // TODO? move all data into real mods? RoE, AB, SoD, WoG
  897. content->preloadData(coreMod);
  898. for(const TModID & modName : activeMods)
  899. content->preloadData(allMods[modName]);
  900. logMod->info("\tParsing mod data: %d ms", timer.getDiff());
  901. content->load(coreMod);
  902. for(const TModID & modName : activeMods)
  903. content->load(allMods[modName]);
  904. #if SCRIPTING_ENABLED
  905. VLC->scriptHandler->performRegistration(VLC);//todo: this should be done before any other handlers load
  906. #endif
  907. content->loadCustom();
  908. logMod->info("\tLoading mod data: %d ms", timer.getDiff());
  909. VLC->creh->loadCrExpBon();
  910. VLC->creh->buildBonusTreeForTiers(); //do that after all new creatures are loaded
  911. identifiers.finalize();
  912. logMod->info("\tResolving identifiers: %d ms", timer.getDiff());
  913. content->afterLoadFinalization();
  914. logMod->info("\tHandlers post-load finalization: %d ms ", timer.getDiff());
  915. logMod->info("\tAll game content loaded in %d ms", totalTime.getDiff());
  916. }
  917. void CModHandler::afterLoad(bool onlyEssential)
  918. {
  919. JsonNode modSettings;
  920. for (auto & modEntry : allMods)
  921. {
  922. std::string pointer = "/" + boost::algorithm::replace_all_copy(modEntry.first, ".", "/mods/");
  923. modSettings["activeMods"].resolvePointer(pointer) = modEntry.second.saveLocalData();
  924. }
  925. modSettings["core"] = coreMod.saveLocalData();
  926. if(!onlyEssential)
  927. {
  928. FileStream file(*CResourceHandler::get()->getResourceName(ResourceID("config/modSettings.json")), std::ofstream::out | std::ofstream::trunc);
  929. file << modSettings.toJson();
  930. }
  931. }
  932. std::string CModHandler::normalizeIdentifier(const std::string & scope, const std::string & remoteScope, const std::string & identifier)
  933. {
  934. auto p = vstd::splitStringToPair(identifier, ':');
  935. if(p.first.empty())
  936. p.first = scope;
  937. if(p.first == remoteScope)
  938. p.first.clear();
  939. return p.first.empty() ? p.second : p.first + ":" + p.second;
  940. }
  941. void CModHandler::parseIdentifier(const std::string & fullIdentifier, std::string & scope, std::string & type, std::string & identifier)
  942. {
  943. auto p = vstd::splitStringToPair(fullIdentifier, ':');
  944. scope = p.first;
  945. auto p2 = vstd::splitStringToPair(p.second, '.');
  946. if(p2.first != "")
  947. {
  948. type = p2.first;
  949. identifier = p2.second;
  950. }
  951. else
  952. {
  953. type = p.second;
  954. identifier.clear();
  955. }
  956. }
  957. std::string CModHandler::makeFullIdentifier(const std::string & scope, const std::string & type, const std::string & identifier)
  958. {
  959. if(type.empty())
  960. logGlobal->error("Full identifier (%s %s) requires type name", scope, identifier);
  961. std::string actualScope = scope;
  962. std::string actualName = identifier;
  963. //ignore scope if identifier is scoped
  964. auto scopeAndName = vstd::splitStringToPair(identifier, ':');
  965. if(scopeAndName.first != "")
  966. {
  967. actualScope = scopeAndName.first;
  968. actualName = scopeAndName.second;
  969. }
  970. if(actualScope.empty())
  971. {
  972. return actualName.empty() ? type : type + "." + actualName;
  973. }
  974. else
  975. {
  976. return actualName.empty() ? actualScope+ ":" + type : actualScope + ":" + type + "." + actualName;
  977. }
  978. }
  979. VCMI_LIB_NAMESPACE_END