SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedGameplay & overhauls

Character mod helper

by Pi-C · for Factorio

If your mod lets players use a character that looks differently, you'll have to decide whether you must overwrite the default character. This mod will help you with this decision, and make it really simple to overwrite the default or update the new prototypes in a safe way.

85KDownloads
4 mo agoLast updated
MITLicense
2.1Latest game version

About Character mod helper

From Factorio Mod Portal

If your mod lets players use a character that looks differently, you'll have to decide whether you must overwrite the default character. This mod will help you with this decision, and make it really simple to overwrite the default or update the new prototypes in a safe way.

Mod authors #

Character mods ##

If you're the author of a mod that provides new characters that players can use to change the way they appear in the game, this mod is for you! Using it, you can concentrate in your mod on what it should do: providing new characters and character-corpses. Just add a dependency on this mod to ensure its functions are available, define the properties that are absolutely necessary (animations, localization, sounds etc. -- anything that must be different from the default), and let this mod create and post-process your characters.

If a character selector mod is active, this helper mod will make sure that all changes made to the default character will be applied to your new characters as well (unless that would overwrite a property you have changed yourself). If there is no character selector mod, this helper mod will not simply overwrite the default character completely, but just the properties you've changed. Thus, players can use your new character and mods that change, for example, mining speed, building reach, or light without breaking things. All it takes is just a single function call in data-final-fixes.lua.

Character selector mods ##

If you are the author of a character selector mod, or if you want to prevent character mods from overwriting the default character for some other reason, you just need one function call to this helper mod, and all character mods depending on it will leave the default character alone.

Usage ##

This mod comes with detailed information on how to use it. There's also some example code that you could easily adjust to your needs, so using this helper mod should be easy as pie.

If you think the documentation is not clear enough and should be improved, please don't hesitate to contact me!

Players #

If you have removed the mod that provided the character you've used when your game was saved, you won't have a character next time you load the game. The same may happen if you've removed a character selector mod, as all character mods will overwrite the default character instead of creating new characters.

This helper mod provides commands you can use to leave god mode and get back into a character without disabling achievements.

The commands will not be created if the scenario you're currently playing doesn't expect players to have a character (e.g. the vanilla "Sandbox" scenario).

If your current scenario supports characters, the commands will only be available if no character selector mod is active AND if the default character has been replaced at least 2 times.

  • /CMH-make-character creates a character for the player issuing the command. If the character can't be placed at your current position, the algorithm will gradually move toward {0, 0} until a suitable position has been found. If this fails, you will be asked to move to another position and run the command again.

Hint: You really should move to a suitable position before creating a character, or it may end up in the middle of an ocean, on a tiny island, on a spot surrounded by cliffs on all sides, or in the center of a huge enemy base.

  • /CMH-move DIRECTION DISTANCE will move the player DISTANCE chunks into the specified DIRECTION. DIRECTION must be one of North, East, South, or West, alternatively you can use the shorthands N, E, S, and W. Both the long and the short forms are case insensitive, so "n" will work as well as "nOrtH". DISTANCE must be an integer value in the range 1 <= DISTANCE <= 20. The command will move you no matter whether you've already created a new character or not.

Hint: If you move far away into unexplored area, it may take a while until you can see anything as the game must create the missing chunks first. Therefore, you should use this command only to get out of impossible situations, e.g. if you've accidentally created your character at a position that it can't leave.

Highlights

From source data

Game versions

Built for Factorio 2.1.

Footprint

Rated a light load on a server.

License

Published under MIT.

Character mod helper on Nxeon

From our catalogue
One-click install
Supported on Nxeon Factorio servers. We download it from Factorio Mod Portal, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Factorio — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
2.1.0, released 2026-07-19

Run Character mod helper on a Factorio server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Factorio Mod Portal as “Mods”

Gameplay & overhauls

New mechanics, content and overhauls that change how the game plays.

Runs on your server

From source side support

Factorio Mod Portal lists Character mod helper as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Compatibility

Game
Factorio
Runs on
Serverrequired on the server
Game versions
2.1

Verified at the source

  • ✓Factorio Mod PortalOfficial listing, checked 2026-10-08Open ↗
  • ✓AuthorPi-C, as published on Factorio Mod Portal
  • ✓LicenseMITFree

Character mod helper, answered

Generated from the mod’s own source data.

Do my players need to install Character mod helper?

Factorio Mod Portal lists Character mod helper as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Is it free?

Yes. Character mod helper is free to download from Factorio Mod Portal. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Character mod helper on a Factorio server.

Deploy in about a minute from $2.99 a month, then add Character mod helper in one click.