Transform your War Thunder experience into a full-body immersion system!
Tailgunner is a revolutionary haptic feedback application that bridges War Thunder's telemetry API with advanced haptic devices, translating every game event into physical sensations. Feel every hit, every G-force, every critical moment through adaptive sensory feedback.
- ✅ 100% EAC-Safe - Reads data only from
127.0.0.1:8111(official API) - ✅ Real-time telemetry - 10 updates per second
- ✅ HUD Events - Kill feed, damage events, aircraft crashes
- Track your kills and deaths in real-time
- Filter by player names and clan tags
- Trigger haptic feedback on specific player events
- Enemy tracking and targeted feedback
- ✅ 50+ Game Parameters including:
- Flight: IAS, TAS, Altitude, Mach, AoA, G-Load
- Controls: Aileron, Elevator, Rudder, Flaps, Gear, Airbrake
- Engine: RPM, Temperature, Oil Temp, Manifold Pressure, Throttle
- Weapons: Ammo count, Cannon ready status
- Resources: Fuel (kg & %), Low fuel warnings
- Tank-specific: Stabilizer, Gear ratio, Cruise control, Driving direction
- Crew: Total/alive crew, Gunner/Driver state
- Advanced: Blisters, Gear lamps, Speed warnings
Node-based editor (similar to Blender/Unreal) for creating complex haptic patterns:
- 📊 Sensor Input - 50+ game parameters grouped by category
- ⚡ Event Trigger - Game events (Hit, Overspeed, LowFuel, etc.)
- 🔍 Condition - Single comparisons (>, <, =, ≥, ≤, ≠, between, outside)
- 🎯 Multi-Condition - Complex conditions with AND/OR logic
- ⚙️ Logic Gates - AND, OR, NOT, XOR operations
- 💥 Vibration - Classic vibration patterns with ADSR curves
- 📏 Linear Motion - For strokers/thrusters (position control)
- 🔄 Rotation - For rotary devices (speed & direction)
- 📡 Output - Send to devices
Automatic profile switching based on vehicle type:
- 🛡️ Tank RB - Immersive realism with engine rumble, hit feedback
✈️ Aircraft - G-force simulation, overspeed warnings, stall alerts- 🎮 Light Background - Subtle feedback for all vehicle types
Advanced Trigger System:
- Custom Curve Editor - Draw your own vibration intensity curves
- Per-Trigger Settings - Adjust cooldown, duration, and intensity individually
- Built-in Triggers - Pre-configured for fuel warnings, engine damage, ammo alerts
- Profile Filtering - Only shows events with active triggers for clarity
- Continuous Vibration Mode - Sustained feedback while condition is active
- Vehicle-Specific Limits - Auto-generated triggers based on actual aircraft data
- G-load warnings (80% of max positive/negative G)
- Flutter speed alerts (before wing rip)
- Critical overspeed warnings (95% of Vne)
Player Identity System:
- Track Specific Players - Set your nickname to filter kill events
- Clan Tag Support - Monitor clan member activities
- Enemy Lists - Create targeted feedback for specific opponents
- Smart Kill Filtering - "I killed someone" vs "Enemy damaged me"
- Buttplug.io Integration - Universal device support via Intiface Central
- Multiple Device Types:
- Vibration (classic haptics)
- Linear actuators (strokers, thrusters)
- Rotary devices (rotating toys)
- Smart QoS - Rate limiting (5-8 cmd/s) to prevent device overload
- Fail-Safe - Smooth fade-out on crash/disconnect
- 🇬🇧 English (primary)
- 🇷🇺 Russian
- Easy to add more languages
- Interactive Curve Editor - Draw custom vibration patterns with mouse
- Add/remove points with double-click
- Drag points to adjust intensity over time
- Real-time visual feedback
- Canvas-based rendering for smooth curves
- Smart Number Inputs - Keyboard-friendly value editing
- Type values directly instead of only using arrows
- Backspace/Delete support
- Enter to confirm, Escape to cancel
- Auto-formatting with units (seconds, etc.)
- Filtered Views - Cleaner interface
- Only shows triggers with configured events
- Hides empty profiles for clarity
- Debug Console - Real-time event monitoring
- Live trigger activation logs
- Game state telemetry display
- HUD event debugging
- Error tracking and diagnostics
- War Thunder with localhost API enabled
- Intiface Central (Download)
- Compatible haptic devices
# Clone repository
git clone https://github.com/yourusername/tailgunner.git
cd tailgunner
# Install dependencies
npm install
# Run in development mode
npm run tauri dev
# Build production version
npm run tauri build- Launch Intiface Central
- Start server (default:
ws://localhost:12345) - Connect your haptic devices
- Launch Tailgunner
- Click "Initialize Devices"
- Enable localhost API in game settings
- Launch any battle (tank, aircraft, ship)
- Tailgunner will auto-detect vehicle type
- Open Pattern Manager
- Click "Create Pattern"
- Build your haptic flow:
[Speed Sensor] → [Condition: > 800] → [Vibration Pattern] → [Output] - Save and enable pattern
- Go to Game Events tab
- All Triggers - View and configure all available triggers
- Enable/disable individual triggers
- Adjust cooldown (seconds between activations)
- Customize vibration duration
- Draw custom intensity curves with the interactive editor
- Active Profiles - Configure profile-specific event mappings
- Only shows events with configured triggers
- Per-profile customization for different vehicle types
- Real-time preview of trigger settings
- Frontend: React + TypeScript + Vite
- Backend: Rust + Tauri 2.0
- UI: React Flow (node editor)
- Haptics: Buttplug.io via WebSocket
- I18n: react-i18next
The engine that powers Tailgunner:
- Telemetry Reader - Polls WT API at 100ms intervals
/indicatorsendpoint - Real-time telemetry (50+ parameters)/hudmsgendpoint - Kill feed and damage events- Smart HUD initialization (processes recent 15s of events)
- Duplicate message prevention with time-based caching
- Event Engine - Detects game events (hits, damage, state changes)
- Trigger Manager - Evaluates custom conditions with persistent settings
- Custom curve point storage and serialization
- Per-trigger cooldown and pattern management
- Real-time condition evaluation with state history
- Continuous trigger support (sustained vibration)
- Event-based vs state-based trigger separation
- Profile Manager - Switches haptic profiles based on vehicle
- Pattern Engine - Converts curves to ADSR envelopes
- Custom curve-to-pattern conversion
- ADSR (Attack, Decay, Sustain, Release) generation
- Burst mode support (repeat patterns)
- Vehicle Limits Manager - Datamine integration
- Parses War Thunder game files (VROMFS unpacking)
- Extracts aircraft performance limits (G-load, Vne, flutter)
- Auto-generates vehicle-specific triggers
- EAC-safe (unpacks to TEMP, doesn't modify game)
- Player Identity DB - SQLite-based identity tracking
- Persistent storage of player names, clan tags, enemy lists
- Kill event filtering based on player identity
- Rate Limiter - QoS to prevent device spam
- Device Manager - Communicates with Buttplug.io
Visual node-based patterns are converted to Rust EventTrigger structures:
- Condition evaluation - Real-time checks against game state
- Pattern execution - ADSR envelopes, curves, continuous modes
- Multi-device support - Different patterns for different device types
[IAS Sensor] → [Condition: > 800 km/h] → [Vibration: Pulsing] → [Output]
Triggers when airspeed exceeds 800 km/h
[G-Load Sensor] → [Multi-Condition: > 8G OR < -3G] → [Vibration: Sharp] → [Output]
Triggers on extreme G-forces
[Fuel % Sensor] → [Condition: < 20%] ─┐
[Hit Event] ─────────────────────────┼→ [Logic: AND] → [Vibration: Critical] → [Output]
Intense feedback when hit while low on fuel
[RPM Sensor] → [Condition: > 2000] → [Rotate: Continuous] → [Output]
Rotary device spins proportionally to engine RPM
Trigger: Low Fuel (<10%)
Cooldown: 30.0s
Duration: 2.5s
Curve: Custom drawn curve (gentle ramp up → sustained pulse → fade out)
Creates a unique sensation using the interactive curve editor
- IAS, TAS, Altitude, Mach, AoA, G-Load (Ny)
- Aileron, Elevator, Rudder, Flaps, Gear, Airbrake
- Stick/Pedal raw inputs
- RPM (multi-engine support)
- Engine, Oil, Water temps
- Manifold pressure, Throttle position
- Stabilizer state, Gear ratio
- Cruise control, Driving direction
- Speed warning indicators
- Ammo count, Cannon ready status
- Fuel (kg & percentage)
- Low fuel/ammo warnings
- Total/Current crew count
- Crew distance, Gunner/Driver state
- Blisters (1-4), Gear lamps (up/down/off)
- Roll indicators available
Tailgunner ONLY reads from War Thunder's official localhost API (127.0.0.1:8111). It does not:
- ❌ Inject code into game memory
- ❌ Modify game files
- ❌ Hook into DirectX/OpenGL
- ❌ Use any anti-cheat bypass techniques
- Rate Limiting: Max 8 commands/second to prevent overheating, XD
- Fail-Safe Mode: Devices stop smoothly if game crashes
- Manual Override: Emergency stop button in UI
We welcome contributions! Areas of interest:
- New node types (e.g., Constrict, Inflate)
- Additional game parameters
- Community pattern library
- Translations (add your language!)
- Device profiles (optimize for specific hardware)
- Fork repository
- Create feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Open Pull Request
GNU General Public License v3.0 or later (GPL-3.0-or-later)
This project is free and open source software licensed under the GPL-3.0.
✅ You CAN:
- Use the software for any purpose (personal, commercial, educational)
- Study and modify the source code
- Share and distribute the software
- Distribute your modifications
- Use in commercial products
- Keep the same GPL-3.0 license for derivative works
- Provide source code when distributing
- State changes made to the original code
- Include copyright and license notices
See LICENSE for full details.
This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions.
Tailgunner is powered by:
- Tauri - Cross-platform framework
- Buttplug.io - Haptic device control
- React Flow - Node editor
- War Thunder API - Telemetry documentation (Temp)
- Reddit:(coming soon)
- Pattern Library: Share your patterns (coming soon)
- ✅ 50+ game parameters
- ✅ Multi-condition nodes
- ✅ Linear & Rotate devices
- ✅ Full localization (EN/RU)
- ✅ Interactive vibration curve editor
- ✅ Per-trigger cooldown/duration/intensity settings
- ✅ Persistent trigger configuration
- ✅ Profile filtering (shows only events with triggers)
- ✅ Editable number inputs with keyboard support
- ✅ HUD Events System - Kill feed, damage tracking
- ✅ Player Identity - Track specific players/clans/enemies
- ✅ Vehicle Datamine Integration - Auto-generated limits from game files
- ✅ Continuous Vibration Mode - Sustained feedback for conditions
- ✅ Debug Console - Real-time event monitoring
- ✅ Smart Kill Filtering - Context-aware event descriptions
- ✅ Vehicle-Specific Triggers - G-load, flutter, overspeed warnings
- ✅ HUD Initialization - Processes recent 15s of events on startup
- 🔄 Enhanced datamine features
- Tank performance limits (turret traverse, hull break)
- Naval vessel data integration
- Weapon ballistics parameters
- 🔄 Advanced pattern features
- Pattern templates library
- Community pattern sharing
- Trigger import/export (JSON)
- 🔄 UI improvements
- Trigger event history viewer
- Pattern performance analyzer
- Custom event categories
- 🔄 On-screen HUD overlay
- Real-time game state visualization
- Active trigger indicators
- Device status display
- Customizable position and opacity
- 🔄 Advanced analytics
- Session statistics
- Trigger activation heatmaps
- Device usage metrics
- 🔄 Multi-game support
- DCS World integration
- IL-2 Sturmovik support
- Generic telemetry adapter
Tailgunner is an unofficial third-party application and is not affiliated with, endorsed by, or sponsored by Gaijin Entertainment. War Thunder® is a registered trademark of Gaijin Entertainment. Use at your own risk.
Developed with ❤️ for the War Thunder community
Feel the Thunder. Be the Thunder.