bbassieandClaude Opus 5
bbd3b7c1f2
Clusterio already stores roles, the permissions they grant, and which user holds which role, along with a web UI for all three. What it does not have is the properties a role only needs in game, or a way for an instance to learn about any of it, since role and user updates are only sent to control connections. This plugin fills both gaps. The controller keeps a record per role holding the order, priority, short hand, tag, colour and auto assign threshold, created automatically for any role which does not have one. It then rebroadcasts roles and assignments on its own events so instances can follow them. The lua module presents the same interface the legacy expcore.roles module did, so the call sites can be moved over without being rewritten. Permission checks translate the legacy action strings using the same mapping exp_scenario defines. Two things replace features the legacy system had: - Priority replaces disallow. Only the roles with the highest priority a player holds are considered, so Jail can suppress every other role including the default one, without needing to take roles away first. - Assignments made in game are applied locally and then sent to the controller, which keeps assign_player synchronous for callers. A role which should never leave this map, such as one earned from time on the map, is assigned with assign_player_local instead. Roles earned from online time across the cluster are granted by the controller from the threshold on the role, using the online time clusterio already tracks. Nothing requires this plugin yet; moving the call sites off expcore.roles and removing the legacy config is left for a follow up. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ExpGaming Clusterio Repository
Explosive Gaming
Explosive Gaming (often ExpGaming) is a server hosting community with a strong focus on Factorio and games with similar themes. We are best known for our weekly reset Factorio server with a vanilla+ scenario where we add new features and mechanics that are balanced with base game progression. Although our servers tend to attract the more experienced players, our servers are open to everyone. You can find us through our website, discord, or the public server list with the name ExpGaming.
Installation
This is a plugin collection for Clusterio which implements all our scenario features.
To use this plugin you must have a clusterio instance running, see here for clusterio installation instructions.
This module is currently not published and therefore can not be installed via npm. Instead follow the steps for building from source
Building from source
- Create a
external_pluginsdirectory within your clusterio instance. - Clone this repository into that directory:
git clone https://github.com/explosivegaming/ExpCluster - Install the package dev dependencies:
pnpm install(pnpmis recommended overnpm) - Add supported plugins will be loaded on next controller / host restart.
Contributing
See Contributing for how to make pull requests and issues.
Releases
| Release* | Release Name | Factorio Version** |
|---|---|---|
| 6.4 | Farewell Factorio 1.1 | 1.1.110 |
| 6.3 | Feature Bundle 2: Electric Boogaloo | 1.1.101 |
| 6.2 | Mega Feature Bundle | 1.1.32 |
| 6.1 | External Data Overhaul | 1.0.0 |
| 6.0 | Gui / 0.18 Overhaul | 0.18.17 |
| 5.10 | Data Store Rewrite | 0.17.71 |
| 5.9 | Control Modules and Documentation | 0.17.63 |
| 5.8 | Home and Chat Bot | 0.17.47 |
| 5.7 | Warp System | 0.17.47 |
| 5.6 | Information Guis | 0.17.44 |
| 5.5 | Gui System | 0.17.43 |
| 5.4 | Admin Controls | 0.17.32 |
| 5.3 | Custom Roles | 0.17.28 |
| 5.2 | Quality of life | 0.17.22 |
| 5.1 | Permission Groups | 0.17.13 |
| 5.0 | 0.17 Overhaul | 0.17 |
| 4.0 | Softmod Manager | 0.16.51 |
| 3.0 | 0.16 Overhaul | 0.16 |
| 2.0 | Localization and clean up | 0.15 |
| 1.0 | Modulation | 0.15 |
| 0.1 | First Tracked Version | 0.14 |
* Scenario patch releases have been omitted and can be found here.
** Factorio versions show the version they were made for, often the minimum requirement to run the scenario.
License
The Explosive Gaming codebase is licensed under the MIT