Ue Gameplay Tag Manager

2. Rename Tags

Safe Rename Process:

## Tag Rename: {OldTag} → {NewTag}

### Step 1: Find All References
Search patterns:
- C++: `FGameplayTag::RequestGameplayTag(FName("{OldTag}")`
- C++: `FName("{OldTag}")`
- Blueprints: Tag property values
- DataTables: Tag columns
- Config: .ini files

### Step 2: Create Redirect
Add to DefaultGameplayTags.ini:
```ini
+GameplayTagRedirects=(OldTagName="{OldTag}",NewTagName="{NewTag}")

Step 3: Update References

{List of files to update}

Step 4: Verify

• Compile C++
• Load all BPs with tag references
• Test tag queries

**Search Commands:**
```bash
# Find C++ references
grep -r "OldTagName" --include="*.cpp" --include="*.h"

# Find config references
grep -r "OldTagName" --include="*.ini"

3. Deprecate Tags

Deprecation Process:

## Deprecate Tag: {TagName}

### Step 1: Add Redirect to Replacement
```ini
+GameplayTagRedirects=(OldTagName="{TagName}",NewTagName="{ReplacementTag}")

Step 2: Mark as Deprecated (Optional)

; DEPRECATED - Use {ReplacementTag} instead
+GameplayTagList=(Tag="{TagName}",DevComment="DEPRECATED: Use {ReplacementTag}")

Step 3: Update Code References

{Files requiring update}

Step 4: Schedule Removal

• Add TODO with removal date
• Track in tech debt

### 4. Audit Tag Usage

**Audit Report:**

```markdown
## Gameplay Tag Audit Report

### Tag Hierarchy Summary
| Root | Children | Depth | Usage Count |
|------|----------|-------|-------------|
| Ability | {N} | {N} | {N} |
| State | {N} | {N} | {N} |
| Effect | {N} | {N} | {N} |

### Unused Tags
Tags defined but never referenced:
| Tag | Defined In | Last Modified |
|-----|------------|---------------|
| {Tag} | {File} | {Date} |

### Orphan References
Tags referenced but not defined:
| Tag | Referenced In | Line |
|-----|---------------|------|
| {Tag} | {File} | {N} |

### Duplicate Definitions
Tags defined in multiple files:
| Tag | Files |
|-----|-------|
| {Tag} | {Files} |

### Naming Convention Violations
| Tag | Issue | Suggested |
|-----|-------|-----------|
| {Tag} | {Issue} | {Fix} |

Tag Hierarchy Guidelines

Sipher Tag Structure

Ability.
├── Combat.
│   ├── Light.{AbilityName}
│   ├── Heavy.{AbilityName}
│   └── Special.{AbilityName}
├── Movement.
│   ├── Dash
│   ├── Jump
│   └── Dodge
├── Cooldown.{AbilityName}
└── Blocked.By.{Reason}

State.
├── Character.
│   ├── Alive
│   ├── Dead
│   └── Stunned
├── Combat.
│   ├── Attacking
│   ├── Blocking
│   └── Parrying
├── Ability.{AbilityName}.Active
└── Effect.{EffectName}

Effect.
├── Damage.
│   ├── Physical
│   └── Elemental.{Type}
├── Buff.{BuffName}
├── Debuff.{DebuffName}
└── Status.{StatusName}

GameplayCue.
├── Character.
│   ├── Hit.{Type}
│   └── Death
├── Ability.{AbilityName}
└── Effect.{EffectName}

Batch Operations

Batch Add

// Script to add multiple tags
TArray<FString> NewTags = {
    "Ability.Combat.NewAttack1",
    "Ability.Combat.NewAttack2",
    "State.Effect.NewStatus"
};

for (const FString& Tag : NewTags)
{
    // Add to appropriate ini file
    AddTagToConfig(Tag, GetTagCategory(Tag));
}

Batch Rename

## Batch Rename Operation

| Old Tag | New Tag | References |
|---------|---------|------------|
| {Old1} | {New1} | {N} files |
| {Old2} | {New2} | {N} files |

### Generated Redirects
```ini
+GameplayTagRedirects=(OldTagName="{Old1}",NewTagName="{New1}")
+GameplayTagRedirects=(OldTagName="{Old2}",NewTagName="{New2}")

Files to Update

{Consolidated file list}

### Find References

```markdown
## Tag Reference Report: {TagName}

### C++ References
| File | Line | Context |
|------|------|---------|
| {File} | {N} | {Code snippet} |

### Blueprint References
| Asset | Property |
|-------|----------|
| {Asset} | {Property path} |

### Config References
| File | Line |
|------|------|
| {File} | {N} |

### DataTable References
| Table | Row | Column |
|-------|-----|--------|
| {Table} | {Row} | {Column} |

### Total: {N} references in {N} files

Validation Rules

Output

Tag Addition

• Updated .ini file with new tag
• DevComment for documentation

Tag Rename

• Redirect entry in config
• List of files requiring update
• Validation of all references updated

Tag Audit

• Full usage report
• Cleanup recommendations
• Health score