Global Progression is a plugin primarily designed to balance PVP servers by globally unlocking blueprints as they are learned by players. The plugin is meant to mitigate the dominating effect that a server's "established" players will have on new players.
In order to retain the value of learning blueprints, there is a configurable delay and player threshold for blueprint learning. This will mean that the first X players (threshold) who learn the blueprint will have an advantage for Y seconds (delay) until that blueprint is globally unlocked.
For example: if the player threshold is set to 4 and a delay of 3600 (seconds), the first 3 players to learn the blueprint will exclusively have the blueprint unlocked until the 4th player learns it. And once the 4th player learns the blueprint, a countdown begins and the blueprint will unlock for ALL players after 3600s (1hr). Additionally, a blueprint that is on countdown can be BLOCKED from any additional players learning it until it is globally unlocked, giving additional incentive to research.
It is recommended to load this plugin initially with a freshly wiped server (including blueprints!)
Default config, with commentary:
In order to retain the value of learning blueprints, there is a configurable delay and player threshold for blueprint learning. This will mean that the first X players (threshold) who learn the blueprint will have an advantage for Y seconds (delay) until that blueprint is globally unlocked.
For example: if the player threshold is set to 4 and a delay of 3600 (seconds), the first 3 players to learn the blueprint will exclusively have the blueprint unlocked until the 4th player learns it. And once the 4th player learns the blueprint, a countdown begins and the blueprint will unlock for ALL players after 3600s (1hr). Additionally, a blueprint that is on countdown can be BLOCKED from any additional players learning it until it is globally unlocked, giving additional incentive to research.
It is recommended to load this plugin initially with a freshly wiped server (including blueprints!)
Features
- Ignore list - Players can be excluded from triggering global unlocks and learning global blueprints. (Permission-based)
- Player Threshold - Configurable number of players who need to learn a blueprint to start the global unlock countdown (default 1)
- Delay - Configurable amount of time in seconds to unlock a blueprint after the player threshold is met; a delay of 0 will instantly unlock the blueprint globally (default 600s)
- Blocking - Block players from learning a blueprint while the blueprint is on countdown (default false)
Permissions
This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.- globalprogression.admin - Admin permission; gives access to console commands
- globalprogression.ignore - Players with this permission will be a part of the "ignore list", so they will not trigger blueprint unlocks, nor learn globally-unlocked blueprints.
Commands
This plugin provides both chat and console commands using the same syntax. When using a command in chat, prefix it with a forward slash: `/`.Console Commands
Require permission globalprogression.admin:- gp.refresh - Refresh unlocked blueprints by checking all active/sleeping players' blueprints and unlocking them globally. Does not include players who have joined previously but have no sleeper! May not be the most performant...
Chat Commands
- /gpq - Print a list of currently queued blueprints for unlocking
Configuration
The settings and options can be configured in the GlobalProgression file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.Default config, with commentary:
