/* Minetest Copyright (C) 2013 celeron55, Perttu Ahola This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #pragma once #include "irrlichttypes.h" #include #include #include #include #include #include #include #include "util/basic_macros.h" #include "config.h" #include "metadata.h" class ModMetadataDatabase; #define MODNAME_ALLOWED_CHARS "abcdefghijklmnopqrstuvwxyz0123456789_" struct ModSpec { std::string name; std::string author; std::string path; std::string desc; int release = 0; // if normal mod: std::unordered_set depends; std::unordered_set optdepends; std::unordered_set unsatisfied_depends; bool part_of_modpack = false; bool is_modpack = false; /** * A constructed canonical path to represent this mod's location. * This intended to be used as an identifier for a modpath that tolerates file movement, * and cannot be used to read the mod files. * * Note that `mymod` is the directory name, not the mod name specified in mod.conf. * * Ex: * * - mods/mymod * - mods/mymod (1) * (^ this would have name=mymod in mod.conf) * - mods/modpack1/mymod * - games/mygame/mods/mymod * - worldmods/mymod */ std::string virtual_path; // For logging purposes std::vector deprecation_msgs; // if modpack: std::map modpack_content; ModSpec() { } ModSpec(const std::string &name, const std::string &path, bool part_of_modpack, const std::string &virtual_path) : name(name), path(path), part_of_modpack(part_of_modpack), virtual_path(virtual_path) { } void checkAndLog() const; }; // Retrieves depends, optdepends, is_modpack and modpack_content void parseModContents(ModSpec &mod); /** * Gets a list of all mods and modpacks in path * * @param Path to search, should be absolute * @param part_of_modpack Is this searching within a modpack? * @param virtual_path Virtual path for this directory, see comment in ModSpec * @returns map of mods */ std::map getModsInPath(const std::string &path, const std::string &virtual_path, bool part_of_modpack = false); // replaces modpack Modspecs with their content std::vector flattenMods(const std::map &mods); // a ModConfiguration is a subset of installed mods, expected to have // all dependencies fullfilled, so it can be used as a list of mods to // load when the game starts. class ModConfiguration { public: // checks if all dependencies are fullfilled. bool isConsistent() const { return m_unsatisfied_mods.empty(); } const std::vector &getMods() const { return m_sorted_mods; } const std::vector &getUnsatisfiedMods() const { return m_unsatisfied_mods; } void printUnsatisfiedModsError() const; protected: ModConfiguration(const std::string &worldpath); /** * adds all mods in the given path. used for games, modpacks * and world-specific mods (worldmods-folders) * * @param path To search, should be absolute * @param virtual_path Virtual path for this directory, see comment in ModSpec */ void addModsInPath(const std::string &path, const std::string &virtual_path); // adds all mods in the set. void addMods(const std::vector &new_mods); /** * @param settings_path Path to world.mt * @param modPaths Map from virtual name to mod path */ void addModsFromConfig(const std::string &settings_path, const std::unordered_map &modPaths); void checkConflictsAndDeps(); protected: // list of mods sorted such that they can be loaded in the // given order with all dependencies being fullfilled. I.e., // every mod in this list has only dependencies on mods which // appear earlier in the vector. std::vector m_sorted_mods; private: // move mods from m_unsatisfied_mods to m_sorted_mods // in an order that satisfies dependencies void resolveDependencies(); // mods with unmet dependencies. Before dependencies are resolved, // this is where all mods are stored. Afterwards this contains // only the ones with really unsatisfied dependencies. std::vector m_unsatisfied_mods; // set of mod names for which an unresolved name conflict // exists. A name conflict happens when two or more mods // at the same level have the same name but different paths. // Levels (mods in higher levels override mods in lower levels): // 1. game mod in modpack; 2. game mod; // 3. world mod in modpack; 4. world mod; // 5. addon mod in modpack; 6. addon mod. std::unordered_set m_name_conflicts; // Deleted default constructor ModConfiguration() = default; }; #ifndef SERVER class ClientModConfiguration : public ModConfiguration { public: ClientModConfiguration(const std::string &path); }; #endif class ModMetadata : public Metadata { public: ModMetadata() = delete; ModMetadata(const std::string &mod_name, ModMetadataDatabase *database); ~ModMetadata() = default; virtual void clear(); const std::string &getModName() const { return m_mod_name; } virtual bool setString(const std::string &name, const std::string &var); private: std::string m_mod_name; ModMetadataDatabase *m_database; };