Fallout 4 · Mantella · Setup guide How to set up Mantella for Fallout 4

Every step from a clean Fallout 4 to your first unscripted conversation in the Commonwealth: the downgrade, the script extender, the mods Mantella needs, its installer, 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

  • Fallout 4 on SteamInstalled somewhere other than Program Files.
  • Windows 10 or 11Mantella doesn't run anywhere else.
  • Mod Organizer 2With a portable Fallout 4 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 Fallout 4 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 Fallout 4 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 Fallout 4 instance with only the DLC listed
A clean Mod Organizer 2 instance, ready to go.

Already modding Fallout 4? 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 2.

Start from a clean game

We strongly recommend a fresh install of Fallout 4 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 Fallout 4 in Steam, go to Properties › Installed Files and use Verify integrity of game files. For a truly fresh start, uninstall, delete the leftover Fallout 4 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 Fallout 4 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 Fallout 4, 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

Downgrade Fallout 4

Bethesda pushed an update to Fallout 4 that broke compatibility with the script extender and most of the mods built on it. Mantella runs on the older build, so before going any further you roll the game back to it.

This step isn't optional. On an up-to-date copy of Fallout 4, Mantella won't run at all.

Right-click this card in Gaming AIFallout 4 DowngraderDownload 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.

In the extracted folder, run Downgrade By Downloading Depots.bat, the first file below the Assets folder.

The extracted downgrader: an Assets folder, Downgrade By Downloading Depots.bat and the other downgrade scripts
The one you want is right below Assets.

The tool opens in a command window. Accept the prompt, then sign in to Steam through it when it asks. On a stock copy of the game it starts right away; ours had already been rolled back, which is why it's asking whether to do it again.

The Fallout 4 Downgrader window saying the game is already version 1.10.163.0 and asking whether to downgrade again

It then downloads the older game files. Expect it to take 30 minutes or more, depending on your connection. Leave it running until it finishes.

Is this safe? Yes. The downgrader signs in to Steam and pulls older official Fallout 4 files straight from Valve's own servers. Your login goes to Steam, not to the tool.

Watch for Steam re-patching. Steam can quietly update Fallout 4 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 3

Address Library and Backported Archive2

With the game rolled back, two mods go in. Both install through Mod Organizer 2 the usual way, and the order matters.

Right-click this card in Gaming AIAddress Library for F4SE PluginsInstall this one first

A lookup table that tells script extender plugins where to find what they need inside the game, so plugin authors don't have to rebuild for every patch.

Right-click this card in Gaming AIBackported Archive2 Support SystemNeeds Address Library to work

Teaches the older game to read the newer archive format Mantella ships in. It won't work without Address Library above it.

Install both and tick their checkboxes. Your left pane should look like this:

Mod Organizer 2 with Address Library for F4SE Plugins and Backported Archive2 Support System both ticked

Step 4

F4SE: the Fallout 4 Script Extender

F4SE is the script extender Mantella runs on. Unlike everything else in this guide, it doesn't go through Mod Organizer 2: it goes straight into your Fallout 4 game folder by hand.

Right-click this card in Gaming AIFallout 4 Script Extender (F4SE)v0.6.23, matches the build you just rolled back to

Use the version our card links to. F4SE is tied to a specific game build, and grabbing a different one is the fastest way to end up with a game that won't start.

Find your game folder

You need the folder that contains Fallout4.exe. The easiest way there is through Steam. Either:

  • Right-click Fallout 4 in your library › Manage › Browse local files, or
  • Right-click Fallout 4 › Properties › Installed Files › Browse
Fallout 4's Installed Files tab in Steam, with the Browse button

Drop the files in

Extract the F4SE archive. Inside you'll find the loader, a couple of .dll files and some documentation.

The extracted F4SE files: f4se_1_10_163.dll, f4se_loader.exe, f4se_steam_loader.dll, text files and the src and Data folders

Drag the contents of that folder into your Fallout 4 game folder: the loose files, not the folder itself. When you're done, f4se_loader.exe should be sitting right next to Fallout4.exe.

The Fallout 4 game folder with f4se_loader.exe and the F4SE dll files beside Fallout4.exe

Check the version. The .dll is named after the game version it was built for, here f4se_1_10_163.dll. That has to match the version the downgrader reported.

Overwrite prompts. If Windows asks to replace existing files, say yes. That just means you're replacing an older F4SE.

Add F4SE to Mod Organizer 2

Mod Organizer 2 now needs to launch the game through F4SE instead of the normal Fallout 4 exe, which means adding F4SE to its list of executables.

  1. Click the executables dropdown at the top right, the one currently showing Fallout 4, and pick <Edit…>.

    Mod Organizer 2's executables dropdown showing Fallout 4, next to the Run button
  2. The Modify Executables window opens on your existing Fallout 4 entry. You're not changing that one; you're adding a new one alongside it.

    The Modify Executables window with the Fallout 4 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 and pick f4se_loader.exe from your Fallout 4 folder. Give it a title you'll recognize, like F4SE or f4se_loader, then click Apply.

    The new f4se_loader entry with its binary set to f4se_loader.exe in the Fallout 4 folder
  5. Your new entry now shows up in the list alongside the defaults.

    The executables list with F4SE added above Fallout 4, Fallout Launcher and Creation Kit

From now on, launch through F4SE

Select your new F4SE entry in the dropdown and use the Run button. That's how you start Fallout 4 from here on.

f4se_loader selected in the dropdown next to the Run button

