OvGME allow you to configure distant mods repositories to check for mods download or
update. This chapter will deals only with the client side repositories feature. If you
want to host and manage a repository, please see the Repository management chapter.
Mods repositories are distant web servers that provide mods for download or update. These
web servers must be OvGME compliant to be recognized during the repositories query.
Note: the repositories are provided by a third-party, OvGME does not provide default
repository (see Repository management).
Configuring repositories
To configure distant repositories for the current configuration, go to the "Mods" menu,
select "Repositories" then "Configure...". It will opens you a new dialog
to manage repositories URL.
Note: The repositories list is not global, each configuration has its own repositories
list. If you configured repositories for a config, this list is only valid for the current
selected config.
Adding or removing URL
To add a new repository URL into the list, fill the URL entry and click the "Add"
button.The URL must be a valid URL to an HTTP server. Here is some examples of valid
URL format:
"http://www.example.com/repos"
"www.example.com:8080/repository/dcs"
"http://192.168.0.1:80/mods"
To remove a repository URL from the list, select the desired URL in the list, then
click on the "Remove" button.
Enabling or disabling URL
Repositories can be enabled or disabled for querying. A disabled repository will not be
checked during repositories query, but will still available in the list for future usage.
To enable or disable repository URL simply check or uncheck the checkbox corresponding
to the URL in the list.
Querying repositories
By querying repositories, OvGME will interrogate each enabled configured repository URL
to create the list of available mods for update or download. To query repositories, go
to the "Mods" menu, select "Repositories" then "Query...". It will
opens you a new dialog.
OvGME will automatically starts the interrogation process. Once the querying is
finished, and if it succeed, some mods should appear in the list. Each entry is
identified by an icon which describes its status relative to your local mods folder for
this configuration.
: Means that the mod is not present in your local mods folder and can be downloaded.
: Means that the mod is already present in your local mods folder and has the same version.
: Means that the mod is already present in your local mods folder but has a lower version than the one available in the repositories (you can upgrade the mod).
: Means that the mod is already present in your local mods folder but has a greater version than the one available in the repositories (if you download this mod, it will downgrade your local mod).
Downloading Mods
To download mods from repositories, you can simply doube-click on the desired mod in the
list. You also can select several mods, then click the "Download selected" button.
Finally, you can synchronize all your local mods folder by clicking on the
"Download all" button.
Downloading mods has several status depending the installation stage.
Pending... : Means that the mod is in the download list, and pending to be processed.
Disabling old... : Means that the current local mod is in uninstalling process. Indeed, a mod must be disabled in order to be upgraded or downgraded.
Downloading... : Means that the mod is currently being downloaded.
There are also several possible error status:
Host not found : Means that download failed due host resolution error.
Connection error : Means that download failed due to a connection error to the server.
HTTP encode error : Means that download failed due to an unsupported HTTP transfer encoding (see below for details).
HTTP error ### : Means that download failed due to an HTTP server error response (usually 404: not found).
Connection lost : Means that download failed due to connection lost.
I/O Open error : Means that download failed due to error on creating file to write on local hard drive.
I/O Write error : Means that download failed due to error on writing data to file on local hard drive.