TazzTribescore Plugin Description
Features
TazzTribescore is a tribe scoring and leaderboard plugin for ARK servers. It tracks tribe performance across combat events and structure destruction, updates tribe scores automatically, and provides both in-game and Discord-based leaderboard output.
What It Does
TazzTribescore evaluates supported raid/combat events and applies score changes to the tribes involved.
When an event counts:
The plugin can score:
It also keeps separate subtotals for:
This makes it useful for ranking tribes by actual PvP / raid performance instead of only tribe size or playtime.
Online Validation / Raid Logic
TazzTribescore can require tribes to be considered "online-valid" before score counts.
It supports rules such as:
It also includes a raid grace system:
Score Rules / Restrictions
The plugin includes configurable validation so events can be ignored when needed.
It can ignore or restrict:
It can also:
Leaderboard / Output
TazzTribescore can output:
The leaderboard is based on tribe damage score and can be configured for cluster-wide display.
Data / Persistence
The plugin keeps persistent records for:
It also supports MySQL-backed storage for shared or long-term tracking.
Config
Requirements
JOIN DISCORD
Features
TazzTribescore is a tribe scoring and leaderboard plugin for ARK servers. It tracks tribe performance across combat events and structure destruction, updates tribe scores automatically, and provides both in-game and Discord-based leaderboard output.
- Tribe score tracking – keeps a running score for each tribe
- Category-based scoring – tracks overall score plus separate player, dino, and structure score values
- Player kill scoring – awards the attacking tribe and removes score from the victim tribe for player kills
- Dino kill scoring – supports score gain/loss for dino kills with configurable handling for wild, tamed, baby, and specific dino types
- Structure kill scoring – supports score gain/loss for destroyed structures with tier-based values for thatch, wood, adobe, stone, metal, and tek
- Per-dino and per-structure overrides – specific dinos or structures can have custom score values
- Leaderboard system – builds a ranked tribe leaderboard based on score
- Tribe rank command – lets players check their tribe's current rank
- Top tribes command – lets players view the current leaderboard in chat
- Discord leaderboard posting – can post formatted leaderboard embeds to Discord
- Interval leaderboard posting – supports automatic Discord posting on a timer
- New #1 tribe support – includes logic for leaderboard updates tied to top-rank changes
- Event logging – stores whether events counted, what scores were applied, and why events were skipped
- Tribe name upkeep – updates tribe names over time when valid new names are seen
- Reload support – plugin config can be reloaded without restarting
What It Does
TazzTribescore evaluates supported raid/combat events and applies score changes to the tribes involved.
When an event counts:
- the attacker tribe gains score
- the victim tribe loses score
- the event is logged
- the leaderboard is refreshed
The plugin can score:
- player kills
- dino kills
- structure kills
It also keeps separate subtotals for:
- player score
- dino score
- structure score
This makes it useful for ranking tribes by actual PvP / raid performance instead of only tribe size or playtime.
Online Validation / Raid Logic
TazzTribescore can require tribes to be considered "online-valid" before score counts.
It supports rules such as:
- requiring both tribes online
- requiring only attacker online
- requiring only victim online
- using any tribe member online vs minimum online member counts
- cluster-aware presence checks
- local fallback behavior if shared presence data fails
It also includes a raid grace system:
- raid activity can refresh a tribe's active raid window
- logging out unsafely can lead into raid grace timing
- tribes can check whether they are safe to log out
- tribes can check whether raid grace is currently active
Score Rules / Restrictions
The plugin includes configurable validation so events can be ignored when needed.
It can ignore or restrict:
- untribed events
- same-tribe events
- same-alliance events
- solo tribes
- tribes below a minimum size
- suicides
- environmental deaths
- wild dinos
- baby dinos
- decay / autodecay events
- non-counted structure or dino categories
It can also:
- clamp scores to zero
- disallow negative score totals
Leaderboard / Output
TazzTribescore can output:
- in-game chat leaderboard text
- per-tribe rank responses
- Discord embed leaderboard posts with ranked tribe scores
The leaderboard is based on tribe damage score and can be configured for cluster-wide display.
Data / Persistence
The plugin keeps persistent records for:
- tribe score totals
- tribe category subtotals
- event logs
- tribe names
- online tribe/player presence state
- raid grace / raid window state
It also supports MySQL-backed storage for shared or long-term tracking.
Config
JSON:
{
"LicenseKey": "PUT-YOUR-LICENSE-KEY-HERE",
"General": {
"Enabled": true, //Master toggle. false = plugin completely disabled
"Override_Server_Name": "", //Optional override. Leave empty to auto-detect server/map name
"Cluster_Name": "", //Optional cluster label used for database + Discord (ex: "MainCluster")
"Debug": false, //Extra debug logging. Only enable when troubleshooting
"Auto_Create_Database_Tables": true //Automatically creates required MySQL tables on startup
},
"Database": {
"Use_Mysql": true, //Must be true for cluster-wide tracking + leaderboard
"Host": "127.0.0.1", //MySQL host
"Port": 3306, //MySQL port
"Database_Name": "arkcluster", //Database name
"Username": "root", //MySQL username
"Password": "", //MySQL password
"Use_SSL": false, //Enable if your MySQL requires SSL
"Table_Prefix": "tribescore_" //All tables will use this prefix
},
"TribeStats": {
"Enabled": true, //Enable scoring system
"Clamp_Score_To_Zero": true, //Prevents score from going below 0
"Allow_Negative_Score": false, //Allow negative scores (ignored if clamp is true)
"Ignore_Untribed": true, //Ignore players/dinos with no tribe
"Ignore_Solo_Tribes": false, //Ignore tribes with only 1 member
"Minimum_Tribe_Size": 1, //Minimum total tribe members required
"Check_Total_Tribe_Size": true, //Use database to check tribe size
"Count_Same_Tribe_Events": false, //If false, friendly fire does NOT count
"Count_Same_Alliance_Events": false, //Reserved for alliance logic (future)
"Update_Tribe_Name_On_Event": true, //Updates tribe name in DB when events occur
"Player": {
"Enabled": true, //Enable player kill scoring
"Kill_Gain": 5, //Points attacker gains
"Kill_Loss": 4, //Points victim loses
"Ignore_Suicides": true, //Ignore player suicides
"Ignore_Environmental_Deaths": true //Ignore deaths from fall/lava/etc
},
"Dino": {
"Enabled": true, //Enable dino kill scoring
"Count_Tamed_Dinos": true, //Only count tamed dinos
"Count_Wild_Dinos": false, //Count wild dino kills
"Count_Babies": false, //Include baby dinos
"Default_Gain": 2, //Default gain if no override
"Default_Loss": 1, //Default loss if no override
"Specified_Dinos": [
{
"Dino_Blueprint_Path": "", //Full blueprint path for override
"Gain": 10, //Custom gain value
"Loss": 6, //Custom loss value
"Count_Baby": false //Override baby handling for this dino
}
]
},
"Structures": {
"Enabled": true, //Enable structure destruction scoring
"Count_Structure_Kills": true, //Count destroyed structures
"Count_Decay": false, //Count decay destruction
"Count_AutoDecay": false, //Count auto-decay
"Thatch": {
"Gain": 1, //Points gained destroying thatch
"Loss": 0 //Points lost when your thatch is destroyed
},
"Wood": {
"Gain": 2,
"Loss": 1
},
"Adobe": {
"Gain": 4,
"Loss": 3
},
"Stone": {
"Gain": 4,
"Loss": 3
},
"Metal": {
"Gain": 8,
"Loss": 7
},
"Tek": {
"Gain": 15,
"Loss": 12
},
"Specified_Structures": [
{
"Structure_Blueprint_Path": "", //Specific structure override
"Gain": 10,
"Loss": 10
}
]
}
},
"Online_Mode": {
// Enables the online/raid validation system
// If false, tribe score ignores online status completely
"Enabled": true,
// Require attacker tribe to be online (or have active raid grace)
"Require_Attacker_Online": false,
// Require victim tribe to be online (or have active raid grace)
"Require_Victim_Online": false,
// Require BOTH tribes to be online (or have active raid grace)
// This is the recommended PvP setting
"Require_Both_Tribes_Online": true,
// If true, only ONE member needs to be online for the tribe to count
// If false, Minimum_Online_Members is used instead
"Count_Any_Member_Online": true,
// Minimum players required online if Count_Any_Member_Online = false
"Minimum_Online_Members": 1,
// Use database to track players across maps (recommended)
"Use_Cluster_Presence": true,
// If database fails, fallback to local server detection
"Use_Local_Fallback_If_Database_Fails": true,
// How often player presence updates (seconds)
"Heartbeat_Interval_Seconds": 15,
// How often cached presence is refreshed (seconds)
"Refresh_Presence_Cache_Seconds": 5,
// Enables raid-based logout grace system
"Raid_Grace_Enabled": true,
// RAID WINDOW (minutes)
// If a player logs out within this time after last raid event,
// grace WILL trigger
"Raid_Grace_Minutes": 30,
// GRACE DURATION (minutes)
// How long tribe remains "valid" after logging out during a raid
"Grace_Duration_Minutes": 60,
"Raid_Grace_Triggers": {
// Player kills refresh the raid window
"Player_Kills": true,
// Tamed dino kills refresh the raid window
"Dino_Kills": true,
// Structure destruction refreshes the raid window
"Structure_Kills": true
},
// Tracks players transferring between maps (cluster support)
"Track_Player_Transfers": true,
// Cleans up stale players on server start
"Remove_Stale_Presence_On_Load": true,
// Debug logging for why events are counted or skipped
"Debug_Online_Decisions": false
},
"Leaderboard": {
"Enabled": true, //Enable leaderboard system
"Cluster_Wide": true, //Use all maps instead of per-map
"Max_Entries_To_Display": 10, //Top X tribes shown
"Refresh_Cache_Seconds": 10, //Leaderboard cache refresh
"Chat_Command": "/tribetop", //Command to show leaderboard
"Player_Rank_Command": "/triberank" //Command to show your tribe rank
},
"Discord": {
"Enabled": false,
"Webhook_URL": "",
"Use_Embeds": true,
"Season": "Season 5", //Only text under title
"Max_Entries": 15, //How many tribes to show
"Post_On_Interval": true,
"Interval_Minutes": 60,
"Post_On_New_Number_One": true
},
"Logging": {
"Enabled": true, //Enable logging
"Log_Event_Details": true, //Log scoring events
"Log_Online_Decisions": true, //Log why events were skipped
"Log_Discord": true, //Log Discord webhook events
"Log_Database": false //Log SQL queries (spammy)
}
}Requirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
JOIN DISCORD
