RitnLib

FR — Bibliothèque pour mods Factorio : raccourcis sur data.raw, wrappers sur les classes runtime (LuaPlayer, LuaForce, LuaEntity…), constructeur de GUI, builder de mod settings, snapshot d'inventaires.

EN — Library for Factorio mods: shortcuts over data.raw, wrappers for the runtime classes (LuaPlayer, LuaForce, LuaEntity…), GUI builder, mod settings builder, inventory snapshot.

🇬🇧 English

RitnLib is a library mod for Factorio 2.0. It doesn't add anything to the game — it serves as a dependency for other mods, shortening the Factorio patterns that come up in every non-trivial mod: mutating data.raw, handling entities, dispatching events, building a GUI, declaring mod settings, snapshotting an inventory…

What it looks like

Without RitnLib, snapshot and restore on respawn:

script.on_event(defines.events.on_player_died, function(event)
    storage.snapshots = storage.snapshots or {}
    local player = game.get_player(event.player_index)
    if not storage.snapshots[player.name] then
        storage.snapshots[player.name] = {
            [defines.inventory.character_main]  = game.create_inventory(65535),
            [defines.inventory.character_guns]  = game.create_inventory(65535),
            [defines.inventory.character_ammo]  = game.create_inventory(65535),
            [defines.inventory.character_armor] = game.create_inventory(65535),
            [defines.inventory.character_trash] = game.create_inventory(65535),
        }
    end
    for define, snapshot in pairs(storage.snapshots[player.name]) do
        local inv = player.get_inventory(define)
        for i = 1, #inv do
            if inv[i].valid then snapshot[i].swap_stack(inv[i]) end
        end
    end
end)

script.on_event(defines.events.on_player_respawned, function(event)
    -- … mirror of the above, the other way around …
end)

With RitnLib:

script.on_event(defines.events.on_player_died, function(event)
    storage.snapshots = storage.snapshots or {}
    RitnLibInventory(game.get_player(event.player_index), storage.snapshots):save()
end)

script.on_event(defines.events.on_player_respawned, function(event)
    RitnLibInventory(game.get_player(event.player_index), storage.snapshots):load()
end)

That's the idea across the whole library: you state what you want to do, RitnLib handles the Factorio plumbing.

What's inside

Data stage — mutating `data.raw`

RitnProtoRecipe — disable, hide, modify ingredients, retint science packs.
RitnProtoTechnology — disable (with prerequisite purge), add/remove/replace science packs, manage lab.inputs, unlock/remove recipes.
RitnProtoEntity, RitnProtoItem, RitnProtoOre (with autoplace), RitnProtoSprite, RitnProtoStyle.
RitnProtoItemGroup, RitnProtoItemSubgroup, RitnProtoRecipeCategory, RitnProtoFuelCategory, RitnProtoCustomInput, RitnProtoUtilityConst.
Ready-to-require fonts ritn-default-{12..20} (normal + bold) and a set of GUI styles *-ritngui.
Helpers for data.raw['gui-style'].default and a local fork of the engine's util.lua.

Control stage — runtime

Wrappers: RitnLibPlayer, RitnLibSurface, RitnLibForce, RitnLibEntity, RitnLibRecipe, RitnLibTechnology.
RitnLibEvent(event) — normalizes any Factorio event and exposes event.player, event.surface, event.force, event.entity, event.recipe, event.technology, event.inventory, event.element, event.area, event.position… without having to remember each event's structure.
RitnLibInventory — snapshot/restore (main, guns, ammo, armor, trash, cursor) via game.create_inventory.
RitnLibGui + RitnLibGuiElement + RitnLibStyle — chained GUI construction, click dispatcher via remote.call("<your-mod>", "gui_action_<gui_name>", …).

Settings stage

RitnLibSetting — builder for data:extend({...}) (bool-setting, int-setting, double-setting, string-setting, color-setting; scope startup/runtime-global/runtime-per-user).

Integrations with other mods

Ready remote.calls for the freeplay scenario: set_created_items, set_respawn_items, set_skip_intro, set_disable_crashsite.
remote.call("silo_script", "set_no_victory", …).
Optional DiscoScience.setIngredientColor hook for custom science packs.
Automatic detection of gvv (global-state debugger) and zk-lib (optimized event_handler).

Status

Factorio 2.0 migration is in progress. A few methods still carry 1.x branches (recipe normal/expensive, force.items_launched, hr_version on sprites…). Code is being cleaned up version after version — see changelog.txt.

Installation

Subscribe via the in-game Mod Portal, or clone this repository into Factorio/mods/RitnLib/.

Then add "RitnLib" to your own mod's info.json dependencies:

{
  "name": "my-mod",
  "dependencies": [ "base", "RitnLib" ]
}

Documentation

📖 Documentation — guides and class reference (EN · FR)
🏗 Internal architecture (FR, maintainer-facing)
📜 Changelog

Source / Issues

💾 GitHub repository
🐛 Report an issue

License

🇫🇷 Français

RitnLib est un library mod pour Factorio 2.0. Il n'ajoute rien au jeu — il sert de dépendance à d'autres mods pour raccourcir les patterns Factorio qui reviennent dans tout mod un peu sérieux : modifier data.raw, manipuler des entités, gérer des events, monter une GUI, créer des settings, sauvegarder un inventaire…

