Skip to content
This repository has been archived by the owner on Jul 31, 2021. It is now read-only.

OpenGameMods-group/ES-Mod-Share

Repository files navigation

Endless Sky Plugin Share

Deprecation Note

This repo is no longer maintained and no more pull requests will be accepted. You can find the new mod manager and plugin repository at the Endless Sky Community

About

ES Plugin Share is a plugin sharing website for Endless Sky

Go to the website

Installing plugins

Generally, installing a plugin is as simple as dropping it into the Endless Sky plugin folder for your operating system, specified here: https://github.com/endless-sky/endless-sky/wiki/CreatingPlugins. However, some plugins may have issues with other ones, so be sure to read each plugin's description before installation, and back up your saves.

Submitting a plugin to the website

  1. Clone/Download/Pull the repo ( this can be complicated for users not familar with Git. A new way of uploading mods may be implemented in the future )

  2. Go to the plugins folder and add your own plugin folder (eg. /mods/mypluginfolder). Inside, add a metadata.json file (eg. /mods/mypluginfolder/metadata.json). The easiest way is to copy the the example plugin.

  3. Images may be either externally linked or hosted by the site.

    • If you are using a local image (included in the website's source, not hosted elsewhere), prepend local: before the image name to tell the website that it's not a hyperlink.
      • eg. local:banner.png, local:thumbnail.jpg
    • The thumbnail is a small image that represents your plugin in the list.
    • The banner is larger and shown when your plugin is being viewed by the user.
  4. Finally, make a pull request!

Note: The data format for the plugin data is YAML, but it is processed to json, which is why it has the json file extension.

All plugin data is available in json format at https://OpenGameMods-group.github.io/ES-Mod-Share/plugins-json.html.