Hiran You can pin the game version with rustique config set -p 1.22.1 and it'll only download for that version. 

Would it be possible to add game version parameter to update command, or to config? This way we would be able to update to whatever game version we want, and it would also help folks who run older game version

Hiran This version of rustique has a known issue with game version pinning. This bug shows up if the mod author makes the newest version of their mod for the older version of the game, and the older version of the mod for the newer version of the game (which is not how you should do it). The 0.6.0-dev version, which you can only get by compiling it from the github branch atm, fixes this issue.

For now, you will need to pin the mod to the version you want. 

rustique config set -w claycasting -P 1.3.8

Rustique unfortunately can't correctly detect game version, which leads to it downloading wrong version of the mod if dev supports more than one version. Clay Casting released patch to 1.21.6 and rustique downloaded it, despite the fact that I'm running 1.22

https://mods.vintagestory.at/claycasting#tab-files

It seems like these mods no longer exist, thats why it can't find them. They were here for 1.21.6.
I think you should alter that message to also include mod name, not only its id.

Just for your information - their names are This Mod Sucks and EF Traders Fix

Hiran looks like the mods grabber and etfradersfix are not valid mod ids. What mods are those?

Got this when doing sync command.

Meyneth Honestly, it would be a total pita to try and implement that. This is mostly because mod authors are bad at versioning and there is no mechanism on the moddb to indicate if its a stable build or not. The only thing I can check is if the mod has a -rev/dev/alpha at the end of the version and honestly most mods don't even use this schema. So I guess its possible for me to try but I think it would be a lot of work for little gain. 

All that being said, you can pin mod versions so rustique doesn't update them until you are ready. 

theysa Is there any way to make Rustique only check for stable versions of mod updates? Or any plans to make this a feature if not? 

theysa I understand. Thanks for the response. 

Morggin Heya, yes there is no html export, only CSV through the list command. This tool is designed to be simple.. mostly.. and there is no plan to add an html or pdf rendering of any kind. Sorry, its just not in the scope of my design.

Looking over all the stuff here.  Im currently using VS_Modupdate for my Linux server.  After an update, it exports an html document that is basically a list of all the mods.  I didn't see any options for that with this tool.  

Kyattono

Thanks for the kind words and I'm glad you like it! I'm finally able to do some more work on rustique so I'll look into the server/client distinction. I have some bugs and other things to work out first, but I'll put it on the list. Thanks!

Thank you for the excellent manager! So nice to have something that works and works well. This is going to make it so easy to find version incompatible mods now that 1.22 is stable :)

for those who want an easy one liner for this purpose
```rustique list -c game-version mod-url name filename version -e csv -f ./modlist-export.csv```
that is probably more than you need to make it easy to keep tabs on when mod authors update their mods for the new stable version.

Also definitely thirding that server vs client distinction, that would be a great feature!

OctaMagOS Thanks for kind words, I'm really glad it works well for you. Thats actually an interesting feature idea. That should be relatively easy to implement when I have some free time again. Thanks for the idea, I'll add it to my todo list for rustique.

feature request/idea, as someone who runs servers and absolutely loves this tool something I often find mildly annoying is when converting my single player worlds to run on a server so I can play with friends is the lack of an easy way to remove all the client side mods, not sure how feasible this is but I know mods can be tagged client/server/both on the mod db so theoretically is reasonable if modders reliably abide by what they select. And again I absolutely love this tool, thank you for all your hard work!!

Thank you

dohlbrak Yes, you can pin the game version with this command.

rustique config set -p 1.21.6

Is there a way to set up Rustique to only update for my game version?  With the 1.22 release, currently, it is installing any update and I am still running 1.21.6.

😍

Majestik Thanks! Simple was always the goal, glad I could achieve that. :3

Thanks for the mod manager ! Simple but efficient :)

ividyon Glad it's working out for you! 

A wonderful tool to help manage the Linux docker server I host for myself and a friend. Thanks a lot!

propaneko hmm, yea I think I could add. I'll put it on my list and let you know when its available! Thanks for the suggestion!

Haaai again, is there a chance we could get `Rustique list -p/--pinned` command? Would be easy to keep track of what mods are currently pinned in my modlist.

CuraCougar What command were you trying to run when you recieved that error? If clearing out all the files but the config file fixed it, I'm thinking it is related to the search-db or version config. What version were you running before you updated?

Had an issue today trying to use this to update server. It was working fine a week or so ago after first install. This time it was returnign API decode errors.
Updated Rustique, No changes, API Decode error.
Updated and restarted system the same.
Cleared all files but the Config/toml file in .config/rustique. This fixed the issue and let it synch as normal and update.

jmkjhk71 You're very welcome! :3

theysa All working now, thanks for the speedy response!

