Subscribe to download
RimSaga

For RimSaga to work you must go to mod options and enter a Google Gemini API key: https://aistudio.google.com/app/apikey

Please submit bug reports and feature requests in GitHub issues[github.com]. Feel free to use the Steam workshop page for questions and general discussion.

• Once the mod is enabled and your API key is set, notable events in the life of your colony will automatically generate new dated entries in your ongoing saga.

• You are able to edit or delete the text that's generated as you like. Your edited text will even be taken into account as new entries are generated.

• If an event doesn't generate an entry or you just want to invent one for your story (maybe a colonist lets their sanguophage friend have a little nibble one night just for funzies?), you can write a brief description and a custom entry will be generated that takes the full state of your colony into account.

• International support: your story will be written in the language you've set for the game

• Although for best results I recommend using this mod from the start of a new game, you can enable it in the middle of an existing save and it will attempt to write an appropriate opening to the saga.

• Your saga can be exported as a text file at any point.

How does it work?

A structured prompt including lots of strategically compiled and formatted game data is sent to an LLM API.

Why does it use Google Gemini instead of OpenAI's GPT, Anthropic's Claude, locally running models, etc?

I've tested extensively with all of the models from all of these services. Gemini currently produces the best creative writing for this case (really!), and even better it's the only one that offers free API access for many people. This seems like the best catch-all solution for now.

Enabling different models means accounting for their different API schemas, context windows, prompting quirks, etc. It would also lead to a steady stream of technical support and pricing questions/complaints for each one. There would be a lot of unhappy users that are getting poor results from this mod because they're using a model of their choice that I know does not work well for this use case.

My current plan is to continue using a Google Gemini API key as the default, and to add an advanced mode where a user can enter a custom URL to generate text using any API that conforms to the OpenAI schema. This would cover many use cases for people who want to run their own model locally.

If models from OpenAI and Anthropic catch up to Gemini in both performance and pricing, I will definitely add those options as well.

Google doesn't offer the free tier for API access in my region

I'm afraid that's a Google issue. You can of course still use this mod if you're willing to pay for the API usage.

I get intermittent "Gemini request" errors

I've implemented some basic retry logic to mitigate this, but currently Gemini's API can be spotty every now and then. That's the tradeoff for a free service. If there's an error and a crucial event isn't automatically written about, wait a minute and use the "Generate custom entry" button to manually try again.

It gets stuck in a "generating" state

This is a very rare error that I haven't been able to pin down yet. In the meantime just save your game and restart RimWorld and everything will work as normal.

Like many of you I love the "story generator" aspect of this game, but I often lose track of the narrative details available throughout the UI when I begin to focus on gameplay. I was a fan of the original RimStory mod, which kept a simple running log of colony events.

Now with AI, these events can just as easily be woven together as prose. It's by no means perfect, but it's pretty magical when it gives just the right depth to what you see happening on the screen. I once had a colonist that was laying down wood flooring say something like "You know it's not how straight you lay the boards, but how gracefully you walk on them."

I recommend watching for new entries to be added, then reading over them and editing them up as you like. This will help the AI write better entries moving forward, and leave you in the end with a story that makes more sense.

The state of the technology and service providers are very much in flux, so I'll do my best to keep up as things develop.