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

RAZI Library

by Raziphel · for Factorio

Reusable Architecture & Zero-friction Infrastructure Raziphel's shared foundation for Factorio 2.1 mods. RAZI Library provides dependable prototype editing, recipe and technology helpers, layered icons, settings utilities, validation tools, and runtime event orchestration in one lightweight dependency.

714Downloads
31d agoLast updated
MITLicense
Factorio Mod PortalSource

About RAZI Library

From Factorio Mod Portal

Reusable Architecture & Zero-friction Infrastructure Raziphel's shared foundation for Factorio 2.1 mods. RAZI Library provides dependable prototype editing, recipe and technology helpers, layered icons, settings utilities, validation tools, and runtime event orchestration in one lightweight dependency.

RAZI Library

Reusable Architecture & Zero-friction Infrastructure

RAZI Library is Raziel's lightweight shared foundation for Factorio 2.1 mods. It gathers dependable prototype editing, recipe and technology utilities, icon composition, validation, settings helpers, and runtime orchestration into one clean dependency.

RAZI makes no gameplay changes by itself. It stays passive until another mod explicitly uses one of its modules.


Why RAZI?

Factorio mods often repeat the same fragile plumbing: searching prototypes, safely changing recipes, managing technology unlocks, layering icons, registering events, and validating compatibility. RAZI provides those building blocks once, with predictable behavior and ordinary Factorio prototype tables.

  • Safe prototype editing with strict and optional lookups
  • Recipe helpers for ingredients, products, categories, quality, recycling, and technology unlocks
  • Technology tools for science packs, prerequisites, costs, effects, and infinite research
  • Item, entity, and module wrappers for common prototype operations
  • Layered icon composition with reusable badges and deterministic layouts
  • Settings and locale utilities for cleaner configuration code
  • Validation helpers that catch missing prototypes, ingredients, unlocks, and duplicate definitions
  • Runtime orchestration for events, persistent storage, and remote interfaces
  • Native Factorio 2.1 support, including multi-category recipes and current quality behavior

Built to stay out of the way

RAZI is deliberately modular. Consumer mods load only the pieces they need, keep ownership of their runtime event registries, and continue working with native Factorio data structures. There is no hidden global recipe target, automatic gameplay patching, or shared runtime state between unrelated mods.

It is suitable for small compatibility mods, focused content packs, and large overhauls such as FluxWorks.


Adding RAZI as a dependency

Add the following entry to your mod's info.json dependencies:

"razi_lib >= 1.0.0"

Then import only the module you need:

local Recipe = require("__razi_lib__/lib/recipe")
local Technology = require("__razi_lib__/lib/technology")

Recipe.get("iron-gear-wheel")
  :upsert_ingredient({ type = "item", name = "steel-plate", amount = 1 })
  :set_energy(1)

Technology.get("automation")
  :add_prerequisite("steel-processing")
  :unlock("my-recipe")

Compatibility philosophy

  • Factorio 2.1 native
  • No Space Age dependency
  • Passive unless called by a consumer
  • Snake-case API with focused compatibility aliases
  • Designed for deterministic, repeatable data-stage edits
  • Pure-Lua regression tests plus real Factorio prototype validation

RAZI is primarily a library for mod developers. Players should install it when another enabled mod lists it as a dependency.

Highlights

From source data

Footprint

Rated a light load on a server.

License

Published under MIT.

Last update

Its author last shipped an update 31d ago.

RAZI Library 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
1.3.2, released 2026-10-22

Recent builds

BuildReleasedGame versionsLoaders
1.3.22026-10-222.1n/a
1.3.12026-10-202.1n/a
1.2.02026-10-152.1n/a
1.0.02026-08-012.1n/a

Run RAZI Library 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”

Libraries & compatibility

Foundations and fixes other mods build on. Usually installed because something else needs it.

Runs on your server

From source side support

Factorio Mod Portal lists RAZI Library 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

Verified at the source

  • ✓Factorio Mod PortalOfficial listing, checked 2026-10-23Open ↗
  • ✓AuthorRaziphel, as published on Factorio Mod Portal
  • ✓LicenseMITFree

RAZI Library, answered

Generated from the mod’s own source data.

Do my players need to install RAZI Library?

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

Is it free?

Yes. RAZI Library 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 RAZI Library on a Factorio server.

Deploy in about a minute from $2.99 a month, then add RAZI Library in one click.