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

RPG

by Gerkiz · for Factorio

A Diablo like RPG stats system - now with magic!

13KDownloads
5 mo agoLast updated
CC BY-NC-ND 4.0License
2.1Latest game version

About RPG

From Factorio Mod Portal

A Diablo like RPG stats system - now with magic!

RPG

This mod is still under active development. If you find any issues or would like a setting implemented, please open an issue on GitHub and I’ll take a look.

RPG

RPG Settings

RPGSETTINGS

Mod Settings

These settings can be changed ONLY at startup. MODSETTINGSRUNTIME

These settings can be changed at any time by an admin. MODSETTINGSRUNTIME


Spells

SPELLS

Remote Interface

The following remote interfaces exist for other developers to utilize:

  • remote.call("RPG", "add_new_projectile", "projectile_name", projectile) -- adds a new projectile
  • remote.call("RPG", "add_new_spell", spell) -- adds a new spell
  • remote.call("RPG", "rpg_reset_player", "player_name") -- reset a player
  • remote.call("RPG", "give_xp", 3000) -- give all players some xp
  • remote.call("RPG", "gain_xp", "player_name", 3000) -- give a player some xp

Projectiles

Adding new projectiles should be fairly simple. Note, this cannot be used if game has been initialized.

By calling:

local projectile = { -- reference to the interface call
	name = 'cluster-grenade', -- the projectile to create
	count = 1, -- the amount of projectiles to spawn
	max_range = 32, -- the max range the projectile can travel
	tick_speed = 1, -- currently not used
}
remote.call("RPG", "add_new_projectile", "projectile_name", projectile) -- projectile_name is what you're gonna reference when wanting to create this projectile

Spells

Adding new spells should be fairly simple. Note, this cannot be used if game has been initialized.

By calling:

local spell = { -- reference to the interface call
	name = {'spells.drone_mine'}, -- localized text, reference this in your own mod
	entityName = 'stone-wall', -- the entity to spawn
	target = false, -- false if the spell should not hit anything
	force = 'player', -- in string, what force this entity should be
	level = 200, -- the level limit before a player can use it
	type = 'special', -- item/entity/special
	mana_cost = 1000, -- mana cost of the spell
	cooldown = 18000, -- cooldown for the spell. global cooldown must NOT be disabled, else use enforce_cooldown
	enabled = true, -- if the spell should be enabled or not (if players can use it)
	enforce_cooldown = true, -- if global cooldown is disabled, use this if you want to have a cooldown
	log_spell = true, -- currently does nothing
	sprite = 'virtual-signal/signal-info', -- the sprite when viewing the spell "book"
	special_sprite = 'virtual-signal=signal-info', -- if this is a special spell, this needs to be set
	tooltip = 'Creates a drone that mines entities around you. This is a WIP spell that might get disabled.', -- the tooltip, either localized or as string
	callback = function(data) -- the callback to what to actually do with the spell
		-- NOTE! the callback automatically includes: data and funcs, use them if you want.
		-- local data = { --- data consists of the following
		--     self = spell, -- self reference to the spell
		--     player = player, -- the player who is casting the spell
		--     damage_entity = damage_entity, -- the damage to be done if this is an entity
		--     position = position, -- the position to spawn this spell at
		--     surface = surface, -- the surface to spawn this spell at
		--     force = force, -- the spell force
		--     target_pos = target_pos, -- the target position to "hit"
		--     range = range, -- the range for spell
		--     tame_unit_effects = tame_unit_effects, -- unused
		--     rpg_t = rpg_t -- the global rpg table of the player
		-- }
		-- local funcs = {
		--     remove_mana = Public.remove_mana, -- reference to Functions.remove_mana, i.e remove mana from the player
		--     damage_player_over_time = Public.damage_player_over_time, -- if the spell should damage the player over time
		--     cast_spell = Public.cast_spell -- if the spell was cast or failed
		-- }

		local self = data.self -- spell reference
		local player = data.player -- player who is casting the spell
		Ai.create_char({player_index = player.index, command = 2, search_local = false}) -- do something

		Public.cast_spell(player) -- the spell was success, else call cast_spell(player, true)
		Public.remove_mana(player, self.mana_cost) -- remove mana from the player if the spell was casted successfully
		return true -- either return true or false if the spell was casted successfully
	end
}
remote.call("RPG", "add_new_spell", spell)

Bugs

None? Let me know!


Information

This version of RPG is the one that will be always up to date. We run this module in our scenario that we host at Comfy.

Highlights

From source data

Game versions

Built for Factorio 2.1.

Footprint

Rated a light load on a server.

License

Published under CC BY-NC-ND 4.0.

RPG 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-06-24

Run RPG 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 RPG 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 ↗
  • ✓AuthorGerkiz, as published on Factorio Mod Portal
  • ✓LicenseCC BY-NC-ND 4.0Free

RPG, answered

Generated from the mod’s own source data.

Do my players need to install RPG?

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

Is it free?

Yes. RPG is free to download from Factorio Mod Portal. Its license is CC BY-NC-ND 4.0.

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 RPG on a Factorio server.

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