{
  // ============================================================================
  // KDV_DamageNumbers
  // ============================================================================
  // This plugin uses a TWO-PHASE visibility system:
  // 1. BASELINE RULES: Admin-set minimum visibility (cannot be narrowed).
  // 2. WIDENING RULES: Optional tribe sharing that can only ADD more viewers.
  // ============================================================================
  "Authentication": {
    "License": "",
    "InstanceID": "" // (required for HOST mode licenses only).
  },
  // Database is optional, but recommended for persistence across servers and restarts.
  // If you do not want to use a database, remove the entire "Database" section.
  "Database": {
    "DatabaseHost": "",
    "DatabasePort": 3306,
    "DatabaseUser": "",
    "DatabasePass": "",
    "DatabaseName": ""
  },
  "PluginSettings": {
    "ServerName": "SERVER", // Optional. Used only for some log and chat messages.
    "ServerGroup": "DEFAULT", // Group identifier for multi-server persistence (e.g., "PVP_Cluster", "PvE_Cluster").
    "DamageNumbersToggleCommand": "/dmg.toggle" // Chat command to toggle damage numbers on/off for players.
    // NOTE: Must start with a '/'. No spaces allowed.
    // Example: "/dmg.toggle", "/dmg", "/dmgnumbers"
  },
  "DamageNumberSettings": {
    "General": {
      "EnableVanillaDamageNumbers": false, // TRUE = Replicate vanilla ARK damage numbers (disables all plugin features). FALSE = Use KDV_DamageNumbers system.
      "EnablePlayerStateByDefault": false, // TRUE = Players have damage numbers enabled by default when first joining the server/cluster. FALSE = Players have damage numbers disabled by default.
      "MaxViewDistance": 25.0, // Maximum viewing distance in foundations (1 foundation = ~300 game units). Players beyond this distance won't see damage numbers.
      "DisplayDuration": 1.0, // How long damage numbers remain visible on screen (seconds, range: 0.1 - 25.0).
      "TextSize": 1.0 // Damage number text size multiplier (range: 0.1 - 5.0 with 1.0 as default).
    },
    // ========================================================================
    // MASTER SWITCHES - These completely disable damage sources (highest priority).
    // If disabled here, NO damage numbers will show from these sources regardless of other settings.
    // Ask yourself: "Should ____ ever be seen?".
    // ========================================================================
    "DamageSourceControl": {
      "EnableStructureDamageNumbers": true, // TRUE = Show damage from turrets, spike walls, plant x, etc. FALSE = Never show structure damage.
      "EnableWildDamageNumbers": true // TRUE = Show damage from wild creatures. FALSE = Never show wild damage.
    },
    // ========================================================================
    // BASELINE VISIBILITY RULES.
    // These are MINIMUM visibility levels that cannot be restricted by other settings.
    // Ask yourself: "Who will see the damage numbers on _____?".
    // ========================================================================
    "BaseVisibilityRules": {
      // OPTIONS:
      // "NONE" = Nobody sees the damage.
      // "ATTACKER_ONLY" = Only the person/entity doing the damage sees it.
      // "DEFENDER_ONLY" = Only the person/entity being damaged sees it.
      // "ATTACKER_AND_DEFENDER_ONLY" = Only the two individuals involved see it (no teammates).
      // "ATTACKER_TEAM_ONLY" = Only the attacking team/tribe sees it.
      // "DEFENDER_TEAM_ONLY" = Only the defending team/tribe sees it.
      // "ATTACKER_AND_DEFENDER_TEAM_ONLY" = Both entire tribes see it.
      // "EVERYONE" = All players on the server see it (within distance, if they've toggled damage numbers).
      "WildCreatures": "ATTACKER_ONLY",
      "TribePlayers": "ATTACKER_AND_DEFENDER_ONLY",
      "TribeStructures": "ATTACKER_AND_DEFENDER_ONLY",
      "TribeCreatures": "ATTACKER_AND_DEFENDER_ONLY",
      "EnemyPlayers": "ATTACKER_AND_DEFENDER_ONLY",
      "EnemyCreatures": "ATTACKER_AND_DEFENDER_ONLY",
      "EnemyStructures": "ATTACKER_AND_DEFENDER_ONLY"
    },
    // ========================================================================
    // VISIBILITY WIDENING - Optional tribe sharing that expands the baseline.
    // **These settings can ONLY ADD more viewers, never remove them.**
    // If baseline already includes your tribe, these settings have no effect.
    // ========================================================================
    "VisibilityWidening": {
      // IMPORTANT: These only work when the baseline rule is restrictive enough to benefit from widening.
      // Example: With baseline "ATTACKER_ONLY" and ShowPlayerAttacks = true, the attacker still sees their own numbers; add ShowTribeMemberAttacks to include the tribe.
      // Example: If baseline is already "ATTACKER_AND_DEFENDER_TEAM_ONLY", these settings won't change anything because the whole tribe is already included.
      "WhenWeAttack": {
        // These govern extra visibility when YOUR tribe is on offense.
        // Player/ridden toggles grant you visibility, and ShowTribeMemberAttacks can widen them to the rest of the tribe.
        "ShowPlayerAttacks": true, // When YOU (player) attack -> always show the damage to you; combine with ShowTribeMemberAttacks to include your tribe.
        "ShowTribeMemberAttacks": true, // Let tribe members see other members' player or ridden dino attacks.
        "ShowRiddenDinoAttacks": true, // When YOU ride a dino -> always show the damage to you (the rider); combine with ShowTribeMemberAttacks to include your tribe.
        "ShowUnriddenDinoAttacks": true, // When YOUR unridden dino attacks -> should your tribe see the damage?
        "ShowStructureAttacks": true, // When YOUR structures attack -> should your tribe see the damage? (turrets, etc.).
        "ShowDirectPlayerCombat": false // Special PvP rule: In direct player-vs-player combat -> BOTH the attacker's tribe and the defender's tribe will see their combat damage.
        // Example: Bob Sr. (Tribe A) fights Bob Jr. (Tribe B). TRUE = all of Tribe A and Tribe B members see the numbers. FALSE = only Bob Sr. and Bob Jr. see them (baseline still applies).
      },
      "WhenWeDefend": {
        // These control whether your TRIBE sees damage when YOUR assets are being attacked.
        // Only works if the baseline includes the defender side and your tribe isn't already included.
        "ShareStructureDamageWithTribe": true, // When YOUR structures take damage → Should your tribe see it?
        "ShareCreatureDamageWithTribe": true // When YOUR creatures take damage → Should your tribe see it?
      }
    },
    // ========================================================================
    // VISUAL SETTINGS - Colors and appearance (no impact on WHO sees damage, only what COLOR they see)
    // ========================================================================
    "Visual": {
      "Colors": {
        // SUPPORTED FORMATS: Named colors ("Red", "Green", "Blue"), RGB values ("255,0,0"), or hex codes ("#FF0000")
        // NOTE: Color names are case-insensitive but must be spelled correctly.
        //
        // COLOR PRIORITY SYSTEM (highest to lowest priority):
        // 1. FriendlyFire (always wins)
        // 2. WildAttacker
        // 3. PerspectiveBased (depends on viewer's relationship to combat)
        // 4. DefaultFallback (last resort)
        "FriendlyFire": "Green", // HIGHEST PRIORITY: When you hit your own tribe members.
        "WildAttacker": "Yellow", // HIGH PRIORITY: When wild creatures/structures deal damage.
        "DefaultFallback": "Yellow", // LOWEST PRIORITY: Fallback color when no other rules apply.
        "PerspectiveBased": {
          // MEDIUM PRIORITY: Colors change based on the VIEWER's relationship to the combat.
          // The same damage event can appear as different colors to different players watching it.
          // Ask yourself: "What will the _____ see when attacked by a _____?".
          "AttackerPerspective": {
            // This is the perspective of the ATTACKER (the one dealing damage).
            "Player": "Green",
            "Tribe": "Green", // SPECIAL: Player watching their tribe mate get hit (player or ridden dino).
            "DinoRidden": "Green",
            "DinoUnridden": "Green",
            "Structure": "Green"
          },
          "DefenderPerspective": {
            // This is the perspective of the DEFENDER (the one receiving damage).
            "Player": "Red",
            "Tribe": "Red", // SPECIAL: Player watching their tribe mate get hit (player or ridden dino).
            "DinoRidden": "Red",
            "DinoUnridden": "Red",
            "Structure": "Red"
          },
          "NeutralPerspective": {
            // Colors shown to neutral spectators (not on either team).
            // Only applies when base visibility setting is "EVERYONE".
            "Player": "Yellow",
            "DinoRidden": "Yellow",
            "DinoUnridden": "Yellow",
            "Structure": "Yellow"
          }
        }
      }
    }
  }
}