theysa Nice one, thanks for the update. 👍

jmkjhk71 Ok, I figured out what was going on. All those mods you listed have a modid with capital letters. Rustique DID handle that but I appear to have a regression bug that was not lowercasing the modids. This will be fixed in 0.5.3.

As for the /home/jamie/.local/share/vintagestory/Mods/   This is actuall trying to find a specific mod, but rustique couldn't get the filename, this is related to the modid being incorrect and a filename not being found.

Thank you for reporting this! I'll have an update out shortly.

jmkjhk71 Heya! Thanks for reporting that. I'll take a look at those mods and see whats going on. If you could, could you run the same command but use, `Rustique -d` and send me the results on discord. This will help me figure out more of whats going on. Thanks!

Getting this for some mods: 

```

2025-05-31T10:09:21.069295Z  WARN tokio-runtime-worker ThreadId(07) Failed to download mod: , Parse Error: relative URL without a base
2025-05-31T10:09:21.069312Z  WARN tokio-runtime-worker ThreadId(07) Failed to download mod: , Parse Error: relative URL without a base
2025-05-31T10:09:21.171131Z  WARN                 main ThreadId(01) File /home/jamie/.local/share/vintagestory/Mods/ is no longer there!
```

That last error is wrong, the path does exist. It seems to be struggling to update these mods, although I can't see anyting in the mod info file to suggest why:

- OresAPlenty
- Simple Mob Footsteps
 -Sticks From Firewood

propaneko Hiya! I'm glad the tool is working out for you!

The mod api is working actually. This looks like a bug with how the updates are filtered with list --updates, thanks for reporting that. I'll have that fixed in the next update. Def let me know if you find anything else!

Heya, so because of the error you mentioned below this is why I'm getting list of all mods when typing ./Rustique list --updates ? Love the mod btw, huge help to keep server up to date with mods on linux env :3

HEADS UP: At the time of writing this comment, the mod API is broken. The versions for all mods are showing up as a huge number instead of text. This breaks Rustique, so if you try to sync and you get an error message that says: error decoding response body then this is why. I've already posted an issue on their github for the modapi, so hopefully they get that fixed soon.

EDKE Heya! Version pinning is actually already in 0.3.1! It def needs more testing if you want to give it a shot. You can pin game versions as well as mod versions. I don't have much in the way of documentation just yet, thats coming with the 0.4 release along side modpacks. Check out `Rustique config help set` for more info.

This is the basics though:

• You can use 'Rustique info --mod-id modid' to see the last 3 versions, if you want to see more add '--show-versions 10' to see the last 10 versions
• To pin a version: 'Rustique config set --with-mod modid --pin-version VERSION'. There are short names for the commands too if you look at the help.
• Run a 'Rustique sync' after you pin a version to update Rustique for the pinned versions you set. The 'list' command will also show what you have pinned.
• You can also update the 'list' table itself to show the actual pinned version, by default it displays a (pinned) tag in the Latest Version column, see 'Rustique config table set help list'. This feature is a bit complex and the commands are long, just a heads up.

Let me know if you run into any issues with any of that. I doubt too many people have really tested it out, my lack of documentation and frequent updates prob has something to do with that :p

Hello :) Do you plan on adding a blacklist feature or a version locking mechanism? Because I just saw that Terra Prety released a PRE version of their mod which is unstable. It would be great if Rustique had a way to prevent such mod to be updated, with some configurable option. Thank you!

EDKE Thank you for the build notes for mac! I'll add that to my instructions. I really appreciate it! I hope Rustique is treating you well

To compile Rustique on the Mac, install Rust and Git.

Clone the repo: `git clone https://github.com/Tekunogosu/Rustique.git`.

cd into its folder then do `cargo build --release`.

The executable will be placed in a subfolder and ready to use. Works great on my Mini M1 as of 0.3.0.

momtookmybeans Ty for the list! Yea, the list output didn't really work here. I'm going to add a command to spit out mod ids in an easy to use way.

Forgot to mention, I also made a command line mod manager for the game. It's undergoing a rewrite at the moment, but feel free to reach out if you hit any obstacles :-]

Most likely the missing mod field is due to an invalid/failed query, where an error is returned instead of mod data. Ideally this should be detected, logged to stderr, and skipped- or aborted if it's a single mod.

theysa sure, here ya go

sorry for the mess it wouldn't let me upload a screenshot.

momtookmybeans ty for reporting that. Can you tell me which mods you have installed? I personally havn't seen the error, so there has to be a mod triggering it.

You can post a screenshot of the list command to make that easier.

$ ./Rustique list

Or a screenshot using your file manager works too. Thanks!

theysa thank you! it's working now although i got "Api Error: fetch_mod (json) []: json: missing field `mod` at line 1 column 20" it still updated the mods just fine but i figured you'd want to know about any errors.

