Helper for mods that create new characters

by Pi-C

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.

Internal
23 days ago
1.1 - 2.0
44.3K

Changelog

Version: 2.0.0
Date: 2024-10-27

  Info:
    - Update for Factorio 2.0.

  Changes:
    - Added startup setting to enable/disable debugging to log. (https://mods.factorio.com/mod/CharacterModHelper/discussion/66346f8b551e6a7dd9377f1d)

    - Sourced out assertions and debugging stuff to a new library mod. I've used (versions of) that code in most of my mods already, and given all the changes in Factorio 2.0, it was too cumbersome to fix more or less the same things everywhere, so it made sense to put those things into a library mod.
Version: 1.1.6
Date: 2023-04-08

  Bugfixes:
    - Fixed crash on startup, when trying to access a non-existant character.  (https://mods.factorio.com/mod/CharacterModHelper/discussion/63f08d8085c85134f160ffaf)
Version: 1.1.5
Date: 2023-04-08

  Bugfixes:
    - Fixed that admins would always be warned that they should install a character selector mod, even if one was active. Caused by renaming the table with mod properties, but still using the old name when checking for active selector mods.  (https://mods.factorio.com/mod/CharacterModHelper/discussion/63f08d8085c85134f160ffaf)

  Changes:
    - If several characters should be available but no selector mod can be used to switch characters, we'll output more detailed diagnostic messages (considering mod version, settings, and list of characters supported by a selector mod).
    - Admins (or the single player) will be nagged up to 3 times to activate a suitable selector mod. The counter will be reset when on_configuration_changed is triggered (Factorio version/mod versions/startup settings are changed or mods are added/removed).
Version: 1.1.4
Date: 2023-02-14

  Bugfixes:
    - Added handler for on_load to prevent desyncs in multiplayer games. (https://mods.factorio.com/mod/CharacterModHelper/discussion/63eb2de5def1aeaa58609ed8)
    - Fixed that wrong variable was passed on to rounding function.
    - Fixed crash in output function.

  Changes:
    - The command for creating a character can't be used by players who are in god mode because they have activated SE's remote view.
Version: 1.1.3
Date: 2023-02-14

  Bugfixes:
    - Fixed crash caused by a typo.
Version: 1.1.2
Date: 2023-02-14

  Major feature:
    - Added some control scripting. If the default character has been replaced with at least two modded characters, CharacterModHelper will now recommend admins or the single player to activate a character selector mod. If you load a game after removing a character mod, you could be stuck in god mode without an easy way to get a new character. CharacterModHelper offers commands now that help you to get a usable character:
      - /CMH-make-character (Creates a new character for the player issuing the command at the first position between the player position and {0, 0} where it's possible. This will only work if the player is in god mode! Before executing this command, you should make sure that you are at a suitable position, e.g. not over water, a tiny island, or in enemy area.)
      - /CMH-move DIRECTION DISTANCE (Teleports the player between 1 and 20 chunks in the given direction.)
Version: 1.1.1
Date: 2022-04-19

  Changes:
    - Added function CharModHelper.create_prototypes(prototype_data) for the convenience of character mod authors.
    - Updated description.
Version: 1.1.0
Date: 2022-04-10

  Info:
    - This mod is meant to be used by mods that provide new characters and by character selector mods.
    - Character mods get some helper functions that allow them to concentrate on just defining their character/character-corpse prototypes, without having to handle overwriting the default or updating the new prototypes.
    - Character selector mods can call a function that will prevent all character mods using this mod from overwriting the default character.
    - Character mods must add a dependency on this mod to ensure the necessary functions are available. The dependency is optional for character selector mods -- they should also work without it.
    - If you're the author of a character or character selector mod, please refer to the files in the README directory for usage instructions!