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.

Start at step 1

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 instance

That 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:

Mod Organizer 2 showing a fresh portable Skyrim Special Edition instance with no mods installed
A clean Mod Organizer 2 instance, ready to go.

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.

Right-click this card in Gaming AIMicrosoft Visual C++ RedistributableMicrosoft

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.

Right-click this card in Gaming AISDT – Skyrim Downgrade ToolDownload it, don't add it to your mod list

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.

The Nexus download dialog for Skyrim Downgrade Tool

Inside are three files: a README, Run Downgrader.bat and the PowerShell script it calls. Run the .bat.

The extracted downgrader: README.txt, Run Downgrader.bat and SkyrimSteamDowngrader.ps1

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.

The Skyrim Downgrade Tool window listing three download_depot commands and, at the end, Success: SkyrimSE.exe is 1.6.1170.0
  1. Open the Steam console. Press Win + R and enter the address below. It opens a hidden console tab inside Steam itself.

    steam://open/console
  2. Paste the first download_depot command from the tool into the Steam console. For 1.6.1170 they look like this:

    download_depot 489830 489831 8442952117333549665
    download_depot 489830 489832 8042843504692938467
    download_depot 489830 489833 1914580699073641964

    If the tool shows different numbers, use the tool's. It always has the current ones.

  3. Wait for it to finish, then do the second, then the third. One at a time. Don't paste all three at once.

  4. Once all three report Depot download complete, go back to the tool's window and press Enter.

  5. 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.

The Steam console after all three depot downloads report complete
All three depots finished in the Steam console.

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.

Right-click this card in Gaming AISkyrim Script Extender (SKSE)The build for 1.6.1170, not the newest

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
Skyrim Special Edition's Installed Files tab in Steam, with the Browse button

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.

The extracted SKSE files: skse64_1_6_1170.dll, skse64_loader.exe, two text files, and the src and Data folders

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.

The Skyrim game folder with skse64_loader.exe beside 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.

  1. Click the executables dropdown at the top right, the one currently showing Skyrim Special Edition, and pick <Edit…>.

    Mod Organizer 2's executables dropdown showing Skyrim Special Edition
  2. 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.

    The Modify Executables window with the Skyrim Special Edition entry selected
  3. Click the + next to Executables and choose Add empty. You'll get a blank entry called "New Executable".

    A blank New Executable entry in the Modify Executables window
  4. 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 beside SkyrimSE.exe.

    The file picker in the Skyrim Special Edition folder with skse64_loader.exe selected
  5. Give it a title you'll recognize, like SKSE or skse64_loader, then click Apply.

    The new skse64_loader executable entry with its binary path filled in

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.

skse64_loader selected in the dropdown next to the Run button

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.

Right-click this card in Gaming AIAddress Library for SKSE PluginsNexus mod

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.

The Address Library All in One file under Main files on Nexus, with the Mod manager download button

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.

Right-click this card in Gaming AISkyUISkyUI Team

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.

Right-click this card in Gaming AIUIExtensionsNexus mod

Adds the extra menu types Mantella uses for its in-game prompts and selection lists.

Right-click this card in Gaming AISSE Creation Kit Fonixdata Lip SyncNexus mod

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.

Right-click this card in Gaming AIMantellaNexus mod, by Art from the Machine

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.

The main Mantella file on Nexus, about 4 GB, with the Mod manager download button

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:

Mod Organizer 2 with Mantella, Address Library, SkyUI, UIExtensions and Fonixdata Lip Sync all ticked
The finished mod list: five mods, all ticked.

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.

The Ports page in Gaming AI: the Kobold card says In use, and the top shows active port 5001, Answering, working with Skyrim, Fallout 4 and Bannerlord

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.
Mantella's settings page with LLM Service set to KoboldCpp and Model set to Custom model

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.

RWalk up to any NPC and press R to start a conversation.
HPress H to bring up the text box and type what you want to say. With a mic set up, you can just talk instead.

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.