Mod Gallery (MEDIA.md)
Curate your mod page's gallery directly from your repo. Drop assets in .openmods/media/, then describe the order, captions, and thumbnail in .openmods/MEDIA.md. The file is the source of truth — every sync replaces the gallery with what it says.
edit_note Syntax
A markdown bullet list. Each entry is [type:label](url-or-filename):
- [video:youtube-short](https://youtube.com/shorts/4vQk2nVvaQU)
- [image:gameplay-1](Screenshot_9.png)
- [image:gameplay-2](Screenshot_10.png)
- [image:before](light_off.jpg)
- [image:after](light_on.jpg)
// Same file can appear twice — list it again
- [image:hero-again](icon.png)
image
Adds the file to the gallery in list order.
video
A local .mp4/.webm or a YouTube/Vimeo URL.
thumbnail
Sets the mod's hero image. First entry wins; not added to the gallery on its own.
The label part is your own identifier (alt text or just a comment) — it's parsed but not currently rendered, so use anything that helps you keep the file organised.
link Filenames vs. full URLs
- check_circle
Filename (e.g.
icon.png) → resolved against.openmods/media/and rewritten to the GitHub raw URL on save. - check_circle
Full
https://URL → stored verbatim. Use this for raw GitHub URLs from another repo, YouTube/Vimeo embeds, or any external host. - warning
If a filename isn't found in
.openmods/media/, the entry is skipped and a warning is logged. Check spelling and the file extension.
photo_library
Supported file types in .openmods/media/
Images
.png · .jpg · .jpeg · .webp · .gif
Videos
.mp4 · .webm
folder_open No MEDIA.md? The folder still works
If you skip the manifest, every supported file in .openmods/media/ gets imported automatically the first time the gallery is empty, and a thumbnail is auto-picked from any filename containing one of these keywords (case-insensitive):
In folder-only mode, auto-fill stops once you save edits in the dashboard gallery editor — your selection becomes sticky. With a MEDIA.md, the file always wins instead.
MEDIA.md is authoritative
When the file is present, every sync rebuilds the gallery from scratch in the order the file lists. Dashboard edits to the gallery are overwritten on the next refresh — treat the file as your single source of truth, the same way LINKS.md and FAQ.md work.
Ready to distribute your mods?
Join hundreds of other developers using OpenMods to deliver their creations to players faster.