Trusted Paid Cousin Tribe Ladder 2.0

## Tribe Ladder – Tribe & Raid Scoring Update

A new tribe-focused scoring update is coming after a few clients requests.

### New features

• Offline tribe detection: Raids against tribes with no connected members can now receive reduced score rewards.
• Online tribe-size multipliers: Score gain/loss can be adjusted based on the difference in online players between attacking and defending tribes.

- 1 = 1 player difference
- 2 = 2 player difference
- 3 = 3 or more player difference

• Custom structure Gain/Loss values: Custom structure entries can now use separate attacker reward and defender loss values.
• Player/tribe database sync: The plugin periodically refreshes connected players' names, tribe names, tribe IDs, levels, and other metadata to help correct outdated information.

### Important behavior

• Online/offline status is checked using players connected to the current server/map only.
• A connected tribe member counts as online, even if they are AFK, far from base, unconscious, etc.
• Existing configurations remain compatible. Older custom structure entries using "Points" still work.

### Testing needed
Because this is a tribe-oriented feature and difficult to fully test as a solo developer, I need help testing it on a live/staging server:

• Offline raid scoring with every defender logged out.
• Online raid scoring with one or more defenders connected.
• Tribe-size differences: 1, 2, and 3+ players.
• Player kills, tamed dino kills, and structure destruction.
• Custom structures using separate Gain and Loss values.
• Tribe name, tribe membership, and player-name changes updating in the database.

Please report any unexpected point gain/loss results, missing score updates, duplicate score updates, or incorrect online/offline detection with as much detail as possible.

• Removed tribe synch stuff that was not supposed to be released.
• Points can now be deducted from players when structures are destroyed
• Points can now be deducted from players they die
• Points can now be deducted from when their dinos die

JSON:Copy to clipboard

    "LosePointsOnGettingKill": false,
    "LosePointsOnDinoKill": false,
    "LosePointsOnDestroy": false,

New Feature: Custom Structure Point Values!

You can now assign custom point values to specific structures for your TribeScore raid scoring — instead of only the generic default/metal/tek/industrial/heavy tiers! This will also work for modded structures Like ORP or whatever !

What's new:
- Set custom points for any specific structure type ex :

JSON:Copy to clipboard

"/Game/PrimalEarth/CoreBlueprints/Items/Structures/Metal/PrimalItemStructure_MetalGateframe.PrimalItemStructure_MetalGateframe = 25 pts")

• Works with easy-to-find Blueprint paths look here for them : https://ark.wiki.gg/wiki/Item_IDs
• Overrides always take priority over the default tiers, including setting a structure to 0 points if you want it excluded from scoring entirely

This gives admins much finer control over how raid points are awarded — reward the structures that matter most to your community!

Check config-commented.json for full setup instructions (see the CustomPoints section).

Now Support the new ASA API 2.02

Cousin_TribeLadder — PvE Support Added!

Cousin_TribeLadder now includes a complete PvE mode, enabled through the new General.PVEMode configuration option.

When PvE mode is active:

Wild dinosaur kills are tracked
Completed tames are recorded
All-cause player deaths remain tracked
/stats displays PvE-specific statistics
Discord leaderboards show Top Tamers, Top Wild Dino Hunters, and Top Deaths

Existing PvP functionality remains unchanged when PvE mode is disabled.

The database is automatically updated for existing installations, and all new features follow the plugin's existing crash-safety and asynchronous database conventions.

Now Support the new ASA API 2.1

- Discord periodic leaderboard No longer shows duplicate tribe entries. (Tribes need to have the same name accross all maps)

- New tribe_scores table Added to the database (auto-created on startup). This is the new canonical store for tribe rankings.


The new tribe_scores table starts empty on first launch. Previous scores from the old system are not automatically carried over. If you want to preserve existing scores, run this SQL once before restarting the plugin:

SQL:Copy to clipboard

INSERT INTO tribe_scores (tribe_name, tribe_score, last_updated)
SELECT tribe_name, MAX(tribe_score), UNIX_TIMESTAMP()
FROM players
WHERE tribe_name != '' AND tribe_name != 'NoTribe' AND tribe_id > 0
GROUP BY tribe_name
ON DUPLICATE KEY UPDATE
  tribe_score = VALUES(tribe_score),
  last_updated = VALUES(last_updated);

Latest Version 1.11 -> Small fix for error handling when the plugin's license verification system make HTTPS call to the API end point.

Was happenning if the network call fails (due to DNS issues, network timeout, SSL handshake error, or connectivity problems), the exception was not caught, causing the entire server to crash.

You can now add webhooks to get nice leaderboards and kill feeds in your discord !