* @copyright 2014 ManiaControl Team * @license http://www.gnu.org/licenses/ GNU General Public License, Version 3 */ class MapManager implements CallbackListener { /* * Constants */ const TABLE_MAPS = 'mc_maps'; const CB_MAPS_UPDATED = 'MapManager.MapsUpdated'; const CB_KARMA_UPDATED = 'MapManager.KarmaUpdated'; const SETTING_PERMISSION_ADD_MAP = 'Add Maps'; const SETTING_PERMISSION_REMOVE_MAP = 'Remove Maps'; const SETTING_PERMISSION_ERASE_MAP = 'Erase Maps'; const SETTING_PERMISSION_SHUFFLE_MAPS = 'Shuffle Maps'; const SETTING_PERMISSION_CHECK_UPDATE = 'Check Map Update'; const SETTING_PERMISSION_SKIP_MAP = 'Skip Map'; const SETTING_PERMISSION_RESTART_MAP = 'Restart Map'; const SETTING_AUTOSAVE_MAPLIST = 'Autosave Maplist file'; const SETTING_MAPLIST_FILE = 'File to write Maplist in'; const SETTING_WRITE_OWN_MAPLIST_FILE = 'Write a own Maplist File for every Server called serverlogin.txt'; /* * Public properties */ /** @var MapQueue $mapQueue */ /** @deprecated see getMapQueue() */ public $mapQueue = null; /** @var MapCommands $mapCommands */ /** @deprecated see getMapCommands() */ public $mapCommands = null; /** @var MapActions $mapActions */ /** @deprecated see getMapActions() */ public $mapActions = null; /** @var MapList $mapList */ /** @deprecated see getMapList() */ public $mapList = null; /** @var DirectoryBrowser $directoryBrowser */ /** @deprecated see getDirectoryBrowser() */ public $directoryBrowser = null; /** @var ManiaExchangeList $mxList */ /** @deprecated see getMXList() */ public $mxList = null; /** @var ManiaExchangeManager $mxManager */ /** @deprecated see getMXManager() */ public $mxManager = null; /* * Private properties */ /** @var ManiaControl $maniaControl */ private $maniaControl = null; /** @var Map[] $maps */ private $maps = array(); /** @var Map $currentMap */ private $currentMap = null; private $mapEnded = false; private $mapBegan = false; /** * Construct a new map manager instance * * @param ManiaControl $maniaControl */ public function __construct(ManiaControl $maniaControl) { $this->maniaControl = $maniaControl; $this->initTables(); // Children $this->mxManager = new ManiaExchangeManager($this->maniaControl); $this->mapList = new MapList($this->maniaControl); $this->directoryBrowser = new DirectoryBrowser($this->maniaControl); $this->mxList = new ManiaExchangeList($this->maniaControl); $this->mapCommands = new MapCommands($maniaControl); $this->mapQueue = new MapQueue($this->maniaControl); $this->mapActions = new MapActions($maniaControl); // Callbacks $this->maniaControl->getCallbackManager()->registerCallbackListener(Callbacks::ONINIT, $this, 'handleOnInit'); $this->maniaControl->getCallbackManager()->registerCallbackListener(Callbacks::AFTERINIT, $this, 'handleAfterInit'); $this->maniaControl->getCallbackManager()->registerCallbackListener(CallbackManager::CB_MP_MAPLISTMODIFIED, $this, 'mapsModified'); // Permissions $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_ADD_MAP, AuthenticationManager::AUTH_LEVEL_ADMIN); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_REMOVE_MAP, AuthenticationManager::AUTH_LEVEL_ADMIN); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_ERASE_MAP, AuthenticationManager::AUTH_LEVEL_SUPERADMIN); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_SHUFFLE_MAPS, AuthenticationManager::AUTH_LEVEL_ADMIN); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_CHECK_UPDATE, AuthenticationManager::AUTH_LEVEL_MODERATOR); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_SKIP_MAP, AuthenticationManager::AUTH_LEVEL_MODERATOR); $this->maniaControl->getAuthenticationManager()->definePermissionLevel(self::SETTING_PERMISSION_RESTART_MAP, AuthenticationManager::AUTH_LEVEL_MODERATOR); // Settings $this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_AUTOSAVE_MAPLIST, true); $this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_MAPLIST_FILE, "MatchSettings/tracklist.txt"); $this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_WRITE_OWN_MAPLIST_FILE, false); } /** * Initialize necessary database tables * * @return bool */ private function initTables() { $mysqli = $this->maniaControl->getDatabase()->getMysqli(); $query = "CREATE TABLE IF NOT EXISTS `" . self::TABLE_MAPS . "` ( `index` int(11) NOT NULL AUTO_INCREMENT, `mxid` int(11), `uid` varchar(50) NOT NULL, `name` varchar(150) NOT NULL, `authorLogin` varchar(100) NOT NULL, `fileName` varchar(100) NOT NULL, `environment` varchar(50) NOT NULL, `mapType` varchar(50) NOT NULL, `changed` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`index`), UNIQUE KEY `uid` (`uid`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci COMMENT='Map Data' AUTO_INCREMENT=1;"; $result = $mysqli->query($query); if ($mysqli->error) { trigger_error($mysqli->error, E_USER_ERROR); return false; } return $result; } /** * Return the map commands * * @return MapCommands */ public function getMapCommands() { return $this->mapCommands; } /** * Return the map actions * * @return MapActions */ public function getMapActions() { return $this->mapActions; } /** * Return the map list * * @return MapList */ public function getMapList() { return $this->mapList; } /** * Return the directory browser * * @return DirectoryBrowser */ public function getDirectoryBrowser() { return $this->directoryBrowser; } /** * Return the mx list * * @return ManiaExchangeList */ public function getMXList() { return $this->mxList; } /** * Update a Map from Mania Exchange * * @param Player $admin * @param string $uid */ public function updateMap(Player $admin, $uid) { $this->updateMapTimestamp($uid); if (!isset($uid) || !isset($this->maps[$uid])) { $this->maniaControl->getChat()->sendError("Error updating Map: Unknown UID '{$uid}'!", $admin); return; } /** @var Map $map */ $map = $this->maps[$uid]; $mxId = $map->mx->id; $this->removeMap($admin, $uid, true, false); $this->addMapFromMx($mxId, $admin->login, true); } /** * Update the Timestamp of a Map * * @param string $uid * @return bool */ private function updateMapTimestamp($uid) { $mysqli = $this->maniaControl->getDatabase()->getMysqli(); $mapQuery = "UPDATE `" . self::TABLE_MAPS . "` SET mxid = 0, changed = NOW() WHERE 'uid' = ?"; $mapStatement = $mysqli->prepare($mapQuery); if ($mysqli->error) { trigger_error($mysqli->error); return false; } $mapStatement->bind_param('s', $uid); $mapStatement->execute(); if ($mapStatement->error) { trigger_error($mapStatement->error); $mapStatement->close(); return false; } $mapStatement->close(); return true; } /** * Remove a Map * * @param Player $admin * @param string $uid * @param bool $eraseFile * @param bool $message */ public function removeMap(Player $admin, $uid, $eraseFile = false, $message = true) { if (!isset($this->maps[$uid])) { $this->maniaControl->getChat()->sendError('Map does not exist!', $admin); return; } /** @var Map $map */ $map = $this->maps[$uid]; // Unset the Map everywhere $this->getMapQueue()->removeFromMapQueue($admin, $map->uid); if ($map->mx) { $this->getMXManager()->unsetMap($map->mx->id); } // Remove map try { $this->maniaControl->getClient()->removeMap($map->fileName); } catch (NotInListException $e) { } catch (FileException $e) { } unset($this->maps[$uid]); if ($eraseFile) { // Check if ManiaControl can even write to the maps dir $mapDir = $this->maniaControl->getClient()->getMapsDirectory(); if ($this->maniaControl->getServer()->checkAccess($mapDir) ) { // Delete map file if (!@unlink($mapDir . $map->fileName)) { $this->maniaControl->getChat()->sendError("Couldn't erase the map file.", $admin); $eraseFile = false; } } else { $this->maniaControl->getChat()->sendError("Couldn't erase the map file (no access).", $admin); $eraseFile = false; } } // Show Message if ($message) { $action = ($eraseFile ? 'erased' : 'removed'); $message = $admin->getEscapedNickname() . ' ' . $action . ' ' . $map->getEscapedName() . '!'; $this->maniaControl->getChat()->sendSuccess($message); Logger::logInfo($message, true); } } /** * Return the map queue * * @return MapQueue */ public function getMapQueue() { return $this->mapQueue; } /** * Return the mx manager * * @return ManiaExchangeManager */ public function getMXManager() { return $this->mxManager; } /** * Adds a Map from Mania Exchange * * @param int $mapId * @param string $login * @param bool $update */ public function addMapFromMx($mapId, $login, $update = false) { if (is_numeric($mapId)) { // Check if map exists $this->maniaControl->getMapManager()->getMXManager()->fetchMapInfo($mapId, function (MXMapInfo $mapInfo = null) use ( &$login, &$update ) { if (!$mapInfo || !isset($mapInfo->uploaded)) { // Invalid id $this->maniaControl->getChat()->sendError('Invalid MX-Id!', $login); return; } // Download the file $this->maniaControl->getFileReader()->loadFile($mapInfo->downloadurl, function ($file, $error) use ( &$login, &$mapInfo, &$update ) { if (!$file || $error) { // Download error $this->maniaControl->getChat()->sendError("Download failed: '{$error}'!", $login); return; } $this->processMapFile($file, $mapInfo, $login, $update); }); }); } } /** * Process the MapFile * * @param string $file * @param MXMapInfo $mapInfo * @param string $login * @param bool $update * @throws InvalidArgumentException */ private function processMapFile($file, MXMapInfo $mapInfo, $login, $update) { // Check if map is already on the server if ($this->getMapByUid($mapInfo->uid)) { $this->maniaControl->getChat()->sendError('Map is already on the server!', $login); return; } // Save map $fileName = $mapInfo->id . '_' . $mapInfo->name . '.Map.Gbx'; $fileName = FileUtil::getClearedFileName($fileName); $downloadFolderName = $this->maniaControl->getSettingManager()->getSettingValue($this, 'MapDownloadDirectory', 'MX'); $relativeMapFileName = $downloadFolderName . DIRECTORY_SEPARATOR . $fileName; $mapDir = $this->maniaControl->getServer()->getDirectory()->getMapsFolder(); $downloadDirectory = $mapDir . $downloadFolderName . DIRECTORY_SEPARATOR; $fullMapFileName = $downloadDirectory . $fileName; // Check if it can get written locally if ($this->maniaControl->getServer()->checkAccess($mapDir)) { // Create download directory if necessary if (!is_dir($downloadDirectory) && !mkdir($downloadDirectory) || !is_writable($downloadDirectory)) { $this->maniaControl->getChat()->sendError("ManiaControl doesn't have to rights to save maps in '{$downloadDirectory}'.", $login); return; } if (!file_put_contents($fullMapFileName, $file)) { // Save error $this->maniaControl->getChat()->sendError('Saving map failed!', $login); return; } } else { // Write map via write file method try { $this->maniaControl->getClient()->writeFile($relativeMapFileName, $file); } catch (InvalidArgumentException $e) { if ($e->getMessage() === 'data are too big') { $this->maniaControl->getChat()->sendError("Map is too big for a remote save.", $login); return; } throw $e; } } // Check for valid map try { $this->maniaControl->getClient()->checkMapForCurrentServerParams($relativeMapFileName); } catch (InvalidMapException $exception) { $this->maniaControl->getChat()->sendException($exception, $login); return; } catch (FileException $exception) { $this->maniaControl->getChat()->sendException($exception, $login); return; } // Add map to map list try { $this->maniaControl->getClient()->insertMap($relativeMapFileName); } catch (AlreadyInListException $exception) { $this->maniaControl->getChat()->sendException($exception, $login); return; } $this->updateFullMapList(); // Update Mx MapInfo $this->maniaControl->getMapManager()->getMXManager()->updateMapObjectsWithManiaExchangeIds(array($mapInfo)); // Update last updated time $map = $this->getMapByUid($mapInfo->uid); if (!$map) { // TODO: improve this - error reports about not existing maps $this->maniaControl->getErrorHandler()->triggerDebugNotice('Map not in List after Insert!'); $this->maniaControl->getChat()->sendError('Server Error!', $login); return; } $map->lastUpdate = time(); $player = $this->maniaControl->getPlayerManager()->getPlayer($login); if (!$update) { // Message $message = $player->getEscapedNickname() . ' added $<' . $mapInfo->name . '$>!'; $this->maniaControl->getChat()->sendSuccess($message); Logger::logInfo($message, true); // Queue requested Map $this->maniaControl->getMapManager()->getMapQueue()->addMapToMapQueue($login, $mapInfo->uid); } else { $message = $player->getEscapedNickname() . ' updated $<' . $mapInfo->name . '$>!'; $this->maniaControl->getChat()->sendSuccess($message); Logger::logInfo($message, true); } } /** * Get Map by UID * * @param string $uid * @return Map */ public function getMapByUid($uid) { if (isset($this->maps[$uid])) { return $this->maps[$uid]; } return null; } /** * Updates the full Map list, needed on Init, addMap and on ShuffleMaps */ private function updateFullMapList() { $tempList = array(); try { $offset = 0; while ($this->maniaControl->getClient()) { $maps = $this->maniaControl->getClient()->getMapList(150, $offset); foreach ($maps as $rpcMap) { if (array_key_exists($rpcMap->uId, $this->maps)) { // Map already exists, only update index $tempList[$rpcMap->uId] = $this->maps[$rpcMap->uId]; } else { // Insert Map Object $map = $this->initializeMap($rpcMap); $tempList[$map->uid] = $map; } } $offset += 150; } } catch (IndexOutOfBoundException $e) { } // restore Sorted MapList $this->maps = $tempList; // Trigger own callback $this->maniaControl->getCallbackManager()->triggerCallback(self::CB_MAPS_UPDATED); // Write MapList if ($this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_AUTOSAVE_MAPLIST) ) { if ($this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_WRITE_OWN_MAPLIST_FILE) ) { $serverLogin = $this->maniaControl->getServer()->login; $matchSettingsFileName = "MatchSettings/{$serverLogin}.txt"; } else { $matchSettingsFileName = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_MAPLIST_FILE); } try { $this->maniaControl->getClient()->saveMatchSettings($matchSettingsFileName); } catch (FileException $e) { Logger::logError("Unable to write the playlist file, please checkout your MX-Folders File permissions!"); } } } /** * Initializes a Map * * @param mixed $rpcMap * @return Map */ public function initializeMap($rpcMap) { $map = new Map($rpcMap); $this->saveMap($map); return $map; } /** * Save a Map in the Database * * @param Map $map * @return bool */ private function saveMap(Map &$map) { //TODO saveMaps for whole maplist at once (usage of prepared statements) $mysqli = $this->maniaControl->getDatabase()->getMysqli(); $mapQuery = "INSERT INTO `" . self::TABLE_MAPS . "` ( `uid`, `name`, `authorLogin`, `fileName`, `environment`, `mapType` ) VALUES ( ?, ?, ?, ?, ?, ? ) ON DUPLICATE KEY UPDATE `index` = LAST_INSERT_ID(`index`), `fileName` = VALUES(`fileName`), `environment` = VALUES(`environment`), `mapType` = VALUES(`mapType`);"; $mapStatement = $mysqli->prepare($mapQuery); if ($mysqli->error) { trigger_error($mysqli->error); return false; } $mapStatement->bind_param('ssssss', $map->uid, $map->rawName, $map->authorLogin, $map->fileName, $map->environment, $map->mapType); $mapStatement->execute(); if ($mapStatement->error) { trigger_error($mapStatement->error); $mapStatement->close(); return false; } $map->index = $mapStatement->insert_id; $mapStatement->close(); return true; } /** * Get's a Map by it's Mania-Exchange Id * * @param int $mxId * @return Map */ public function getMapByMxId($mxId) { foreach ($this->maps as $map) { if ($map->mx && $map->mx->id == $mxId) { return $map; } } return null; } /** * Shuffles the MapList * * @param Player $admin * @return bool */ public function shuffleMapList($admin = null) { $shuffledMaps = $this->maps; shuffle($shuffledMaps); $mapArray = array(); foreach ($shuffledMaps as $map) { /** @var Map $map */ $mapArray[] = $map->fileName; } try { $this->maniaControl->getClient()->chooseNextMapList($mapArray); } catch (Exception $e) { //TODO temp added 19.04.2014 $this->maniaControl->getErrorHandler()->triggerDebugNotice("Exception line 331 MapManager" . $e->getMessage()); trigger_error("Couldn't shuffle mapList. " . $e->getMessage()); return false; } $this->fetchCurrentMap(); if ($admin) { $message = $admin->getEscapedNickname() . ' shuffled the Maplist!'; $this->maniaControl->getChat()->sendSuccess($message); Logger::logInfo($message, true); } // Restructure if needed $this->restructureMapList(); return true; } /** * Freshly fetch current Map * * @return Map */ private function fetchCurrentMap() { try { $rpcMap = $this->maniaControl->getClient()->getCurrentMapInfo(); } catch (UnavailableFeatureException $exception) { return null; } if (array_key_exists($rpcMap->uId, $this->maps)) { $this->currentMap = $this->maps[$rpcMap->uId]; $this->currentMap->nbCheckpoints = $rpcMap->nbCheckpoints; $this->currentMap->nbLaps = $rpcMap->nbLaps; return $this->currentMap; } $this->currentMap = $this->initializeMap($rpcMap); $this->maps[$this->currentMap->uid] = $this->currentMap; return $this->currentMap; } /** * Restructures the Maplist */ public function restructureMapList() { $currentIndex = $this->getMapIndex($this->getCurrentMap()); // No RestructureNeeded if ($currentIndex < Maplist::MAX_MAPS_PER_PAGE - 1) { return true; } $lowerMapArray = array(); $higherMapArray = array(); $index = 0; foreach ($this->maps as $map) { if ($index < $currentIndex) { $lowerMapArray[] = $map->fileName; } else { $higherMapArray[] = $map->fileName; } $index++; } $mapArray = array_merge($higherMapArray, $lowerMapArray); array_shift($mapArray); try { $this->maniaControl->getClient()->chooseNextMapList($mapArray); } catch (Exception $e) { trigger_error("Error restructuring the Maplist. " . $e->getMessage()); return false; } return true; } /** * Returns the MapIndex of a given map * * @param Map $map * @return int */ public function getMapIndex(Map $map) { $maps = $this->getMaps(); return array_search($map, $maps); } /** * Get all Maps * * @param int $offset * @param int $length * @return Map[] */ public function getMaps($offset = null, $length = null) { if ($offset === null) { return array_values($this->maps); } if ($length === null) { return array_slice($this->maps, $offset); } return array_slice($this->maps, $offset, $length); } /** * Get Current Map * * @return Map */ public function getCurrentMap() { if (!$this->currentMap) { return $this->fetchCurrentMap(); } return $this->currentMap; } /** * Handle OnInit callback */ public function handleOnInit() { $this->updateFullMapList(); $this->fetchCurrentMap(); // Restructure Maplist $this->restructureMapList(); } /** * Handle AfterInit callback */ public function handleAfterInit() { // Fetch MX infos $this->getMXManager()->fetchManiaExchangeMapInformation(); } /** * Handle Script BeginMap callback * * @param string $mapUid * @param string $restart */ public function handleScriptBeginMap($mapUid, $restart) { $this->beginMap($mapUid, Formatter::parseBoolean($restart)); } /** * Manage the Begin of a Map * * @param string $uid * @param bool $restart */ private function beginMap($uid, $restart = false) { //If a restart occurred, first call the endMap to set variables back if ($restart) { $this->endMap(); } if ($this->mapBegan) { return; } $this->mapBegan = true; $this->mapEnded = false; if (array_key_exists($uid, $this->maps)) { // Map already exists, only update index $this->currentMap = $this->maps[$uid]; if (!$this->currentMap->nbCheckpoints || !$this->currentMap->nbLaps) { $rpcMap = $this->maniaControl->getClient()->getCurrentMapInfo(); $this->currentMap->nbLaps = $rpcMap->nbLaps; $this->currentMap->nbCheckpoints = $rpcMap->nbCheckpoints; } } // Restructure MapList if id is over 15 $this->restructureMapList(); // Update the mx of the map (for update checks, etc.) $this->getMXManager()->fetchManiaExchangeMapInformation($this->currentMap); // Trigger own BeginMap callback $this->maniaControl->getCallbackManager()->triggerCallback(Callbacks::BEGINMAP, $this->currentMap); } /** * Manage the End of a Map */ private function endMap() { if ($this->mapEnded) { return; } $this->mapEnded = true; $this->mapBegan = false; // Trigger own EndMap callback $this->maniaControl->getCallbackManager()->triggerCallback(Callbacks::ENDMAP, $this->currentMap); } /** * Fetch a map by its file path * * @param string $relativeFileName * @return Map */ public function fetchMapByFileName($relativeFileName) { $mapInfo = $this->maniaControl->getClient()->getMapInfo($relativeFileName); if (!$mapInfo) { return null; } return $this->initializeMap($mapInfo); } /** * Handle BeginMap callback * * @param array $callback */ public function handleBeginMap(array $callback) { $this->beginMap($callback[1][0]["UId"]); } /** * Handle Script EndMap Callback */ public function handleScriptEndMap() { $this->endMap(); } /** * Handle EndMap Callback * * @param array $callback */ public function handleEndMap(array $callback) { $this->endMap(); } /** * Handle Maps Modified Callback * * @param array $callback */ public function mapsModified(array $callback) { $this->updateFullMapList(); } /** * Get the Number of Maps * * @return int */ public function getMapsCount() { return count($this->maps); } }