Paladin Tank Fight Class — wRobot Documentation

⚠️ WARNING: BETA VERSION This fight class is currently in beta. It may contain bugs, unfinished features, or unstable behavior. Use at your own risk. Feedback and bug reports are welcome.

Overview

Paladin Tank is an advanced wRobot fight class for Protection Paladin (WotLK / 3.3.5). It features a multi-threaded architecture with a lock-free AI movement system, intelligent blessing management, and smart combat positioning — all designed to maximize threat generation and party survival.

Features

⚡ Multi-Threaded Architecture

The fight class runs three independent background threads:

• Rotation Thread — handles spell casting and out-of-combat logic
• Movement AI Thread — manages smart positioning and gap closing
• Combat Rotation AI Thread — runs the priority-based DPS/threat rotation

All threads use a lock-free design with volatile reference swaps, meaning zero blocking and maximum responsiveness.

✈️ Pilot Override System

Manual player movement (W, A, S, D, Q, E) takes absolute priority over AI control:

• All AI movement stops immediately when you press movement keys
• Pathfinding is halted
• After releasing keys, AI waits ~1 second before resuming
• Smooth, conflict-free transition — the player always wins

🤺 Combat Rotation

The rotation follows a priority-based system optimized for Threat Per Second (TPS):

🤝 Blessing System

The class features a fully automated intelligent blessing manager:

• Applies and refreshes Blessing of Kings, Sanctuary, Wisdom, or Might based on party member class and role
• Supports Greater Blessings for large groups
• Uses a buff cache (5-second TTL) to avoid spamming Lua calls
• Cooldown tracking prevents double-blessing
• Handles edge cases like timezone-related timer bugs

🛡️ Aura Management

Automatically maintains the appropriate aura:

• Devotion Aura (default tank aura)
• Retribution, Concentration, Crusader, and Resistance Auras based on context
• Righteous Fury always kept active

🔒 Seal Management

Dynamically selects and maintains the best Seal:

• Seal of Vengeance / Corruption for sustained threat
• Seal of Wisdom / Light for mana recovery when needed

💊 Defensive Cooldowns

Automated usage of defensive abilities:

• Ardent Defender — at low HP
• Divine Protection — emergency
• Lay on Hands — critical HP threshold
• Sacred Shield — maintained on self
• Divine Plea — used when mana is low (configurable threshold)

🙏 Party Support

The class actively monitors and supports party members:

• Righteous Defense — taunts enemies off party members
• Hand of Reckoning — single-target taunt
• Hand of Freedom — removes movement-impairing debuffs
• Hand of Protection / Sacrifice / Salvation — situational party cooldowns
• Cleanse — removes harmful debuffs
• Divine Intervention / Divine Sacrifice — emergency party saves

📍 Smart Positioning AI

• 5–30 yards: Uses pathfinding (MovementManager.MoveTo) for gap closing
• 0–5 yards: Uses direct movement (forward/turn/backward) for fine positioning
• Anti-oscillation system prevents jerky back-and-forth movement
• Configurable turn threshold, hysteresis, and stabilization delay

Configuration

Key settings can be adjusted in the PaladinTankConfig class at the top of the file:

Logging verbosity can also be toggled individually (EnableAIDebugLogs, EnableApproachLogs, EnableBlessingDebugLogs).

Requirements

• wRobot with custom fight class support
• Protection Paladin (WotLK 3.3.5)
• Recommended talent build: standard 53/5/13 or similar Prot spec
• Holy Shield, Consecration, Avenger's Shield, and Hammer of the Righteous must be trained

Known Limitations (Beta)

• Some buff timer detection may be unreliable in certain server configurations (timezone issue workaround is included)
• Party role detection (Tank/Healer/DPS) is heuristic-based and may not always be accurate
• Death Grip reference exists in the code but belongs to Death Knight — this may be a leftover from testing
• Divine Shield is defined but emergency auto-use conditions may need tuning per use case

Fight class version: v374 (internal AI version: v212 lock-free)