Gather Control allows you to set a multiplier for 6 types of resource gather (pickup, resource, bonus from ore, high quality metal from ore, quarry and crop gather), separately for day and night and use permissions for individual players or groups and also adjust the multipliers for individual items and resource gather tools.
DayRateMultStaticQuarry - day multiplier for static quarry mining rating
NightRateMultStaticQuarry - night multiplier for static quarry mining rating
DayRateMultExcavator - day multiplier for excavator mining rating
NightRateMultExcavator - night multiplier for excavator mining rating
Sunrise - start time of the day
Sunset - start time of the night
UseMessageBroadcast - display messages about the beginning of a day or night for all players in chat
UseGUIAnnouncements -display messages about the beginning of a day or night for all players using GUI Announcements
BannerColor - banner color for GUI Announcements using
TextColor - text color for GUI Announcements using
UseZeroIndexForDefaultGroup - if set to true: the gather permission group with the index "0" will be applied to all players in the default group.
AdminMode - if mode set to true, a player with admin rights will be sent a chat message about gather type and the name of the item. Supports "pickup", "resourse" and "crop gather" gather types.
You can use alerts all together or any one separately.
BannerColor must be an RGBA string eg. "0.1 0.1 0.1 0.7" or you can chose from the below banner color list.
TextColor must be an RGB string eg. "1 1 1" or you can chose from the below text color list.
Banner Colors: Grey, Red, Orange, Yellow, Green, Cyan, Blue, Purple
Text Colors: White, Red, Orange, Yellow, Green, Cyan, Blue, Purple
Format for individual items multipliers:"short_prefab_name": "day_multiplier/night_multiplier"where / - separator
Format for individual resource gather tools multipliers:"short_prefab_name": "day_multiplier/night_multiplier"where / - separator
Note: Resource gather tools multipliers override all other resource gather multipliers include bonus!
Each gather permissions group should have a different numerical index. If one player has two permissions, then the resolution with the largest index will operate.
The plugin supports English and Russian by default.
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>.- gathercontrol.allowchatcommand -- Allows player to use /showrate chat command
- gathercontrol.allowconsolecommand -- Allows player to use showrate console command
- gathercontrol.bypass -- Bypasses gather rates multipliers and messages of changing day/night
Chat Commands
- /showrate -- Show player's gather multiplier
Console Commands
- showrate <name/ID> -- Show the gather multiplier for specified player
Configuration
The settings and options can be configured in the GatherControl file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.DayRateMultStaticQuarry - day multiplier for static quarry mining rating
NightRateMultStaticQuarry - night multiplier for static quarry mining rating
DayRateMultExcavator - day multiplier for excavator mining rating
NightRateMultExcavator - night multiplier for excavator mining rating
Sunrise - start time of the day
Sunset - start time of the night
UseMessageBroadcast - display messages about the beginning of a day or night for all players in chat
UseGUIAnnouncements -display messages about the beginning of a day or night for all players using GUI Announcements
BannerColor - banner color for GUI Announcements using
TextColor - text color for GUI Announcements using
UseZeroIndexForDefaultGroup - if set to true: the gather permission group with the index "0" will be applied to all players in the default group.
AdminMode - if mode set to true, a player with admin rights will be sent a chat message about gather type and the name of the item. Supports "pickup", "resourse" and "crop gather" gather types.
You can use alerts all together or any one separately.
BannerColor must be an RGBA string eg. "0.1 0.1 0.1 0.7" or you can chose from the below banner color list.
TextColor must be an RGB string eg. "1 1 1" or you can chose from the below text color list.
Banner Colors: Grey, Red, Orange, Yellow, Green, Cyan, Blue, Purple
Text Colors: White, Red, Orange, Yellow, Green, Cyan, Blue, Purple
Format for individual items multipliers:"short_prefab_name": "day_multiplier/night_multiplier"where / - separator
Format for individual resource gather tools multipliers:"short_prefab_name": "day_multiplier/night_multiplier"where / - separator
Note: Resource gather tools multipliers override all other resource gather multipliers include bonus!
Default Configuration
Stored Data
The gather permissions groups settings are stored in the date file in the oxide/data folder with the name GatherControl.json. The data file is in JSON format, which you can use any online or offline editor or JSON validator.Each gather permissions group should have a different numerical index. If one player has two permissions, then the resolution with the largest index will operate.
Default Data
Data Example
Localization
The default messages are in the GatherControl file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.The plugin supports English and Russian by default.