Info.cpp 19 KB

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