Skyrim · Mantella · Setup guide How to set up Mantella for Skyrim
Every step from a clean Skyrim Special Edition to your first unscripted conversation: the downgrade, the script extender, the four mods Mantella needs, and the two settings in Gaming AI.
- Skyrim1.6.1170
- Time1 to 2 hours
- Game sizeAbout 12 GB
- Mod size4 GB
- Updated
Tick each step off as you finish it. Your place is saved on this device.
What you need
- Skyrim Special Edition on SteamInstalled somewhere other than Program Files.
- Windows 10 or 11Mantella doesn't run anywhere else.
- Mod Organizer 2With a portable Skyrim Special Edition instance. Set it up here.
- The Gaming AI appIt runs the AI model for Mantella, so there's no API key to set up. Free to install: get it from the home page. Conversations use Vigor, from 99¢.
Step 1
Before you start: Mod Organizer 2
This guide assumes you already have Mod Organizer 2 installed with a portable Skyrim Special Edition instance, and that you know how to pull a mod down from Nexus into it. If any of that is new to you, start with our Mod Organizer 2 guide and come back here. It takes about ten minutes, and everything below builds on it.
Mod Organizer 2 setup guideInstall it and make your first instanceThat guide covers the whole routine this one leans on:
- Installing Mod Organizer 2 somewhere outside Program Files
- Creating a portable instance with Skyrim Special Edition selected
- Leaving all three profile settings checked, Automatic archive invalidation especially
- Downloading a mod from Nexus and activating it in the left pane
From here on, whenever this guide says to install a mod, it means that same routine: the Files tab on Nexus, Mod manager download, double-click it in the Downloads tab, tick the checkbox.
You should be looking at a clean instance like this before you go any further:
Already modding Skyrim? You can use your existing instance. Just make sure archive invalidation is on, since Mantella ships loose files. And if you're already running an older, downgraded mod list, you can skip step 3 entirely.
Start from a clean game
We strongly recommend a fresh install of Skyrim Special Edition before you begin. Mantella runs on the script extender and loads a lot of loose files, and leftovers from an old modded setup are the most common cause of crashes nobody can explain later. A clean game costs you one download and saves you an afternoon of troubleshooting.
If you're not sure your install is clean, right-click Skyrim Special Edition in Steam, go to Properties › Installed Files and use Verify integrity of game files. For a truly fresh start, uninstall, delete the leftover Skyrim Special Edition folder, then reinstall.
Keep the game out of Program Files
Steam installs games under C:\Program Files (x86)\Steam by default, and that's the one place this setup won't work. Windows protects Program Files, so Mod Organizer 2, the script extender and Mantella can't reliably write the files they need there. The game either won't start or starts without your mods.
To check: right-click Skyrim Special Edition in Steam, choose Manage › Browse local files, and look at the folder path at the top of the window. If it starts with C:\Program Files or C:\Program Files (x86), move it. Anywhere else, like C:\SteamLibrary or D:\SteamLibrary, is fine.
To move it: in Steam, open Settings › Storage and add a new library folder on a drive outside Program Files (Steam names it SteamLibrary). Then select your current library, tick Skyrim Special Edition, click Move and pick the new one. Steam moves the files over; nothing is downloaded again.
Move it before you make your Mod Organizer 2 instance. The instance remembers where the game was. If you've already made one, create it again after the move so it points at the new folder.
Step 2
Microsoft Visual C++ Redistributable
The first and easiest step. The script extender and the plugins built on it are compiled against Microsoft's C++ runtime, and if it's missing they fail to load with errors that look like the mods themselves are broken. Most PCs already have it, but installing it takes seconds and rules the problem out for good.
Already installed? The installer says so and offers Repair or Uninstall. Close it and move on to the next step.
Step 3
Downgrade Skyrim to 1.6.1170
Bethesda pushed an update to Skyrim Special Edition that broke compatibility with the script extender and most of the mods built on it. Mantella runs on the older build, 1.6.1170, so before going any further you roll the game back to it.
This step isn't optional. On an up-to-date copy of Skyrim, Mantella won't run at all.
This one is a tool, not a mod. Download it with your mod manager or manually, then open the download in File Explorer and extract it.
Inside are three files: a README, Run Downgrader.bat and the PowerShell script it calls. Run the .bat.
Follow the instructions in the window
The tool opens a command window and gives you three Steam depot commands. Read this screen rather than clicking past it: the order matters, and the tool doesn't do the downloading for you.
-
Open the Steam console. Press Win + R and enter the address below. It opens a hidden console tab inside Steam itself.
steam://open/console -
Paste the first
download_depotcommand from the tool into the Steam console. For 1.6.1170 they look like this:download_depot 489830 489831 8442952117333549665download_depot 489830 489832 8042843504692938467download_depot 489830 489833 1914580699073641964If the tool shows different numbers, use the tool's. It always has the current ones.
Wait for it to finish, then do the second, then the third. One at a time. Don't paste all three at once.
Once all three report Depot download complete, go back to the tool's window and press Enter.
Close the window.
It will look frozen. Steam shows no progress bar while a depot downloads. That's normal. The whole process can take anywhere from 30 minutes to an hour.
When you press Enter, the tool backs up your existing files and installs the three depots. You're looking for the green line:
Success: SkyrimSE.exe is 1.6.1170.0
Watch for Steam re-patching. Steam can quietly update Skyrim back to the latest version, which undoes all of this. In the game's Steam properties, set updates to Only update this game when I launch it, and launch through Mod Organizer 2 rather than Steam from now on.
Step 4
SKSE: the Skyrim Script Extender
SKSE is the script extender Mantella runs on. Unlike everything else in this guide, it doesn't get installed through Mod Organizer 2.
Use the older build. The card deliberately points at the SKSE build that matches the 1.6.1170 game you just downgraded to, not the newest release. Grabbing the current version instead is the fastest way to end up with a game that won't start.
Find your game folder
You need the folder that contains SkyrimSE.exe. The easiest way there is through Steam. Either:
- Right-click Skyrim Special Edition in your library › Manage › Browse local files, or
- Right-click Skyrim Special Edition › Properties › Installed Files › Browse
Drop the files in
Extract the SKSE archive. Inside you'll find the loader, a .dll named for the game version, some documentation and a Data folder.
Drag the contents of that folder into your Skyrim game folder: the loose files, not the folder itself. Its Data folder merges into the one already there, which puts the SKSE scripts where the game can find them. When you're done, skse64_loader.exe should be sitting right next to SkyrimSE.exe.
Check the version. The .dll is named after the game version it was built for, here skse64_1_6_1170.dll. If that number doesn't match what the downgrader reported, you have the wrong SKSE build and the game won't launch.
Overwrite prompts. If Windows asks to replace existing files, say yes. That just means you're replacing an older SKSE.
Add SKSE to Mod Organizer 2
Mod Organizer 2 now needs to launch the game through SKSE instead of the normal Skyrim exe, which means adding SKSE to its list of executables.
-
Click the executables dropdown at the top right, the one currently showing Skyrim Special Edition, and pick <Edit…>.
-
The Modify Executables window opens on your existing Skyrim Special Edition entry. You're not changing that one; you're adding a new one alongside it.
-
Click the + next to Executables and choose Add empty. You'll get a blank entry called "New Executable".
-
With that entry selected, click the three dots next to Binary. Browse to your Skyrim folder and pick
skse64_loader.exe, the one you just put besideSkyrimSE.exe.
-
Give it a title you'll recognize, like SKSE or skse64_loader, then click Apply.
From now on, launch through SKSE
Select your new SKSE entry in the dropdown and use the Run button. That's how you start Skyrim from here on.
Don't launch from Steam any more, and don't use the plain Skyrim Special Edition entry in Mod Organizer. Neither loads the script extender, so Mantella simply won't be there when you get in game.
Check that it worked
Select skse64_loader and hit Run. If Skyrim reaches the main menu, the downgrade went through and the script extender is loading. If it crashes on launch or never appears, check that your game version and SKSE build both say 1.6.1170.
Step 5
Address Library for SKSE Plugins
Address Library is a lookup table that tells SKSE plugins where to find what they need inside the game, so plugin authors don't have to rebuild for every patch. Mantella's plugin depends on it.
On the Nexus page, grab Address Library All in One under Main files with Mod manager download. Install it through Mod Organizer 2 the usual way and tick its checkbox.
As the page says, it covers all game versions up to the number in its title, so the same file works on your downgraded 1.6.1170.
Step 6
The three required mods
Three more mods go in before Mantella itself. All three install through Mod Organizer 2 the usual way: right-click the card in Gaming AI, use Mod manager download on the Nexus page, double-click it in the Downloads tab and tick its checkbox. The order doesn't matter.
Mantella's settings live in the Mod Configuration Menu, and SkyUI is the mod that provides it. Without it there's no way to change Mantella's options in game.
Adds the extra menu types Mantella uses for its in-game prompts and selection lists.
Supplies the lip sync data that moves NPCs' mouths in time with generated dialogue. Skip it and NPCs talk at you without opening their mouths.
Check them off. All three need their checkboxes ticked in the left pane, not just installed. An unchecked mod does nothing.
Step 7
Mantella
Almost there. Everything Mantella depends on is in place, so all that's left is the mod itself.
Grab the main Mantella file with Mod manager download and install it through Mod Organizer 2 like everything else. Be patient with this one: it's about 4 GB, so on a slower connection it can take a while.
Free up 10 GB first. Between the download and the installed copy, you want at least 10 GB free. Running out partway through is the most common reason this install fails.
Once it's installed, tick its checkbox. With everything in, your mod list should look like this:
Step 8
Gaming AI and launching the game
The hard part's done. Two settings in Gaming AI and you're ready to play.
Select the Kobold port
Open Gaming AI, go to Ports and click Use this port on the Kobold card. Kobold answers on port 5001, and that's where Mantella sends everything. The card switches to In use, and the top of the page shows 5001 as the active port with Answering next to Status.
Load a model
Open the AI Models page in the sidebar and load the model you want. Start with a budget model to test your setup without spending much Vigor, then switch to a balanced model for the rest of your playthrough once everything works.
New to Gaming AI? Grab the 99¢ pack and try a few models. They behave very differently in conversation, and it's worth finding one you like before you commit to a long playthrough.
Run the game
Leave Gaming AI running, then select your skse64_loader entry in Mod Organizer 2 and click Run.
Two windows open. Leave them both alone.
Along with the game, Mantella starts two things of its own:
- A command prompt window. That's Mantella itself running. Leave it open: close it and conversations stop working.
- A browser tab at
localhost:4999, Mantella's own settings page. You don't need to change anything on it.
Leave the Model box on "Custom model" and LLM Service on KoboldCpp. Mantella is only asking which model to request from the server it's pointed at, and that server is Gaming AI, which decides for itself which model is loaded. Picking something here doesn't switch models, and changing it can stop Mantella talking to Gaming AI altogether. Your model choice happens on the AI Models page in Gaming AI.
In game
Start a new game and play through the intro. Once you're out of Helgen and free to roam, you're ready.
That's everything
Go find someone in Skyrim and ask them something nobody scripted. We hope the guide was easy to follow, and that you have a great time playing.
Setting up another game? See all setup guides.
Troubleshooting
The problems people hit most, and what fixes them.
My game is installed in Program Files. Does that matter?
Yes. Windows protects Program Files, so Mod Organizer 2, the script extender and Mantella can't reliably write the files they need there, and the game either won't start or starts without your mods. In Steam, right-click Skyrim Special Edition, choose Manage, then Browse local files, and check the folder path. If it's under Program Files, add a new library folder in Steam's Settings, under Storage, move the game there with the Move button, then create your Mod Organizer 2 instance again so it points at the new folder.
Skyrim crashes on launch or never starts. What's wrong?
Almost always a version mismatch. Your game has to be 1.6.1170 and your SKSE build has to match it: the SKSE file in your game folder should be named skse64_1_6_1170.dll. If Steam has updated the game since you downgraded, run the downgrade again and set Steam to only update Skyrim when you launch it.
I'm in game, but pressing R does nothing. Where's Mantella?
Check how you launched. Starting Skyrim from Steam, or from the plain Skyrim Special Edition entry in Mod Organizer 2, skips the script extender, so Mantella never loads. Close the game and start it with your skse64_loader entry in Mod Organizer 2, with Gaming AI already running.
NPCs answer, but their mouths don't move.
SSE Creation Kit Fonixdata Lip Sync is missing or unticked. Install it through Mod Organizer 2 and make sure its checkbox in the left pane is ticked.
Conversations stopped working partway through.
Mantella's command prompt window is Mantella itself running. If it was closed, conversations stop. Gaming AI also has to stay open with a model loaded. Restart both, then launch the game through SKSE again.
Steam updated Skyrim again. Do I start over?
Only the downgrade. Run the Skyrim Downgrade Tool again to get back to 1.6.1170, then in the game's Steam properties set updates to happen only when you launch the game, and keep launching through Mod Organizer 2.
The Mantella install failed partway through.
The usual cause is disk space. Mantella is about 4 GB, and between the download and the installed copy you want at least 10 GB free. Free up space, then download and install it again.
Should I change anything on Mantella's settings page at localhost:4999?
No. Leave LLM Service on KoboldCpp and Model on Custom model. Gaming AI decides which model answers, and you choose it on the AI Models page in Gaming AI. Changing these settings can stop Mantella talking to Gaming AI.
Which AI model should I use?
Start with a budget model to check everything works, then switch to a balanced model for your playthrough. Models behave very differently in conversation, so it's worth trying a few with the 99¢ pack.
Still stuck?
Supporters get hands-on help: we'll work through mod conflicts and broken downloads with you, one to one. Not a supporter? Write to us anyway if anything in this guide looks outdated or broken.
Thanks to Art from the Machine, who makes Mantella. If it brings your Skyrim to life, endorse it on its Nexus page.
Gaming AI is an independent service and is not affiliated with, endorsed by or connected to Bethesda Softworks or any mod author. Mantella, SKSE, SkyUI, UIExtensions, Address Library, Fonixdata Lip Sync and Skyrim Downgrade Tool are made and maintained by third parties. Game and mod names are the trademarks of their respective owners and are used here only to describe compatibility.