Concrètement, à quoi ça ressemble

Sans RitnLib, snapshot et restauration d'inventaire au respawn :

script.on_event(defines.events.on_player_died, function(event)
    storage.snapshots = storage.snapshots or {}
    local player = game.get_player(event.player_index)
    if not storage.snapshots[player.name] then
        storage.snapshots[player.name] = {
            [defines.inventory.character_main]  = game.create_inventory(65535),
            [defines.inventory.character_guns]  = game.create_inventory(65535),
            [defines.inventory.character_ammo]  = game.create_inventory(65535),
            [defines.inventory.character_armor] = game.create_inventory(65535),
            [defines.inventory.character_trash] = game.create_inventory(65535),
        }
    end
    for define, snapshot in pairs(storage.snapshots[player.name]) do
        local inv = player.get_inventory(define)
        for i = 1, #inv do
            if inv[i].valid then snapshot[i].swap_stack(inv[i]) end
        end
    end
end)

script.on_event(defines.events.on_player_respawned, function(event)
    -- … miroir du bloc ci-dessus, dans l'autre sens …
end)

Avec RitnLib :

script.on_event(defines.events.on_player_died, function(event)
    storage.snapshots = storage.snapshots or {}
    RitnLibInventory(game.get_player(event.player_index), storage.snapshots):save()
end)

script.on_event(defines.events.on_player_respawned, function(event)
    RitnLibInventory(game.get_player(event.player_index), storage.snapshots):load()
end)

C'est l'idée pour chaque sous-système : tu écris ce que tu veux faire, RitnLib s'occupe de la plomberie Factorio.

Ce qu'il y a dedans

Data stage — manipuler `data.raw`

RitnProtoRecipe — désactiver, cacher, modifier ingrédients, changer le tint des packs de science.
RitnProtoTechnology — désactiver (avec purge des prerequisites), ajouter/retirer/remplacer des packs, gérer les lab.inputs, débloquer/retirer des recettes.
RitnProtoEntity, RitnProtoItem, RitnProtoOre (avec autoplace), RitnProtoSprite, RitnProtoStyle.
RitnProtoItemGroup, RitnProtoItemSubgroup, RitnProtoRecipeCategory, RitnProtoFuelCategory, RitnProtoCustomInput, RitnProtoUtilityConst.
Polices ritn-default-{12..20} (normal + bold) et un set de styles GUI *-ritngui prêts à require.
Helpers pour data.raw['gui-style'].default et fork local du util.lua du moteur.

Control stage — runtime

Wrappers : RitnLibPlayer, RitnLibSurface, RitnLibForce, RitnLibEntity, RitnLibRecipe, RitnLibTechnology.
RitnLibEvent(event) — normalise n'importe quel event Factorio et expose directement event.player, event.surface, event.force, event.entity, event.recipe, event.technology, event.inventory, event.element, event.area, event.position… sans avoir à connaître la structure de chaque event.
RitnLibInventory — snapshot/restore (main, guns, ammo, armor, trash, cursor) via game.create_inventory.
RitnLibGui + RitnLibGuiElement + RitnLibStyle — construction GUI chaînée, dispatcher de clic via remote.call("<ton-mod>", "gui_action_<gui_name>", …).

Settings stage

RitnLibSetting — builder pour data:extend({...}) (bool-setting, int-setting, double-setting, string-setting, color-setting ; portée startup/runtime-global/runtime-per-user).

Intégrations avec d'autres mods

remote.call prêts pour le scénario freeplay : set_created_items, set_respawn_items, set_skip_intro, set_disable_crashsite.
remote.call("silo_script", "set_no_victory", …).
Hook optionnel DiscoScience.setIngredientColor pour les packs de science custom.
Détection automatique de gvv (debugger d'état global) et zk-lib (event_handler optimisé).

Statut

Migration Factorio 2.0 en cours. Quelques méthodes contiennent encore des branches 1.x (recipe normal/expensive, force.items_launched, hr_version sur les sprites…). Le code se nettoie version après version — voir changelog.txt.

Installation

S'abonner depuis le Mod Portal en jeu, ou cloner ce dépôt dans Factorio/mods/RitnLib/.

Puis ajouter "RitnLib" aux dependencies du info.json de ton propre mod :

{
  "name": "mon-mod",
  "dependencies": [ "base", "RitnLib" ]
}

Documentation

📖 Documentation — guides et référence des classes (FR · EN)
🏗 Architecture interne (FR, mainteneur)
📜 Changelog

Source / Issues

💾 Dépôt GitHub
🐛 Signaler un bug

RitnLib

RitnLib

🇬🇧 English

What it looks like

What's inside

Data stage — mutating data.raw

Control stage — runtime

Settings stage

Integrations with other mods

Status

Installation

Documentation

Source / Issues

License

🇫🇷 Français

Concrètement, à quoi ça ressemble

Ce qu'il y a dedans

Data stage — manipuler data.raw

Control stage — runtime

Settings stage

Intégrations avec d'autres mods

Statut

Installation

Documentation

Source / Issues

Data stage — mutating `data.raw`

Data stage — manipuler `data.raw`