Info.cpp 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562
  1. /*
  2. * Info.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 "Info.h"
  12. #include "Configuration.h"
  13. #include "Limiter.h"
  14. #include "Reward.h"
  15. #include "../texts/CGeneralTextHandler.h"
  16. #include "../IGameCallback.h"
  17. #include "../json/JsonRandom.h"
  18. #include "../GameLibrary.h"
  19. #include "../mapObjects/IObjectInterface.h"
  20. #include "../modding/IdentifierStorage.h"
  21. #include <vstd/RNG.h>
  22. VCMI_LIB_NAMESPACE_BEGIN
  23. namespace {
  24. MetaString loadMessage(const JsonNode & value, const TextIdentifier & textIdentifier, EMetaText textSource = EMetaText::ADVOB_TXT )
  25. {
  26. MetaString ret;
  27. if (value.isVector())
  28. {
  29. for(const auto & entry : value.Vector())
  30. {
  31. if (entry.isNumber())
  32. ret.appendLocalString(textSource, static_cast<ui32>(entry.Float()));
  33. if (entry.isString())
  34. ret.appendRawString(entry.String());
  35. }
  36. return ret;
  37. }
  38. if (value.isNumber())
  39. {
  40. ret.appendLocalString(textSource, static_cast<ui32>(value.Float()));
  41. return ret;
  42. }
  43. if (value.String().empty())
  44. return ret;
  45. if (value.String()[0] == '@')
  46. ret.appendTextID(value.String().substr(1));
  47. else
  48. ret.appendTextID(textIdentifier.get());
  49. return ret;
  50. }
  51. bool testForKey(const JsonNode & value, const std::string & key)
  52. {
  53. for(const auto & reward : value["rewards"].Vector())
  54. {
  55. if (!reward[key].isNull())
  56. return true;
  57. }
  58. return false;
  59. }
  60. }
  61. void Rewardable::Info::init(const JsonNode & objectConfig, const std::string & objectName)
  62. {
  63. objectTextID = objectName;
  64. auto loadString = [&](const JsonNode & entry, const TextIdentifier & textID){
  65. if (entry.isString() && !entry.String().empty() && entry.String()[0] != '@')
  66. LIBRARY->generaltexth->registerString(entry.getModScope(), textID, entry);
  67. };
  68. parameters = objectConfig;
  69. for(size_t i = 0; i < parameters["rewards"].Vector().size(); ++i)
  70. {
  71. const JsonNode message = parameters["rewards"][i]["message"];
  72. loadString(message, TextIdentifier(objectName, "rewards", i));
  73. }
  74. for(size_t i = 0; i < parameters["onVisited"].Vector().size(); ++i)
  75. {
  76. const JsonNode message = parameters["onVisited"][i]["message"];
  77. loadString(message, TextIdentifier(objectName, "onVisited", i));
  78. }
  79. for(size_t i = 0; i < parameters["onEmpty"].Vector().size(); ++i)
  80. {
  81. const JsonNode message = parameters["onEmpty"][i]["message"];
  82. loadString(message, TextIdentifier(objectName, "onEmpty", i));
  83. }
  84. loadString(parameters["onSelectMessage"], TextIdentifier(objectName, "onSelect"));
  85. loadString(parameters["description"], TextIdentifier(objectName, "description"));
  86. loadString(parameters["notVisitedTooltip"], TextIdentifier(objectName, "notVisitedText"));
  87. loadString(parameters["visitedTooltip"], TextIdentifier(objectName, "visitedTooltip"));
  88. loadString(parameters["onVisitedMessage"], TextIdentifier(objectName, "onVisited"));
  89. loadString(parameters["onEmptyMessage"], TextIdentifier(objectName, "onEmpty"));
  90. loadString(parameters["onGuardedMessage"], TextIdentifier(objectName, "onGuarded"));
  91. }
  92. Rewardable::LimitersList Rewardable::Info::configureSublimiters(Rewardable::Configuration & object, vstd::RNG & rng, IGameCallback * cb, const JsonNode & source) const
  93. {
  94. Rewardable::LimitersList result;
  95. for (const auto & input : source.Vector())
  96. {
  97. auto newLimiter = std::make_shared<Rewardable::Limiter>();
  98. configureLimiter(object, rng, cb, *newLimiter, input);
  99. result.push_back(newLimiter);
  100. }
  101. return result;
  102. }
  103. void Rewardable::Info::configureLimiter(Rewardable::Configuration & object, vstd::RNG & rng, IGameCallback * cb, Rewardable::Limiter & limiter, const JsonNode & source) const
  104. {
  105. auto const & variables = object.variables.values;
  106. JsonRandom randomizer(cb);
  107. limiter.dayOfWeek = randomizer.loadValue(source["dayOfWeek"], rng, variables);
  108. limiter.daysPassed = randomizer.loadValue(source["daysPassed"], rng, variables);
  109. limiter.heroExperience = randomizer.loadValue(source["heroExperience"], rng, variables);
  110. limiter.heroLevel = randomizer.loadValue(source["heroLevel"], rng, variables);
  111. limiter.canLearnSkills = source["canLearnSkills"].Bool();
  112. limiter.commanderAlive = source["commanderAlive"].Bool();
  113. limiter.hasExtraCreatures = source["hasExtraCreatures"].Bool();
  114. limiter.manaPercentage = randomizer.loadValue(source["manaPercentage"], rng, variables);
  115. limiter.manaPoints = randomizer.loadValue(source["manaPoints"], rng, variables);
  116. limiter.resources = randomizer.loadResources(source["resources"], rng, variables);
  117. limiter.primary = randomizer.loadPrimaries(source["primary"], rng, variables);
  118. limiter.secondary = randomizer.loadSecondaries(source["secondary"], rng, variables);
  119. limiter.artifacts = randomizer.loadArtifacts(source["artifacts"], rng, variables);
  120. limiter.availableSlots = randomizer.loadArtifactSlots(source["availableSlots"], rng, variables);
  121. limiter.spells = randomizer.loadSpells(source["spells"], rng, variables);
  122. limiter.scrolls = randomizer.loadSpells(source["scrolls"], rng, variables);
  123. limiter.canLearnSpells = randomizer.loadSpells(source["canLearnSpells"], rng, variables);
  124. limiter.creatures = randomizer.loadCreatures(source["creatures"], rng, variables);
  125. limiter.canReceiveCreatures = randomizer.loadCreatures(source["canReceiveCreatures"], rng, variables);
  126. limiter.players = randomizer.loadColors(source["colors"], rng, variables);
  127. limiter.heroes = randomizer.loadHeroes(source["heroes"], rng);
  128. limiter.heroClasses = randomizer.loadHeroClasses(source["heroClasses"], rng);
  129. limiter.allOf = configureSublimiters(object, rng, cb, source["allOf"] );
  130. limiter.anyOf = configureSublimiters(object, rng, cb, source["anyOf"] );
  131. limiter.noneOf = configureSublimiters(object, rng, cb, source["noneOf"] );
  132. }
  133. void Rewardable::Info::configureReward(Rewardable::Configuration & object, vstd::RNG & rng, IGameCallback * cb, Rewardable::Reward & reward, const JsonNode & source) const
  134. {
  135. auto const & variables = object.variables.values;
  136. JsonRandom randomizer(cb);
  137. reward.resources = randomizer.loadResources(source["resources"], rng, variables);
  138. reward.heroExperience = randomizer.loadValue(source["heroExperience"], rng, variables);
  139. reward.heroLevel = randomizer.loadValue(source["heroLevel"], rng, variables);
  140. reward.manaDiff = randomizer.loadValue(source["manaPoints"], rng, variables);
  141. reward.manaOverflowFactor = randomizer.loadValue(source["manaOverflowFactor"], rng, variables);
  142. reward.manaPercentage = randomizer.loadValue(source["manaPercentage"], rng, variables, -1);
  143. reward.movePoints = randomizer.loadValue(source["movePoints"], rng, variables);
  144. reward.movePercentage = randomizer.loadValue(source["movePercentage"], rng, variables, -1);
  145. reward.removeObject = source["removeObject"].Bool();
  146. reward.heroBonuses = randomizer.loadBonuses(source["bonuses"]);
  147. reward.commanderBonuses = randomizer.loadBonuses(source["commanderBonuses"]);
  148. reward.playerBonuses = randomizer.loadBonuses(source["playerBonuses"]);
  149. reward.guards = randomizer.loadCreatures(source["guards"], rng, variables);
  150. reward.primary = randomizer.loadPrimaries(source["primary"], rng, variables);
  151. reward.secondary = randomizer.loadSecondaries(source["secondary"], rng, variables);
  152. reward.grantedArtifacts = randomizer.loadArtifacts(source["artifacts"], rng, variables);
  153. reward.takenArtifacts = randomizer.loadArtifacts(source["takenArtifacts"], rng, variables);
  154. reward.takenArtifactSlots = randomizer.loadArtifactSlots(source["takenArtifactSlots"], rng, variables);
  155. reward.grantedScrolls = randomizer.loadSpells(source["scrolls"], rng, variables);
  156. reward.takenScrolls = randomizer.loadSpells(source["takenScrolls"], rng, variables);
  157. reward.spells = randomizer.loadSpells(source["spells"], rng, variables);
  158. reward.creatures = randomizer.loadCreatures(source["creatures"], rng, variables);
  159. reward.takenCreatures = randomizer.loadCreatures(source["takenCreatures"], rng, variables);
  160. if(!source["spellCast"].isNull() && source["spellCast"].isStruct())
  161. {
  162. reward.spellCast.first = randomizer.loadSpell(source["spellCast"]["spell"], rng, variables);
  163. reward.spellCast.second = source["spellCast"]["schoolLevel"].Integer();
  164. }
  165. if (!source["revealTiles"].isNull())
  166. {
  167. auto const & entry = source["revealTiles"];
  168. reward.revealTiles = RewardRevealTiles();
  169. reward.revealTiles->radius = randomizer.loadValue(entry["radius"], rng, variables);
  170. reward.revealTiles->hide = entry["hide"].Bool();
  171. reward.revealTiles->scoreSurface = randomizer.loadValue(entry["surface"], rng, variables);
  172. reward.revealTiles->scoreSubterra = randomizer.loadValue(entry["subterra"], rng, variables);
  173. reward.revealTiles->scoreWater = randomizer.loadValue(entry["water"], rng, variables);
  174. reward.revealTiles->scoreRock = randomizer.loadValue(entry["rock"], rng, variables);
  175. }
  176. for ( auto node : source["changeCreatures"].Struct() )
  177. {
  178. CreatureID from(LIBRARY->identifiers()->getIdentifier(node.second.getModScope(), "creature", node.first).value());
  179. CreatureID dest(LIBRARY->identifiers()->getIdentifier(node.second.getModScope(), "creature", node.second.String()).value());
  180. reward.extraComponents.emplace_back(ComponentType::CREATURE, dest);
  181. reward.creaturesChange[from] = dest;
  182. }
  183. }
  184. void Rewardable::Info::configureResetInfo(Rewardable::Configuration & object, vstd::RNG & rng, Rewardable::ResetInfo & resetParameters, const JsonNode & source) const
  185. {
  186. resetParameters.period = static_cast<ui32>(source["period"].Float());
  187. resetParameters.visitors = source["visitors"].Bool();
  188. resetParameters.rewards = source["rewards"].Bool();
  189. }
  190. void Rewardable::Info::configureVariables(Rewardable::Configuration & object, vstd::RNG & rng, IGameCallback * cb, const JsonNode & source) const
  191. {
  192. JsonRandom randomizer(cb);
  193. for(const auto & category : source.Struct())
  194. {
  195. for(const auto & entry : category.second.Struct())
  196. {
  197. JsonNode preset = object.getPresetVariable(category.first, entry.first);
  198. const JsonNode & input = preset.isNull() ? entry.second : preset;
  199. int32_t value = -1;
  200. if (category.first == "number")
  201. value = randomizer.loadValue(input, rng, object.variables.values);
  202. if (category.first == "artifact")
  203. value = randomizer.loadArtifact(input, rng, object.variables.values).getNum();
  204. if (category.first == "spell")
  205. value = randomizer.loadSpell(input, rng, object.variables.values).getNum();
  206. if (category.first == "primarySkill")
  207. value = randomizer.loadPrimary(input, rng, object.variables.values).getNum();
  208. if (category.first == "secondarySkill")
  209. value = randomizer.loadSecondary(input, rng, object.variables.values).getNum();
  210. object.initVariable(category.first, entry.first, value);
  211. }
  212. }
  213. }
  214. void Rewardable::Info::replaceTextPlaceholders(MetaString & target, const Variables & variables) const
  215. {
  216. for (const auto & variable : variables.values )
  217. {
  218. if( boost::algorithm::starts_with(variable.first, "spell"))
  219. target.replaceName(SpellID(variable.second));
  220. if( boost::algorithm::starts_with(variable.first, "secondarySkill"))
  221. target.replaceName(SecondarySkill(variable.second));
  222. }
  223. }
  224. void Rewardable::Info::replaceTextPlaceholders(MetaString & target, const Variables & variables, const VisitInfo & info) const
  225. {
  226. if (!info.reward.guards.empty())
  227. {
  228. replaceTextPlaceholders(target, variables);
  229. CreatureID strongest = info.reward.guards.at(0).getId();
  230. for (const auto & guard : info.reward.guards )
  231. {
  232. if (strongest.toEntity(LIBRARY)->getFightValue() < guard.getId().toEntity(LIBRARY)->getFightValue())
  233. strongest = guard.getId();
  234. }
  235. target.replaceNamePlural(strongest); // FIXME: use singular if only 1 such unit is in guards
  236. MetaString loot;
  237. for (GameResID it : GameResID::ALL_RESOURCES())
  238. {
  239. if (info.reward.resources[it] != 0)
  240. {
  241. loot.appendRawString("%d %s");
  242. loot.replaceNumber(info.reward.resources[it]);
  243. loot.replaceName(it);
  244. }
  245. }
  246. for (const auto & artifact : info.reward.grantedArtifacts )
  247. {
  248. loot.appendRawString("%s");
  249. loot.replaceName(artifact);
  250. }
  251. for (const auto & scroll : info.reward.grantedScrolls )
  252. {
  253. loot.appendRawString("%s");
  254. loot.replaceName(scroll);
  255. }
  256. for (const auto & spell : info.reward.spells )
  257. {
  258. loot.appendRawString("%s");
  259. loot.replaceName(spell);
  260. }
  261. for (const auto & secondary : info.reward.secondary )
  262. {
  263. loot.appendRawString("%s");
  264. loot.replaceName(secondary.first);
  265. }
  266. target.replaceRawString(loot.buildList());
  267. }
  268. else
  269. {
  270. for (const auto & artifact : info.reward.grantedArtifacts )
  271. target.replaceName(artifact);
  272. for (const auto & scroll : info.reward.grantedScrolls )
  273. target.replaceName(scroll);
  274. for (const auto & spell : info.reward.spells )
  275. target.replaceName(spell);
  276. for (const auto & secondary : info.reward.secondary )
  277. target.replaceName(secondary.first);
  278. replaceTextPlaceholders(target, variables);
  279. }
  280. }
  281. void Rewardable::Info::configureRewards(
  282. Rewardable::Configuration & object,
  283. vstd::RNG & rng,
  284. IGameCallback * cb,
  285. const JsonNode & source,
  286. Rewardable::EEventType event,
  287. const std::string & modeName) const
  288. {
  289. for(size_t i = 0; i < source.Vector().size(); ++i)
  290. {
  291. const JsonNode & reward = source.Vector().at(i);
  292. if (!reward["appearChance"].isNull())
  293. {
  294. const JsonNode & chance = reward["appearChance"];
  295. std::string diceID = std::to_string(chance["dice"].Integer());
  296. auto diceValue = object.getVariable("dice", diceID);
  297. if (!diceValue.has_value())
  298. {
  299. const JsonNode & preset = object.getPresetVariable("dice", diceID);
  300. if (preset.isNull())
  301. object.initVariable("dice", diceID, rng.nextInt(0, 99));
  302. else
  303. object.initVariable("dice", diceID, preset.Integer());
  304. diceValue = object.getVariable("dice", diceID);
  305. }
  306. assert(diceValue.has_value());
  307. if (!chance["min"].isNull())
  308. {
  309. int min = static_cast<int>(chance["min"].Float());
  310. if (min > *diceValue)
  311. continue;
  312. }
  313. if (!chance["max"].isNull())
  314. {
  315. int max = static_cast<int>(chance["max"].Float());
  316. if (max <= *diceValue)
  317. continue;
  318. }
  319. }
  320. Rewardable::VisitInfo info;
  321. configureLimiter(object, rng, cb, info.limiter, reward["limiter"]);
  322. configureReward(object, rng, cb, info.reward, reward);
  323. info.visitType = event;
  324. info.message = loadMessage(reward["message"], TextIdentifier(objectTextID, modeName, i));
  325. info.description = loadMessage(reward["description"], TextIdentifier(objectTextID, "description", modeName, i), EMetaText::GENERAL_TXT);
  326. replaceTextPlaceholders(info.message, object.variables, info);
  327. replaceTextPlaceholders(info.description, object.variables, info);
  328. object.info.push_back(info);
  329. }
  330. }
  331. void Rewardable::Info::configureObject(Rewardable::Configuration & object, vstd::RNG & rng, IGameCallback * cb) const
  332. {
  333. object.info.clear();
  334. object.variables.values.clear();
  335. configureVariables(object, rng, cb, parameters["variables"]);
  336. configureRewards(object, rng, cb, parameters["rewards"], Rewardable::EEventType::EVENT_FIRST_VISIT, "rewards");
  337. configureRewards(object, rng, cb, parameters["onVisited"], Rewardable::EEventType::EVENT_ALREADY_VISITED, "onVisited");
  338. configureRewards(object, rng, cb, parameters["onEmpty"], Rewardable::EEventType::EVENT_NOT_AVAILABLE, "onEmpty");
  339. object.onSelect = loadMessage(parameters["onSelectMessage"], TextIdentifier(objectTextID, "onSelect"));
  340. object.description = loadMessage(parameters["description"], TextIdentifier(objectTextID, "description"));
  341. object.notVisitedTooltip = loadMessage(parameters["notVisitedTooltip"], TextIdentifier(objectTextID, "notVisitedTooltip"), EMetaText::GENERAL_TXT);
  342. object.visitedTooltip = loadMessage(parameters["visitedTooltip"], TextIdentifier(objectTextID, "visitedTooltip"), EMetaText::GENERAL_TXT);
  343. if (object.notVisitedTooltip.empty())
  344. object.notVisitedTooltip.appendTextID("core.genrltxt.353");
  345. if (object.visitedTooltip.empty())
  346. object.visitedTooltip.appendTextID("core.genrltxt.352");
  347. if (!parameters["onVisitedMessage"].isNull())
  348. {
  349. Rewardable::VisitInfo onVisited;
  350. onVisited.visitType = Rewardable::EEventType::EVENT_ALREADY_VISITED;
  351. onVisited.message = loadMessage(parameters["onVisitedMessage"], TextIdentifier(objectTextID, "onVisited"));
  352. replaceTextPlaceholders(onVisited.message, object.variables);
  353. object.info.push_back(onVisited);
  354. }
  355. if (!parameters["onEmptyMessage"].isNull())
  356. {
  357. Rewardable::VisitInfo onEmpty;
  358. onEmpty.visitType = Rewardable::EEventType::EVENT_NOT_AVAILABLE;
  359. onEmpty.message = loadMessage(parameters["onEmptyMessage"], TextIdentifier(objectTextID, "onEmpty"));
  360. replaceTextPlaceholders(onEmpty.message, object.variables);
  361. object.info.push_back(onEmpty);
  362. }
  363. if (!parameters["onGuardedMessage"].isNull())
  364. {
  365. Rewardable::VisitInfo onGuarded;
  366. onGuarded.visitType = Rewardable::EEventType::EVENT_GUARDED;
  367. onGuarded.message = loadMessage(parameters["onGuardedMessage"], TextIdentifier(objectTextID, "onGuarded"));
  368. replaceTextPlaceholders(onGuarded.message, object.variables);
  369. object.info.push_back(onGuarded);
  370. }
  371. configureResetInfo(object, rng, object.resetParameters, parameters["resetParameters"]);
  372. object.canRefuse = parameters["canRefuse"].Bool();
  373. object.showScoutedPreview = parameters["showScoutedPreview"].Bool();
  374. object.forceCombat = parameters["forceCombat"].Bool();
  375. object.guardsLayout = parameters["guardsLayout"].String();
  376. object.coastVisitable = parameters["coastVisitable"].Bool();
  377. if(parameters["showInInfobox"].isNull())
  378. object.infoWindowType = EInfoWindowMode::AUTO;
  379. else
  380. object.infoWindowType = parameters["showInInfobox"].Bool() ? EInfoWindowMode::INFO : EInfoWindowMode::MODAL;
  381. auto visitMode = parameters["visitMode"].String();
  382. for(int i = 0; i < Rewardable::VisitModeString.size(); ++i)
  383. {
  384. if(Rewardable::VisitModeString[i] == visitMode)
  385. {
  386. object.visitMode = static_cast<EVisitMode>(i);
  387. break;
  388. }
  389. }
  390. auto selectMode = parameters["selectMode"].String();
  391. for(int i = 0; i < Rewardable::SelectModeString.size(); ++i)
  392. {
  393. if(Rewardable::SelectModeString[i] == selectMode)
  394. {
  395. object.selectMode = static_cast<ESelectMode>(i);
  396. break;
  397. }
  398. }
  399. if (object.visitMode == Rewardable::VISIT_LIMITER)
  400. configureLimiter(object, rng, cb, object.visitLimiter, parameters["visitLimiter"]);
  401. }
  402. bool Rewardable::Info::givesResources() const
  403. {
  404. return testForKey(parameters, "resources");
  405. }
  406. bool Rewardable::Info::givesExperience() const
  407. {
  408. return testForKey(parameters, "gainedExp") || testForKey(parameters, "gainedLevels");
  409. }
  410. bool Rewardable::Info::givesMana() const
  411. {
  412. return testForKey(parameters, "manaPoints") || testForKey(parameters, "manaPercentage");
  413. }
  414. bool Rewardable::Info::givesMovement() const
  415. {
  416. return testForKey(parameters, "movePoints") || testForKey(parameters, "movePercentage");
  417. }
  418. bool Rewardable::Info::givesPrimarySkills() const
  419. {
  420. return testForKey(parameters, "primary");
  421. }
  422. bool Rewardable::Info::givesSecondarySkills() const
  423. {
  424. return testForKey(parameters, "secondary");
  425. }
  426. bool Rewardable::Info::givesArtifacts() const
  427. {
  428. return testForKey(parameters, "artifacts");
  429. }
  430. bool Rewardable::Info::givesCreatures() const
  431. {
  432. return testForKey(parameters, "spells");
  433. }
  434. bool Rewardable::Info::givesSpells() const
  435. {
  436. return testForKey(parameters, "creatures");
  437. }
  438. bool Rewardable::Info::givesBonuses() const
  439. {
  440. return testForKey(parameters, "bonuses");
  441. }
  442. bool Rewardable::Info::hasGuards() const
  443. {
  444. return testForKey(parameters, "guards");
  445. }
  446. const JsonNode & Rewardable::Info::getParameters() const
  447. {
  448. return parameters;
  449. }
  450. VCMI_LIB_NAMESPACE_END