How to Create Your Own Marketplace Provider

A personal marketplace provider allows you to host your own collection of mods and themes. This is perfect for testing your creations, sharing them with a smaller group, or creating a curated list for our community.

Setup Guide

1. Fork the Marketplace Repository
   You'll need your own copy of the marketplace structure.
   Fork the Lution-Marketplace repository here.
2. Add Your Content Files
   In your forked repository, place your zipped mods, themes, and thumbnails in the correct directories:
   • Mod .zip files: Assets/Mods/Content/
   • Theme .zip files: Assets/Theme/Content/
   • Thumbnail images: Assets/thumbnails/
3. Configure the Metadata
   You must update two JSON files for Lution to recognize your content: content.json (for display) and info.json (for file paths).

   A. Update content.json

   This file controls how your items appear in the marketplace UI. Edit Assets/Mods/content.json for mods and Assets/Themes/content.json for themes.

   Example Entry:

   [
     {
       "title": "My Mod",
       "body": "My first ever mod",
       "image": "https://raw.githubusercontent.com/YourUser/Lution-Marketplace/main/Assets/thumbnails/my-mod.png",
       "button": "Download",
       "creator": "you",
       "version": "version-a1b2c3d4",
       "sb": "unknown"
     }
   ]
   

   Field Descriptions:

   • title: The name of your mod or theme.
   • body: A short description of what it does.
   • image: A direct URL to the thumbnail image. You can use a raw GitHub link to an image in your repository.
   • button: The text on the download button. "Download" is recommended.
   • creator: The name of the author.
   • version: The game version your content is compatible with.
   • sb: The stability status. Use stable, unstable, or unknown.

   B. Update info.json

   This file links the display information to the actual .zip file. Edit Assets/Mods/info.json for mods and Assets/Themes/info.json for themes.

   Example Entry:

   [
     {
       "name": "My Mod",
       "path": "Assets/Mods/Content/mymod.zip"
     }
   ]
   

   Important:

   • The "name" field must exactly match the "title" from your content.json file.
   • The "path" is the relative path to the .zip file within your repository.
4. Use Your Marketplace in Lution
   Once you have committed and pushed your changes to your forked repository on GitHub, you can configure Lution to use it.
   1. Open Lution and go to Marketplace Settings.
   2. In the "Marketplace Provider" field, enter your GitHub repository name in the format YourUsername/YourRepoName.

   Bonus : For example, if your GitHub username is "Chip" and you forked the repository, you would enter: Chip/Lution-Marketplace

   Lution will now load mods and themes from your personal repository.