October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Change the Scenario on a Factorio Server

Stop the server, place the scenario in the correct data directory, and relaunch with --start-server-load-scenario [MOD/]NAME. This guide covers native servers, Docker entrypoints, save conversion, map settings, and troubleshooting.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To change a Factorio headless server to a scenario, stop the server and start it again with --start-server-load-scenario [MOD/]NAME. Put the scenario folder in the user data folder’s scenarios directory, or inside the named mod’s directory when using the MOD/NAME form. This option starts a fresh multiplayer game from the scenario; it does not resume an existing save.

Docker deployments use the image’s scenario entrypoint instead. A scenario can also be converted into an ordinary save with /scenario2map.sh, after which the server is restarted with normal save-loading options.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Scenario loading and save loading are different operations

Factorio has separate command-line paths for starting from a scenario and continuing a saved game. The scenario command is:

--start-server-load-scenario [MOD/]NAME

If you omit MOD/, Factorio searches the top-level scenarios directory in the user data folder. If you include a mod name, it searches for the scenario inside that mod. The name is the scenario directory name, not the name of a save file.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

To resume the most recently used save, use --start-server-load-latest instead. A save-oriented command cannot be used as a substitute for the scenario flag: one opens a map that already exists, while the other asks Factorio to create a multiplayer server from scenario scripts and assets.

Changing a scenario therefore requires a restart. Stop the running headless process cleanly, make the file changes, and launch a new process with the scenario option. There is no supported in-place switch that changes the scenario of a running server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Before you restart: prepare the server

Stop the old process and preserve a rollback

Announce the maintenance window to players, stop the server using the normal method for your service or terminal session, and confirm that the process has exited. Keep a copy of the current save, server-settings file, map settings, and any scenario or mod files you are about to replace. A scenario start is a new game; a typo or missing dependency can leave you with a server that will not boot, so a rollback copy matters.

Confirm the scenario’s location and spelling

The directory must be under the Factorio user data folder’s scenarios directory unless the scenario belongs to a mod. Use the exact directory name in the command. On case-sensitive systems, capitalization matters. Do not point the flag at a compressed archive, a save file, or the scenario’s parent directory.

No universal absolute path for Linux and Windows is available. Factorio installations can use different user data locations depending on how the game was installed and how the service account was configured. Find the user data folder used by the same account that will run the headless process, then verify that its scenarios directory contains the scenario.

Check the version and required mods

Scenario behavior is tied to the Factorio version and to the mods that provide the scenario. Install the required mods for the server account, keep their versions compatible with the scenario, and make sure the server can read them before inviting players. If the scenario is supplied by a mod, use the [MOD/]NAME form and retain the mod’s directory structure.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Start a scenario on Linux or Windows

1. Place the scenario

  1. Stop the server.
  2. Open the user data folder used by the headless server.
  3. Copy the scenario directory into scenarios, or into the appropriate mod directory if it is mod-owned.
  4. Record the directory name exactly; that is the value passed after --start-server-load-scenario.

2. Build the launch command

A minimal launch has the scenario flag and the scenario name:

./factorio --start-server-load-scenario MyScenario

For a scenario supplied by a mod, qualify the name:

./factorio --start-server-load-scenario MyMod/MyScenario

On Windows, use the same Factorio option with the executable and path conventions used by your installation:

factorio.exe --start-server-load-scenario MyScenario

The command starts a multiplayer server and loads the specified scenario. Keep the command in the service definition, batch file, or startup script that will be used after future reboots; otherwise a later restart may accidentally use a different mode.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Add server and map settings when needed

The scenario flag can be combined with the documented settings flags. A community scenario example uses this pattern:

./factorio --start-server-load-scenario FactorioScenarioMultiplayerSpawn --map-gen-settings your-map-gen-settings.json --map-settings your-map-settings.json --server-settings my-server-settings.json

