Config Permissions
Simple Config can allow players to edit remote configuration for a server as easily as if the configuration was local. To protect server integrity, Simple Config supports a role-based rule system for granting players viewing and editing permissions for the configuration of different mods on the server.
Simple Config permissions can be edited within Simple Config's own server config. To get there, the shortest (in 1.18+) is by logging in the server and typing in the command /config edit simpleconfig.
Alternatively, either make sure the feature "Add Pause Menu Button" is enabled in Simple Config's client config (should be by default) and use the extra button that it adds to the pause menu once logged in the server to bring up the mod list screen, where you can search for Simple Config and open its config, or assign a hotkey from Simple Config's client config to either open the mod list screen or directly Simple Config's config menu, and use it.
Once in Simple Config's own config menu, switch to the Server config tab, either by clicking the button with the blue icon in the main toolbar or by pressing Alt+PgDn enough times. Once there, make sure you're in the Server category tab and not in the Demo category tab from the second tabbar.
Simple Config differentiates between the following permissions:
- Server Config Permissions: Allow players to see or to edit server configs for different mods. This includes server configs and the server version of common configs (see Config Types).
- Save Remote Config Presets: Allow players to save/delete config presets in the server, so other players can use them. Config presets can be used to quickly change many config values in one step. Even if authorized players can upload config presets in the server, other players applying them won't be able to apply changes to entries they cannot edit themselves.
- Save Config Hotkey Groups: Allow players to save/delete config hotkeys in the server, so other players can use them.
In order to assign all the above permissions to all players in a server, Simple Config lets you define an ordered list of rules, which assign permissions to roles, and lets you assign roles to players.
Unlike some other role-based systems, roles do not have a hierarchy, because there are only 3 types of permissions and the rule system is enough. To determine a certain permission for some player, all defined rules are evaluated in order, and the last rule that applies to both the player and the permission gives the result.
If no rules apply, the permission is denied, albeit there're some exceptions. Top level operators (permission level 4) always have all permissions, regardless of the rules.
Config and preset permissions can be specific to mods, that is, you can allow some players to edit server configs only for some mods. This is done by specifying the mod ID in the rules. If you really want to fine-tune the permissions so much, you can define also mod groups, to reference multiple mods from a single rule. Mod groups can be defined either with a whitelist or a blacklist of mod IDs.
Simple Config defines a built-in [op] role, which includes all operators of the server (permission level ≥ 2).
To apply a rule to all mods in the server, you may use the built-in [all] mod group, which includes all mods.