Trusted Free Cousin Custom Rates 1.7

## CousinCustomRates — v1.7 is out!

### AsaApi 2.11 support
Rebuilt for the new AsaApi 2.11 (UE 5.8 headers). AsaApi 2.11 or newer is now required, so update AsaApi and the plugin together.

### Decimal tribe harvest multipliers
Tribe-size harvest multipliers now support decimals like 1.5x:

• With a global 10x harvest, { "TribeSize": 1, "Multiplier": 1.5 } gives 15x
• Leftover fractions carry over between grants, so ten 1-item grants at 1.5x give 15 items, not 20

### Stability

• Harvest boosts can no longer crash the server or eat a harvest if something goes wrong; the harvest just goes through normally
• Rate schedule, timed presets and startup preset restore are now crash-protected
• A broken config.json keeps the previous config active instead of breaking the plugin

### Updating
Drop-in update: no config changes needed. Just replace the DLL and PluginInfo.json.

Not a plugin so it support natively the new AsaApi 2.11 (UE 5.8 headers)

CousinCustomRates Update — Fractional Tribe Multipliers Fixed

Fixed an issue where fractional TribeSizeMultiplier values, such as 1.5, could be rounded per item grant and apply as a higher rate than intended.

Example:

• Global harvest: 10x
• Tribe size 1 multiplier: 1.5x
• Intended final rate: 15x

Decimal remainders are now carried across harvest item grants, so fractional multipliers scale correctly over the full harvest instead of rounding every individual item upward.

Update — CousinCustomRates

New options are now available to better manage custom harvesting rates!

### ChangePlayerRate

This command can now apply a special harvesting rate to one player or their entire tribe.

Code:Copy to clipboard

changePlayerRate <EOS_ID>

Configuration:

JSON:Copy to clipboard

"ChangePlayerRate": {
  "Enable": true,
  "AlsoForTheTribe": true,
  "Multiplier": false,
  "HarvestAmount": 4.0,
  "DurationMinutes": 240,
  "ActivationMessage": "Your {rate}x harvesting bonus is now active for {duration} minute(s)!",
  "ExpiryMessage": "Your {rate}x harvesting bonus for {duration} minute(s) has now expired."
}

- Multiplier: false → applies a final fixed harvesting rate.
Example: HarvestAmount: 4.0 gives exactly 4x harvesting, unaffected by global server rates or tribe-size multipliers.

• AlsoForTheTribe: true → applies the bonus to every tribe member and tribe-owned dinosaur.
• DurationMinutes: 240 → the bonus lasts for 4 hours.
• To remove an active bonus before it expires:

Code:Copy to clipboard

changePlayerRate <EOS_ID> off

### New customizable messages

Two new keys let you customize the private messages sent to the player:

• ActivationMessage — sent when the harvesting bonus is activated.
• ExpiryMessage — sent when the harvesting bonus expires.

Available placeholders:

• {rate} → the final harvesting rate.
• {duration} → the bonus duration in minutes.

### Tribe-size rates

A new option also allows you to configure harvesting multipliers based on a tribe's total number of members:

JSON:Copy to clipboard

"TribeSizeMultiplier": {
  "Enabled": true,
  "Multipliers": [
    { "TribeSize": 1, "Multiplier": 4.0 },
    { "TribeSize": 2, "Multiplier": 3.0 },
    { "TribeSize": 3, "Multiplier": 2.0 },
    { "TribeSize": 6, "Multiplier": 0.5 }
  ]
}

Each rule applies only when the tribe has the exact configured number of members.

Fixed an issue where saved rate presets could fail to restore after a server restart. Rates now restore after the server world is fully ready, preventing the occasional AShooterGameState is null error.

Now Support the new ASA API 2.1

Just the files

Commands now work in the in-game admin console

changerates and CousinCustomRates.Reload now work directly from the in-game admin console (Tab key) — no need to go through RCON anymore.

---

Timed Presets

Rate presets can now have a Duration (in minutes). When activated, rates automatically revert after the countdown — no admin needed to switch them back.

• While a timed event is running, the automatic scheduler is paused so it can't interrupt mid-event
• When the timer expires, rates revert to whatever the scheduler says should be active — or back to what was running before the event if no schedule rule matches
• If the server restarts mid-event, the countdown picks up where it left off

---

Improved Schedule System

The schedule system has been overhauled with two new additions:

Day-range rules — Instead of listing individual days with a fixed hour window, you can now define a continuous range from one day/hour to another:

{ "Preset": "weekend_rates", "StartDay": "Friday", "StartHour": 16, "EndDay": "Sunday", "EndHour": 16 }<br>
This activates Friday at 16:00 and runs continuously through all of Saturday until Sunday 16:00 — no gaps, no workarounds needed.

Per-rule toggle — Any schedule rule can now be disabled without deleting it:

{ "Enabled": false, "Preset": "event_rates", ... }<br>
Default fallback preset — Define a DefaultPreset that kicks in whenever no schedule rule matches the current time — so there's always a known baseline active:

"Schedule": { "DefaultPreset": "normal_rates", ... }<br>

---

Discord notifications only on actual rate changes

Discord webhooks and in-game broadcasts now only fire when rates are actively changed (command, scheduler, or timed expiry). Server restarts that silently restore the saved preset no longer send any notifications.

---

Config validation on every load

Every time config.json is loaded or reloaded, the plugin validates the full structure and logs any issues directly to the server log — making config mistakes easy to catch.

---

How to use timed presets

Add "Duration": 120 (minutes) to any preset in config.json, make sure "TimedPresets": { "Enabled": true } is set, then run:

changerates event_rates<br>
Rates will revert automatically after 2 hours.