Custom Challenges 1.5.1

This plugin gives the possibility to trigger a timed event, with a random long time (choose randomly between min and max configured time). The event will choose randomly a type, KILL or Gather (prior the config), after it choose a random objective from the corresponding list.

During the event, after the objective is triggered (for example: Sulfur ore mined completely, Barrel destroyed, Bear killed, Tree chopped down.. etc), the player will get point /objective. Top 3 player (or player group if there is even in the points) will get reward, if they reach the minimum configured point.

If the Players not gain points, they will be not listed on the Scoreboard. Rewards can be claimed after the event(s) over.

First event will start after 5 min as soon as the plugin loaded in.

The plugin have several protection against wrong configuration.

• Only 1 event can be active at time. If the TIME related configurations allow overlay, the maximum event time will be set as (event_repeat_time_in_hour*60)-5 Minute, to not affect the next event start.
• If no event type enabled, no event will started and message will be written to the server console.
• If no reward or invalid reward number set in the configuration, list of rewards will be cleared, 0 and 1 will be added as default (see the meaning below).
• If ServerRewards/Economics plugin not installed, this type of reward will be not selected.

Configuration

Default configuration:

{
  "_Plugin_Cfg_Version": {
    "Major": 1,
    "Minor": 2,
    "Patch": 0
  },
  "CCH_Challenge_color": "0.76 0.90 0.29 1",
  "CCH_Desc_color": "0.76 0.90 0.29 1",
  "CCH_ScoresPanel_color": "0.39 0.39 0.39 0.75",
  "CCH_Time_color": "0.76 0.90 0.29 1",
  "CCH_Top1_color": "1 1 1 1",
  "CCH_Top2_color": "1 1 1 1",
  "CCH_Top3_color": "1 1 1 1",
  "CCH_Top3_yourpoint_color": "1 1 1 1",
  "CCH_UIPanel_color": "0.39 0.39 0.39 0.5",
  "event_gather_type": "{\"tree\":15,\"metal\":15,\"sulfur\":15,\"stone\":15,\"barrel\":15,\"berry\":15,\"corn\":15,\"hemp\":15,\"mushroom\":15,\"pumpkin\":15,\"potato\":15,\"crate\":15,\"foodbox\":15,\"minecart\":15}",
  "event_gather_type_enabled": true,
  "event_kill_type": "{\"bear\":15,\"wolf\":15,\"boar\":15,\"murderer\":15,\"scientist\":15,\"scarecrow\":15}",
  "event_kill_type_enabled": true,
  "event_long_max_in_minute": 1,
  "event_long_min_in_minute": 1,
  "event_minimum_player": 1,
  "event_points_by_entity": 5,
  "event_repeat_time_in_hour": 2,
  "event_reward_type": "0, 1, 2, 3",
  "event_top1_reward": 18,
  "event_top2_reward": 12,
  "event_top3_reward": 6,
  "grownable_collect_enabled": false,
  "rp_reward_multiplier": 10.0,
  "economics_reward_multiplier": 10.0,
  "reminder_enabled": true,
  "reminder_time_in_minute" : 30
}

Definition of configurations:

event_gather_type - List of collect/gatherable items, next to them after the ":" the minimum points to earn reward. (For example not much foodbox or minecart spawned)
event_gather_type_enable - Gather type of events can be disabled/enable
event_kill_type - List of killable enemys, next to them after the ":" the minimum points to earn reward. (For example not much animal spawned)
event_kill_type_enabled - Gather type of events can be disabled/enable
event_long_max_in_minute - Minimum Time for a generated event (Time choosen randomly between min and max)
event_long_min_in_minute - Maximum Time for a generated event (Time choosen randomly between min and max)
event_minimum_player - Minimum Player number. Below this the event will not started
event_points_by_entity - Point gained by gather/kill one of the objective
event_repeat_time_in_hour - Events repeated in every given hour
event_reward_type - 0 - (Bronze Easter Egg - item ID: 844440409) 1 - ( Small Halloween Bag item ID: 1319617282) 2 - RP from [ServerRewards plugin if installed, if not, it can not be choosen even if in the list](https://umod.org/plugins/server-rewards) 
event_top1_reward - Amount of choosen item/RP(base for a the rp_reward_multiplier below) for the first place
event_top2_reward - Amount of choosen item/RP(base for a the rp_reward_multiplier below) for the second place
event_top3_reward - Amount of choosen item/RP(base for a the rp_reward_multiplier below) for the third place
grownable_collect_enabled - To avoid player advantage, with big crop farms, the growned crops can be disabled/enabled to count as a gathered objective
rp_reward_multiplier - ServerRewards multiplier for the RP reward, if the event is generated to give RP as a reward.
economics_reward_multiplier - Economics multiplier for the Economics reward, if the event is generated to give Economics as a reward.
reminder_enabled - enable/disable the repeated reminder to the players with unclaimed reward
reminder_time_in_minute - reminder time in minute format
Colors: the first 3 number is the corresponding RGB color number, but between 0-1 with float numbers. So if you want to write an RGB, where the RED is 210, then the first number in the config will be 210/255=0.82. The last number is the opacity 0 is invisible, 1 the maximum.
_Plugin_Cfg_Version - only present for compatibility check

Commands

/cch info  - Show information about Custom Challenges
/cch show  - Show currently Active Challenge Scoreboard
/cch hide  - Hide Challenge Scoreboard
/cch claim - Claim rewards after event(s)

Localization

English language file generated by default, texts supported by the language files.

Logging

Reported winner and claimed rewards stored in the oxide/logs folder.