Function Summon

OsiInterface/Functions/GameActionFunctions.cpp:349–421

		}

		bool Summon(OsiArgumentDesc & args)
		{
			auto character = FindCharacterByNameGuid(args[0].String);
			if (character == nullptr) {
				OsiError("Character '" << args[0].String << "' does not exist!");
				return false;
			}

			auto objectTemplate = NameGuidToFixedString(args[1].String);
			if (!objectTemplate) {
				OsiError("Template '" << args[1].String << "' not in FixedString table!");
				return false;
			}

			auto const & lib = gOsirisProxy->GetLibraryManager();
			if (lib.SummonHelpersSummon == nullptr) {
				OsiError("Summon helper symbols not available in library manager");
				return false;
			}

			auto pos = args.GetVector(2);
			auto lifetime = args[5].Float;
			auto summonLevel = args[6].Int32;
			auto isTotem = args[7].Int32 != 0;
			auto mapToAiGrid = args[8].Int32 != 0;

			if (pos.x == -1.0f && pos.y == -1.0f && pos.z == -1.0f) {
				pos = character->WorldPos;
			}

			esv::SummonHelperResults results;
			esv::SummonHelperSummonArgs summonArgs;

			ObjectHandle characterHandle;
			character->GetObjectHandle(&characterHandle);
			summonArgs.OwnerCharacterHandle = characterHandle;
			summonArgs.GameObjectTemplateFS = objectTemplate;
			summonArgs.Level = *character->GetCurrentLevel();
			summonArgs.Position = pos;
			summonArgs.SummonLevel = summonLevel;
			summonArgs.Lifetime = lifetime;
			summonArgs.IsTotem = isTotem;
			summonArgs.MapToAiGrid = mapToAiGrid;

			lib.SummonHelpersSummon(&results, &summonArgs);
			if (results.SummonHandle) {
				FixedString guid;

				auto summonCharacter = FindCharacterByHandle(results.SummonHandle);
				if (summonCharacter != nullptr) {
					guid = *summonCharacter->GetGuid();
				}
				else {
					auto summonItem = FindItemByHandle(results.SummonHandle);
					if (summonItem != nullptr) {
						guid = *summonItem->GetGuid();
					}
				}