Setting up 1-click mod install on Linux

[skyluke]

Linux 1-click mod installation appears broken in my experience. I only tested it on fedora. The installer appears to do everything well, but it doesn't register a mimetype. One way to fix it easily is to type in the terminal 

gedit ~/.config/mimeapps.list

After this, you should add after

[Added Associations]

The following line:

x-scheme-handler/vintagestorymodinstall=Vintagestory_url_mod.desktop;

The following one-liner should work:

sed -i '/\[Added Associations\]/a \x-scheme-handler/vintagestorymodinstall=Vintagestory_url_mod.desktop;' ~/.config/mimeapps.list

I didn't test it on flatpaks, but if the desktop name is the same, it should probably work? 

Edited July 27, 2025 by skyluke

[Dark Thoughts]

Just tried on Bazzite (immutable) with Firefox (flatpak) & Vintage story (flatpak) and it does indeed work. I mostly use VS Launcher for mod management but I guess I browse the mod database through the browser most of the time anyway, so it can save some extra clicks. This should probably at least be added to the wiki or something.

[skyluke]

I think it can be scripted pretty easily. It is not something that is privileged. So it probably should be included in the installation script. I don't see why it should be in the wiki. It is kind of a bug.

[skyluke]

9 hours ago, Dark Thoughts said:

Just tried on Bazzite (immutable) with Firefox (flatpak) & Vintage story (flatpak) and it does indeed work. I mostly use VS Launcher for mod management but I guess I browse the mod database through the browser most of the time anyway, so it can save some extra clicks. This should probably at least be added to the wiki or something.

https://github.com/anegostudios/VintageStory-Issues/issues/6404

I created the issue on github

[Dark Thoughts]

On 7/29/2025 at 1:01 AM, skyluke said:

So it probably should be included in the installation script.

Can a Flatpak installation do that? I thought the whole point of Flatpaks is to not touch the actual OS.

[wildforester]

Would this only work on fedora? Would be surprised if it worked on all linux distros

[skyluke]

On 7/30/2025 at 8:27 PM, wildforester said:

Would this only work on fedora? Would be surprised if it worked on all linux distros

Would probably work on all distros as it uses xdg standards. But I am not sure and that is why I specified fedora.

[wildforester]

Ok, worked for my device (running cachyos)

[skoove]

Did similar on nixos, nix config for those also using it, I use home manager but it should mostly carry over
 

xdg.desktopEntries.vintagestorymodinstall = {
    name = "Vintage Story Mod Install";
    exec = "vintagestory -i %u";
    type = "Application";
    noDisplay = true;
    mimeType = [ "x-scheme-handler/vintagestorymodinstall" ];
};

[Sleeves]

On 7/28/2025 at 7:01 PM, skyluke said:

I think it can be scripted pretty easily. It is not something that is privileged. So it probably should be included in the installation script. I don't see why it should be in the wiki. It is kind of a bug.

I would argue otherwise, because that assumes the system is following the xdg standard. The best practice for optional support like this is generally an option when installing, or a separate package, e.g. chimera's *-<shell>comp for shell completion or artix's *-<service manager> for service files.