Free Automatically clean Tribe buildings in inactive clans 1.21

{
"Enable": true, // Enable/Disable plugin functionality (true=enabled, false=disabled)
"InactivityMinutes": 1440, // Default inactivity cleanup time threshold in minutes (1440 minutes = 1 day)
// Note: If VIP cleanup is enabled, this value will be used as VIPGroups.Default cleanup time
"CheckIntervalSeconds": 120, // Time interval to check inactive tribes in seconds (recommended 300 seconds = 5 minutes, too low interval may cause server lag)
"UpdateIntervalSeconds": 1, // Time interval to update player database activity in seconds (recommended 1-5 seconds)
"Targets": { // Cleanup target configuration
"Dinos": true, // Whether to cleanup tamed dinos (true=cleanup, false=don't cleanup)
"Structures": true, // Whether to cleanup structures (true=cleanup, false=don't cleanup)
"Players": true // Whether to cleanup offline player characters (true=cleanup, false=don't cleanup, online players won't be deleted)
},
"Whitelist": { // Whitelist configuration
"TribeIDs": [1001,1002,1003] // Whitelist tribe ID array, these tribes will never be cleaned (example: [1001,1002,1003])
},
"UseVIPCleaning": true, // Enable VIP tiered cleanup feature (true=enabled, false=disabled)
// When enabled, tribes with different permission groups use different cleanup times
// Requires the Permissions plugin to work
"VIPGroups": { // VIP permission group cleanup time configuration (unit: minutes)
"Default": 1440, // Default players: 1440 minutes = 1 day
"VIP1": 2880, // VIP1 players: 2880 minutes = 2 days
"VIP2": 4320, // VIP2 players: 4320 minutes = 3 days
"VIP3": 7200, // VIP3 players: 7200 minutes = 5 days
"VIP4": 10080, // VIP4 players: 10080 minutes = 7 days
"VIP5": 20160 // VIP5 players: 20160 minutes = 14 days
// Notes:
// 1. Permission group names must exactly match the group names configured in the Permissions plugin
// 2. The "Default" group is required and used for players without any VIP permissions
// 3. Tribe cleanup time = highest VIP level player's cleanup time in the tribe
},
"AdminNoClean": { // Admin immunity configuration
"Enable": true // Enable admin immunity feature (true=enabled, false=disabled)
// When enabled, tribes with players in the "Admins" permission group will never be cleaned
// Priority: Admins > VIP > Default
}
}


// ==================== INFORMATION ====================
// Plugin Name: HB_RegularlyCleanTribes-ASA (Tribe Auto Cleanup Plugin)
// Author: HuBan (虎斑)
// Contact: [email protected]
// License Price: 30 USD/server
// ==================== =========== ====================


// ==================== FEATURES ====================

// 【1. VIP Tiered Cleanup】
// - Automatically identifies player permission groups (via Permissions plugin)
// - Applies different cleanup times based on permission groups
// - When a tribe has multiple members, uses the highest VIP level member's cleanup time
// - Example: Tribe has Default + VIP3 players → Uses VIP3 cleanup time (7200 minutes)

// 【2. Admin Immunity】
// - Tribes with players in the "Admins" permission group will never be cleaned
// - Even if cleanup time is exceeded, they won't be cleaned
// - Highest priority, overrides all VIP settings

// 【3. Solo Player Handling】
// - Solo players who haven't created a tribe automatically use their real permission group
// - Solo records (TribeID=PlayerID) are automatically deleted when the player creates a real tribe
// - No redundant solo records are retained

// 【4. Tribe Member Exit Handling】
// - Player leaves multi-member tribe: Delete the player's record, tribe remains (other members continue)
// - Player leaves solo tribe: Old tribe record updated to Default, cleaned after X minutes
// - Player joins new tribe: Automatically handles old tribe records, merges into new tribe

// 【5. Whitelist Feature】
// - Tribe IDs in the whitelist will never be cleaned
// - Higher priority than all cleanup rules

// ==================== RCON COMMANDS ====================

// Reload configuration:
// HB_RegularlyCleanTribes-ASA.Reload


// ==================== LOG FILES ====================

// Cleanup log path: HB_RegularlyCleanTribes-ASA/Cleanup.log

// Cleanup log format example:
// [2025-11-10 22:30:15] Player:HuBan | EOSID:00020393b7df490080eff94d9d7726f1 | CharacterID:991680278 | Tribe:HuBan's Tribe | TribeID:881245834 | Structures:15pcs | Dinos:8 | Characters:1pcs | PermissionGroup:Admins | CleanupRule:Admins(NeverClean) | Inactive:0minutes

{
"Enable": true,
"InactivityMinutes": 21600,
"CheckIntervalSeconds": 300,
"UpdateIntervalSeconds": 2,
"Targets": {
"Dinos": true,
"Structures": true,
"Players": true
},
"Whitelist": {
"TribeIDs": [1001,1002,1003]
},
"UseVIPCleaning": false,
"VIPGroups": {
"Default": 1440,
"VIP1": 2880,
"VIP2": 4320,
"VIP3": 7200,
"VIP4": 10080,
"VIP5": 20160
},
"AdminNoClean": {
"Enable": true
}
}