--server-settings controls multiplayer server behavior such as the configured name, visibility, and other server rules. --map-gen-settings supplies map-generation configuration, while --map-settings supplies simulation settings. Use files that are readable by the account running Factorio and check that their JSON is valid.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Do not add --start-server <savefile> to a scenario command merely because an older recipe shows both options. A 0.14.8 bug report described a combination in which a specified save loaded but the scenario was not loaded into the server. That report is version-specific and old, but it is a reason to use one clear startup mode and to verify behavior on your installed version.

4. Verify the first boot

  1. Start the command in the foreground for the first test so startup errors remain visible.
  2. Read the log until Factorio reports that the server is ready.
  3. Connect with a test client and confirm the scenario’s expected starting state, objectives, and map.
  4. Only after the test succeeds, return the command to your normal service manager or detached session.

If the server starts an ordinary map instead of the scenario, stop it and inspect the effective command line. A wrapper script, service unit, or container entrypoint may be replacing the arguments you edited.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How map generation behaves when a scenario is loaded

Map settings are inputs, not guarantees

The command-line options --map-gen-settings, --map-gen-seed, and --map-settings are available for scenario launches. They can provide generation and simulation values, but a scenario may define its own setup or create a map in another way. Test the result rather than assuming that every setting file overrides scenario logic.

The fixed-map case: blueprint.dat

A scenario containing blueprint.dat can intentionally use the same map every time. If changing map-generation settings or the seed appears to have no effect, inspect the scenario directory for that file. Its presence explains a repeatable map; it is not evidence that the command-line option was mistyped.

Back up the original before removing or replacing any scenario file. Deleting a file changes the scenario itself and may make it incompatible with its scripts or documentation.

Docker: start directly from a scenario

The factoriotools/factorio image provides a scenario entrypoint. Instead of launching the image with its normal save-oriented startup, select /scenario.sh and pass the scenario name as the final argument. The exact volume and environment options depend on your existing deployment, but the essential shape is:

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC
docker run --entrypoint /scenario.sh factoriotools/factorio MyScenario

For a mod-owned scenario, pass the qualified name in the same position:

docker run --entrypoint /scenario.sh factoriotools/factorio MyMod/MyScenario

The scenario name must be the last argument consumed by that entrypoint. Keep the volume that contains the Factorio data and scenarios directory mounted at the location expected by your image configuration; otherwise the container will start successfully but report that the scenario cannot be found.

Use a one-shot container for the first test

  1. Stop and remove the existing Factorio container, or stop it without deleting the persistent data volume.
  2. Run the image with --entrypoint /scenario.sh and the scenario name as the final argument.
  3. Watch the container logs through scenario initialization and connect with a test client.
  4. Once confirmed, put the same entrypoint and argument into Compose, Kubernetes, or your normal container definition.

Do not confuse an image’s scenario entrypoint with the default entrypoint. The default startup usually expects a save or standard server configuration; selecting /scenario.sh is what requests a clean scenario start.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Docker: convert a scenario into a normal save

If you want the scenario’s initial map to become a conventional save, use the image’s /scenario2map.sh entrypoint. Factorio runs once, creates the map from the scenario, and writes a saved map into the saves directory. After that one-shot conversion finishes, restart the image with your normal server options so it loads the generated save rather than rerunning the scenario.

  1. Stop the ordinary server container while preserving its persistent data volume.
  2. Run the image with /scenario2map.sh as the entrypoint and provide the scenario name and any arguments required by the image version.
  3. Wait for the one-shot process to finish and confirm that a new save appears in the mounted saves directory.
  4. Start the regular Factorio container again with its standard save-loading configuration.
  5. Connect and verify that the resulting map contains the scenario’s expected starting content.

This workflow separates scenario initialization from ongoing administration. Once converted, future restarts load the save; changing the scenario later requires another conversion or a direct scenario launch.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Another Docker image: environment-variable configuration

