Method loadPlayerScript

src/qtscript.cpp:531–686

}

wzapi::scripting_instance* scripting_engine::loadPlayerScript(const WzString& path, int player, AIDifficulty difficulty)
{
	ASSERT_OR_RETURN(nullptr, player >= 0 && (player < MAX_PLAYERS || player == selectedPlayer), "Player index %d out of bounds", player);

	debug(LOG_SCRIPT, "loadPlayerScript[%d]: %s", player, path.toUtf8().c_str());

	int realDifficulty;
	if (game.type == LEVEL_TYPE::SKIRMISH)
	{
		realDifficulty = static_cast<int8_t>(difficulty);
	}
	else // campaign
	{
		realDifficulty = (int)getDifficultyLevel();
	}

	wzapi::scripting_instance* pNewInstance = loadPlayerScriptByBackend(path, player, realDifficulty);
	if (!pNewInstance)
	{
		// failed to create new scripting instance
		debug(LOG_ERROR, "Failed to create new scripting instance: path:\"%s\", player: %d, difficulty: %d", path.toUtf8().c_str(), player, static_cast<int>(difficulty));
		return nullptr;
	}

	// Create group map
	GROUPMAP *psMap = new GROUPMAP;
	auto insert_result = groups.insert(ENGINEMAP::value_type(pNewInstance, psMap));
	ASSERT(insert_result.second, "Entry for this engine %p already exists in ENGINEMAP!", static_cast<void *>(pNewInstance));

	json globalVars = json::object();
	// Special global variables
	//== * ```version``` Current version of the game, set in *major.minor* format.
	globalVars["version"] = version_getVersionString();
	//== * ```selectedPlayer``` The player controlled by the client on which the script runs.
	globalVars["selectedPlayer"] = selectedPlayer;
	//== * ```gameTime``` The current game time. Updated before every invokation of a script.
	pNewInstance->setSpecifiedGlobalVariable("gameTime", gameTime, wzapi::GlobalVariableFlags::ReadOnlyUpdatedFromApp | wzapi::GlobalVariableFlags::DoNotSave);
	//== * ```modList``` An array of the current loaded mods (mod names).
	globalVars["modList"] = getModNamesList();


	//== * ```difficulty``` The currently set campaign difficulty, or the current AI's difficulty setting. It will be one of
	//== ```SUPEREASY``` (campaign only), ```EASY```, ```MEDIUM```, ```HARD``` or ```INSANE```.
	if (game.type == LEVEL_TYPE::SKIRMISH)
	{
		globalVars["difficulty"] = static_cast<int8_t>(difficulty);
	}
	else // campaign
	{
		globalVars["difficulty"] = (int)getDifficultyLevel();
	}
	//== * ```mapName``` The name of the current map.
	globalVars["mapName"] = game.map;
	//== * ```tilesetType``` The area name of the map.
	std::string tilesetType("CUSTOM");
	switch (currentMapTileset)
	{
		case MAP_TILESET::ARIZONA: