Random start positions

## What Is This Mod?

Random Faction Start is a mod for Warhammer 2 and 3 that shakes up your campaigns by randomizing where factions start on the map. Instead of always beginning in the same predictable spots, you and the AI factions get swapped to new, random locations. This adds replayability and surprise to every new game—perfect for veterans tired of the same old starts!

The mod is designed to be safe and non-intrusive: it only activates in brand-new single-player campaigns and won't mess with your saved games or multiplayer.

## What Does It Do?

- Random Starting Positions: Your faction (and others) start in different regions each game. The mod swaps territories between you and a random AI faction, teleporting armies and updating ownership.

- Choice of Styles: When you start a new campaign, you'll see a dilemma popup with three options:

- Mod Disabled: Play normally—no changes.

- Lore-Friendly: Keeps things thematic. Factions stick to regions that match their climates (e.g., Wood Elves in forests), Chaos is limited to spooky Dark Fortress areas, and only major cities are used.

- Pure Random: Total chaos! Any region is fair game, including small settlements. This shuffles all factions on the map for maximum unpredictability (expect a short 5-10 second pause while it works).

- Smart Camera: After the swap, the camera zooms to your new army position. It waits for the game's intro movie to end, then gives it 10 seconds to settle before moving—so no annoying overrides by cutscenes.

- Balanced Gameplay: The mod handles diplomacy, unit teleports, and map updates automatically. AI factions get your old lands, and you get theirs, keeping the world fair.

## How to Install and Use

1. Download/Setup: Grab the mod files and use a tool like PackFileManager to pack them into a `.pack` file.

2. Install: Drop the `.pack` into your Warhammer game's mods folder (usually `Warhammer3/Data/mods/` or similar for Warhammer 2).

3. Enable: Turn it on in the game's launcher.

4. Play: Start a new single-player campaign. The dilemma will pop up right away—choose your style and enjoy the randomness!

5. Reload/Continue: If you load a saved game, nothing happens; the mod only triggers fresh starts.

## Tips and Warnings

- Pure Random Mode: This mode can cause a brief freeze (5-10 seconds) as it rearranges everyone on the map. Peace is taking another 10 seconds after camera move. It's worth it for the chaos!

- Camera Behavior: The 10-second wait after the intro ensures the camera stays put. If it still moves weirdly, it might be a game quirk—try restarting or checking for conflicts.

- Compatibility: Works best alone. Other mods that change starts or camera might clash—test carefully.

- No Multiplayer: This is single-player only; multiplayer games stay unchanged.

- Bugs?: If the dilemma doesn't show or randomization fails, check your game logs or try a different faction/campaign.

## Why Use It?

If you're bored of cookie-cutter campaigns, this mod brings excitement back. Discover new strategies in unfamiliar territories, laugh at hilarious AI placements, or just enjoy the thrill of the unknown. It's simple, fun, and keeps Warhammer feeling fresh!

# - 2026-01-02

- Global Unique Tile Assignment: Implemented global tracking of used spawn tiles across all receivers (both pool and extra receivers) to prevent tile collisions between multiple characters from different factions (e.g., Tamurkhan and Nakai).

- Post-Teleport Correction System: Added automatic detection and correction of failed teleports for all characters, including heroes. This system logs issues only for selected debug factions but applies corrections universally.

- Enhanced Spawn Location Validation: Improved the spawn location finder to reject invalid coordinates (like -1,-1) and attempt placement within the same region first before allowing cross-region placement.

- Extra Receivers Retry Mechanism: Introduced a delayed retry teleport pass specifically for extra receivers (0-region factions) to counter start-script snap-back issues.

- Expanded Debug Logging: Added configurable debug keys for multiple factions and improved logging for teleport operations, warnings, and corrections.

### Changed

- Donor Distribution for Extra Receivers: Modified the donor assignment for extra receivers to use a random offset for better distribution and to avoid predictable pairings.

- Debug Target Update: Changed the legacy debug target from Valkia to Tamurkhan for more relevant testing.

- Code Structure Improvements: Refactored helper functions for better modularity, added comprehensive comments, and impro