momtookmybeans

Hiya, since this is a command line program, you won't be able to just double click and execute it like a program with a GUI. You must use a program called a terminal, which will be installed by default.

Follow these steps:

1. Download the Rustique binary, which will most likely be downloaded to you Downloads directory. (if you have your browser download to a different directory, then change that part in the instructions)
2. You will need to extract the binary from the .zip you downloaded. Since you are new, you can do this from your file browser. Just right click and select "extracte here". this will put the binary directly in your downloads folder
3. Open your terminal, it should be called Terminal
4. In the terminal you need to change the directory to your downloads folder
   • $ cd ~/Downloads
5. From here, you will set the executable bit for Rustique. This ensures your user, (you), will be able to use the
   
   • $ chmod +x ./Rustique
6. If it didn't show any errors, then it worked; it says nothing when you successfully run chmod
7. Now you can run the commands I described in the description
   • $ ./Rustique sync             --- create a local file with update information about the installed mods
   • $ ./Rustique list -u           --- this shows which files need updated, or tell you everything is good already
   • $ ./Rustique update -a    --- this will update all mods you have installed, if they have updates
   • $ ./Rustique list               ---  just to verify that everything is up-to-date 

When you want to use the command in the future, just follow steps from #4. There are other ways to make this available everywhere on the commandline, but thats a bit out of scope for a comment section.

I definately recommend you watch some tutorials on how to use the command line with linux. It's not too complicated and will provide you with a lot of useful tools that you can use in your day-to-day.

Let me know if something didn't make sense or if you get any error messages.

hello, i really REALLY want to use this but im new to linux and can't figure out how to get it to work, i tried following the steps above but it didn't boot, could one of you please tell me how to get this working on linux mint?
many thanks.

@MothHelix wow, thats a lot of mods! I sent you a message on discord as well.

So from what you sent, only Api Error: fetch_mod (json) []: json: missing field `mod` at line 1 column 20 &  Failed to download mod: File /home/***/.var/app/at.vintagestory.VintageStory/config/VintagestoryData/Mods/ already exists. are weird. I'll see what I can figure out though. People like you are exactly why I wanted to get it out there now so you can break it! :3

The messaging about the unzipped folder show too many times, but thats  from error handling stuff needing to be revamped, so its gonna be a bit noisy atm. Other than the weird error messages, which I think are connected, it looks like everything worked as intended. Did you notice any mods not getting updated? Check with list before you update to see if anything was missed.

Thanks a lot for your feedback, it really is very helpful!

Below is my latest crop of error messages, spoilered (and computer account name edited out):

I honestly don't think I have anything particularly unusual installed, but I am a very new player so I actually wouldn't know if I did.

I do tend to have a tinkerers turn of mind - I usually look inside a mods code to confirm functions rather than just assume it does what it says on the tin, its not unusual for me to make combo mods, compat mods or simply decide that someone elses mod isn't quite what I want but its faster to just edit it trather than reinvent the wheel, in addition to simply making my own mods.  

Hell, if I can make it happen I'll just decompile published games that have no modding engine just to have a looky-loo under the hood or cos I want to tweak some value and why not, I bought it and I'm not uploading or stealing the code?

Perhaps all that whacking shit with a wrench and peeking inside is meaning my set up or mod choices are a little weird? There are very popular mods on this site that I consider unacceptably buggy and haven't passed my initial launch test and relatively obscure mods I consider absolute gems and don't understand why they don't have more downloads, so I am willing to admit that I'm probably a bit weird in my preferences.

My mod list has been heavily in flux over the past 24ish hours too, as I test and curate it for playing a game with my girlfriend (who has slightly different gameplay priorities to myself) and I haven't been keeping a record of stuff that has been removed or swapped out. Its currently about 120 mods long and I have included the ls output from my mod folder below:

Let me know if there is anything else I can do to help, and I'm on discord (MothHelix is my user in the VS discord) if you want to hit me up directly via PM

Sleeves ty for your feedback. The relative use of the binary is just for those that may not know how to use it, meaning they downloaded the file and are running those commands immediately. Anyone who knows about aliases or how to add programs to their path will know better than to try it with the relative path.

Just FYI, the command reference probably shouldn't include the ./ pattern as that's for relative paths, which may not be used (people could alias the tool or package it). Seems cool though :-]

EDKE wow thats great to hear it works on mac! I honestly didn't even know there was anyone using mac for VS, now that  I do I'll get a binary up for that as well. I'll take a look at that mod. Sadly, there are a lot of mod authors that do upload weird things or have non-standard configs, so ty for letting me know of another case to check out.