The community rfvgyhn/factorio image uses the environment variable FACTORIO_SCENARIO. Set it to [MOD/]NAME, for example:

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
FACTORIO_SCENARIO=base/wave-defense

This is image-specific configuration, not a universal Factorio command-line option. Follow that image’s volume, permissions, and startup conventions, and remove or change the variable when you want the container to load a normal save instead.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Bare metal versus Docker

Use case Native Linux or Windows Docker
Start fresh from a scenario --start-server-load-scenario [MOD/]NAME /scenario.sh entrypoint with the scenario name as the final argument
Scenario location User data folder’s scenarios directory, or inside the named mod Same Factorio data must be available inside the mounted container volume
Continue an existing map --start-server-load-latest or the normal save-start command Restart with the image’s standard save configuration
Turn a scenario into a save Not described by the native command in the supplied documentation Run the /scenario2map.sh entrypoint once, then load the generated save
Image-specific alternative Not applicable FACTORIO_SCENARIO=[MOD/]NAME on the rfvgyhn/factorio image

Troubleshooting a failed scenario switch

Factorio says the scenario cannot be found

  • Check that the scenario is a directory, not a ZIP file or save.
  • Confirm it is under the user data folder used by the server account.
  • Use the exact directory name, including capitalization.
  • If it belongs to a mod, pass ModName/ScenarioName and verify that the mod is installed for the server.
  • In Docker, verify that the persistent data volume containing the scenario is mounted into the container that actually starts Factorio.

The server starts, but the old map appears

Inspect the service or container command and confirm that --start-server-load-scenario or the scenario entrypoint is really being used. A stale container definition, wrapper script, or restart policy can relaunch the old save command. In a scenario that contains blueprint.dat, seeing the same map after every fresh launch is expected.

Map-generation changes appear ignored

First check for blueprint.dat. Then confirm that the settings files are passed to the scenario launch, are readable, and are valid JSON. Finally, allow for scenario code that deliberately controls generation; command-line settings do not necessarily replace scenario logic.

Windows does not launch the scenario

A 1.1.0 forum report described --start-server-load-scenario failing on Windows while --start-server <savefile> worked. That is an old, version-specific report rather than proof of current behavior. Test the command with the Factorio version you run, capture the console output, and avoid treating a save launch as evidence that the scenario was loaded.

The scenario option behaves incorrectly when combined with a save option

An old 0.14.8 report described a case where the specified save loaded but the scenario did not. Use a single startup intent while diagnosing: either launch the scenario, or launch a save. Remove conflicting flags, test again, and then reintroduce only documented settings options such as --server-settings, --map-gen-settings, or --map-settings.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Docker exits immediately

  • Check the one-shot command’s logs; /scenario2map.sh is expected to exit after writing a save.
  • Confirm that the scenario name is the final argument for /scenario.sh.
  • Verify write permission on the mounted saves and data directories.
  • Make sure the regular server is not simultaneously locking or modifying the same persistent data.

A repeatable changeover checklist

  1. Choose whether you need a fresh scenario or an existing save. Use only one startup mode.
  2. Stop the current server and preserve a backup of its save and configuration.
  3. Place the scenario in the correct scenarios location, or install its providing mod.
  4. Write down the exact scenario name and, if needed, the MOD/NAME form.
  5. Prepare the launch command with optional settings files only when they are required.
  6. For Docker, select /scenario.sh; for conversion, select /scenario2map.sh.
  7. Start in the foreground or inspect container logs until initialization completes.
  8. Join with a test client and verify the scenario, map behavior, and server settings.
  9. Promote the tested command to the normal service or container definition.

The reliable pattern is simple: install the scenario where Factorio can find it, stop the old process, and launch with --start-server-load-scenario [MOD/]NAME (or the equivalent Docker entrypoint). Use --start-server-load-latest only when the goal is to continue a save, and use /scenario2map.sh when a Docker scenario must become a persistent ordinary map.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.