MovementTrainer

ARCHIVED: MovementTrainer is too heavy to run as squirrel mod (shared thread with the game) this does massivly increase latency and the feel of the game.

A Titanfall 2 Northstar mod that provides real-time visual feedback on movement tech quality.

Features

Movement Tech Tracking

• Wall Kicks: Detects and rates wall kick timing (1-5 frame window)
• Crouch Kicks: Identifies crouch kick executions with quality ratings
• Frame-perfect detection system
• Speed gain calculation

Visual Feedback System

• Real-time Ratings: Star-based quality system (★★★★★)

  • ★★★★★ PERFECT (1 frame) - Bright green
  • ★★★★☆ EXCELLENT (2 frames) - Yellow-green
  • ★★★☆☆ GOOD (3 frames) - Yellow
  • ★★☆☆☆ FAIR (4 frames) - Orange
  • ★☆☆☆☆ MINIMUM (5 frames) - Red-orange

• Detailed Feedback: Each movement tech displays:

  • Move type (WALL KICK / CROUCH KICK)
  • Quality rating with stars
  • Exact frame timing
  • Speed gained in units/second

• Display Duration: 1.5-2 seconds with smooth fade-out

Session Statistics

Live stats displayed in the top-right corner:

• Total movement techs performed
• Breakdown by quality rating
• Current streak counter
• Best streak achieved
• Average star rating

How It Works

Wall Kick Detection

The mod tracks when you leave a wall and measures how quickly you jump:

• 1 frame: Frame-perfect wall kick - maximum speed boost
• 2-3 frames: Excellent to good timing - solid speed gain
• 4-5 frames: Fair to minimum timing - minimal boost

Crouch Kick Detection

Automatically detects when you combine crouch + jump on wall contact for the powerful crouch kick tech that combines wall kick and forced endboost.

Quality Metrics

• Timing: Based on frames between wall exit and jump input
• Speed Gain: Tracks horizontal velocity increase
• Streak System: Rewards consistent high-quality movement (3★ or better maintains streak)

Installation

1. Install Northstar
2. Download the latest release of MovementTrainer
3. Extract the mod folder to your Titanfall2/R2Northstar/mods/ directory
4. Launch Titanfall 2 via Northstar

File Structure

FromWau.MovementTrainer/
├── mod.json                                    # Mod configuration
└── mod/
    └── scripts/
        └── vscripts/
            └── movement_trainer.nut            # Main tracking script

For Developers

Movement Tech Quality Criteria

Based on TF2 speedrunning community standards (TF2SR):

• Wall Kick: Jump within 5 frames of leaving wall for speed boost
• Crouch Kick: Crouch + Jump simultaneously on wall contact
• Forced Endboost: Pull away from wall and jump within specific timing window

Technical Implementation

• Tracking System: Monitors player state every frame

  • IsWallRunning(): Detects wall running state
  • GetVelocity(): Tracks speed changes
  • IsCrouched(): Identifies crouch input

• Frame Counting: Precise frame-by-frame timing measurement

• HUD System: Uses RUI (Respawn UI) for on-screen display

• Thread-Based: Asynchronous tracking for minimal performance impact

Credits

• Author: FromWau
• Movement Tech Reference: TF2SR Wiki
• Framework: Northstar

Contributing

Found a bug or have a feature request? Feel free to open an issue or submit a pull request!

License

MIT License - See LICENSE file for details

Resources

• Titanfall 2 Advanced Movement Guide
• TF2SR Movement Documentation
• Northstar Modding Docs
• Squirrel Scripting Reference