MothHelix You're finding all the edge case mods here! I'll take a look at KettlesHatt's Animal Tweaks. It's funny, I made a tool to install a random 100+ mods and only ran into issues with really old mods and you managed to find serveral mods with api issues in no time, so good job!! Would you mind telling me your list of mods? Something tells me there will be more edge cases in there.

Thanks everyone for the feedback, this is really valuable!

Thanks for the quick response!

This time it breezed past A Wearable Light perfectly, deleted my working (unedited) copy of KettleHatt's Animal Tweaks (https://mods.vintagestory.at/show/mod/20363) and replaced it with the other non-mod download from that page (which is listed as v0.0.1) and then gave me an error:

Failed to download mod: ZipError: Failed to find modinfo.json in Some("KAT_JSON\'s.zip"): specified file not found in archive, specified file not found in archive

Then when I put KAT_v1.0.zip back and ran update again to confirm the error it said:

Updating mods...
No valid mod ids foun

I ran sync before update and it then repeated the replacement of the KAT mod with the JSON files.

I removed the KAT mod to keep testing, ran sync and ran into this one (again on an unedited mod):

Api Error: Failed fetching mod Floral Zones: Caribbean Region: json: timeout: global at line 1 column 48769

I stopped there cos I don't have time for more fiddling now, but I thought I'd let you know :)

Nice tool, thanks a lot! I've downloaded and compiled the source on Mac and it works. Thank you for making the code available! :)

Also I found a bug but I think it's the mod's author's fault: https://mods.vintagestory.at/alloycalculator was replaced by an older incompatible version because it has weird version numbers.

Hiya MothHelix!   Thanks for the feedback, really appreciate that.

The version stuff def needs some work. I took the easy road for dealing with them and its time to get that taken care of. The main takeaway here is that sync fails to do its thing if you hit an error parsing a json file, thats a big no-no and def needs fixing. I really tried to make it handle errors in a way that would still make the program work, looks like I missed one, really nice catch!

Notifying you of mods that are in folders that need to be zipped is a good idea and I'll def add that to my todo.

Those colums are def going to be configurable, so you'll be able to put what you want there. Last date updated for local is not something I thought about, but I'm sure I can come up with something for that

I'm glad the dependency handling is wanted! I found it a bit strange that none of the other mod updaters handled dependencies, that's actually the one of the driving factors for me creating Rustique. That and speed; ModUpdater was painfully slow and I didn't like that. Nothing against that project or anything, I used it and it served me well.

Anyway, I'll try and have a bug fix for the sync issue out sometime tomorrow. Pretty sure I know whats causing it. Other updates, the config management stuff will happen later on. I plan to have a new main release every week, and bug fixes in between, this way there aren't too many updates. 

Anyway, ty for your kind words and feedback!! Let me know if you manage to break it some more, thats the feedback I need the most!

I downloaded this and tried it out, and like it so far. My immediate quibbles are all addressed in your planned feature notes, but I do have a few little bits of feedback for you:

• When I tried a 'sync' it failed with the error message: Api Error: Failed fetching mod A Wearable Light: json: invalid type: integer `0`, expected a string at line 1 column 3869
• The mod in question was causing a little dependency error for the required game version every time I started up VS, so I changed the modinfo file (days ago) from "1.20.*" to "*" just to keep log spam to a minimum.
  The mod is still working in game, so the only issue is that in this case its blocking me from syncing my mods with Rustique unless I guess I revert to the version on the site. (which is a reasonable enough thing to do, the one line 'warning' in the log isn't important, its just that when setting up a mod list I like to correct all errors and warnings I can to focus on any that might be real problems)

• I have a small selection of mods that I have edited for personal use and I keep them unpacked in folders because they still show up in game but VSModsUpdater (which I have been using until now) will skip automatically updating them (and thus erasing my changes). When run, VSModsUpdater includes a list of mods in folders and a suggestion that I should zip them up. This is a handy reminder for me to manually check for updates, and honestly to reassess if my changes are necessary and if I should revert to the default versions.
• Rustique entirely ignores those modded folders for both the list and sync commands. Perhaps Rustique could list those mods separately with a reminder it can't automatically handle their updates?

• Related to the first point, perhaps in addition to the mods version perhaps the minimum game version for each mod could be listed? Other things I'd like there would be the last change log text and date last updated (locally and on modsDB). I see on your planned feature list that setting which columns show up is a planned feature, so this is more just a suggestion for things that could be extra columns rather than a direct request for changing the list feature as it is.

I am looking forward to seeing this project develop! Dependency handling alone made this an instant download for me. Congratuations on the launch.

it works!!!

maybe `./Rustique help` can spit out the URLs for this page https://mods.vintagestory.at/rustique and the github https://github.com/Tekunogosu/Rustique , and the current version 0.1.1?

EDIT: oh, version is already there as `./Rustique --version` or `./Rustique -V`! nice!