Don't launch from Steam any more, and don't use the plain Fallout 4 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 your F4SE entry and hit Run. If Fallout 4 reaches the main menu, the downgrade went through and the script extender is loading. If it crashes on launch or never appears, something in the last three steps didn't take, so sort that out before you carry on.

Step 5

Mantella

Simple Text Field first

One last dependency before the main mod. Mantella uses it for typing to NPCs and changing options in game. Install it through Mod Organizer 2 and tick its checkbox.

Right-click this card in Gaming AISimple Text FieldNexus mod

Download Mantella

Now install Mantella itself through Mod Organizer 2, the same way as everything else. Be patient with this one: the All-In-One download is about 6 GB.

Right-click this card in Gaming AIMantellaNexus mod, by YetAnotherModder
The Downloads tab in Mod Organizer 2 with the MantellaMod All-In-One archive downloaded

Free up 15 GB first. Between the download and the installed copy, you want at least 15 GB free. Running out partway through is the most common reason this install fails.

The installer

Double-click the download to install it. Instead of installing silently, Mantella opens a FOMOD: a step-by-step installer that asks what you want. Work through it with the options below.

The Mantella FOMOD installer on its Welcome to Mantella page
  1. Pick Fallout 4 version: choose NG (1.10.984.0). That's right even though you just rolled the game back. The Backported Archive2 Support System you installed in step 3 is what makes it work. Pre-NG is for older setups without that mod, and picking it here leaves you with missing assets.

    Step 1 of the installer with NG (1.10.984.0) selected
  2. Check NG dependencies: tick all three, F4SE, Address Library for F4SE Plugins and Simple Text Field. You've installed every one of them already.

    Step 2 with F4SE, Address Library for F4SE Plugins and Simple Text Field ticked
  3. Choose Text-To-Speech: select Piper TTS. It's the default, it covers the campaign and DLC voices, and it runs on your CPU, so it doesn't compete with the game for graphics memory. If you'd rather use XVASynth or XTTS, the panel on the left explains what each one needs.

    Step 3 with Piper TTS (recommended) selected
  4. After installation requirements: leave Install Creation Kit selected. Mantella uses it to generate lip sync for the new dialogue.

    Step 4 with (Recommended) Install Creation Kit selected

    The Creation Kit itself is a separate, free download. In the Steam store, search for Fallout 4: Creation Kit and install it. You only need to do this once.

    The Fallout 4: Creation Kit page in the Steam store
  5. Set up your API key: select (Local) KoboldCpp, then click Install. This is the important one.

    Step 5 with (Local) KoboldCpp selected and the Install button

Ignore the VRAM warning. The panel on the left says "REQUIRE A HIGH VRAM GRAPHICS CARD" and points you at installing KoboldCpp yourself. You need neither. Mantella only borrows the Kobold port so it knows where to send its requests; Gaming AI answers on the other end, and nothing runs on your graphics card.

The install starts. It unpacks several gigabytes, so give it time.

Mod Organizer 2 unpacking Mantella's Piper voice files, partway through

If it fails, open the download and run the installer again. A retry fixes it most of the time. If it fails a second time, check your free disk space before anything else.

When it finishes, tick MantellaMod in the left pane. Your mod list should now look like this:

Mod Organizer 2 with Address Library, Backported Archive2 Support System, Simple Text Field and MantellaMod all ticked
The finished mod list: four mods, all ticked.

Step 6

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. That matches what you chose in the Mantella installer: 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 f4se_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've got your Pip-Boy, 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 a settler and ask them something nobody scripted. We hope the guide was easy to follow, and that you have a great time in the Commonwealth.

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 Fallout 4, 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.

Fallout 4 crashes on launch or never starts. What's wrong?

Almost always a version mismatch. The game has to be on the version the downgrader rolled it back to, 1.10.163, and your F4SE build has to match it: the F4SE file in your game folder should be named f4se_1_10_163.dll. If Steam has updated the game since, run the downgrader again and set Steam to only update Fallout 4 when you launch it.

I'm in game, but pressing R does nothing. Where's Mantella?

Check how you launched. Starting Fallout 4 from Steam, or from the plain Fallout 4 entry in Mod Organizer 2, skips the script extender, so Mantella never loads. Close the game and start it with your f4se_loader entry in Mod Organizer 2, with Gaming AI already running.

Textures or other assets are missing.

In Mantella's installer, the game version has to be NG (1.10.984.0), and Backported Archive2 Support System has to be installed and ticked, below Address Library. Picking Pre-NG, or skipping Backported Archive2, leaves the older game unable to read Mantella's files. Run the Mantella installer again with NG selected.

NPCs answer, but their mouths don't move.

Mantella uses the Fallout 4 Creation Kit to generate lip sync. Install Fallout 4: Creation Kit from Steam (it's free) and make sure Install Creation Kit was selected in step 4 of Mantella's installer.

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 and the Kobold port selected. Restart both, then launch the game through F4SE again.

Steam updated Fallout 4 again. Do I start over?

Only the downgrade. Run the Fallout 4 Downgrader again, 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.

Run the installer again; a retry fixes it most of the time. If it fails twice, check your disk space. The download is about 6 GB, and between it and the installed copy you want at least 15 GB free.

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 YetAnotherModder, who brought Mantella to Fallout 4, and to Art from the Machine, who created Mantella. If it brings the Commonwealth 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, F4SE, Address Library, Backported Archive2 Support System, Simple Text Field and Fallout 4 Downgrader 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.