Ultimate Battle Creator V1.3

Create custom RDR2 NPC battles with team survival, battle royale, deathmatch, free-for-all, difficulty settings, bosses, specials, presets, spectator camera, blips, and INI tuning.

Battle Creator is a ScriptHookRDR2 mod for Red Dead Redemption 2 that lets you create custom NPC battles directly from an in-game menu.

Main Features
Four battle modes: Team Survival, Battle Royale, Team Deathmatch, and Free For All.
Three battle types: All Weapons, Melee Only, and No Weapons.
Bulk set builder: quickly add groups like 20x O’Driscolls, 5x Van der Linde Gang, 5x Micah’s Gang, or 1x Boss John Marston.
Team modes use set-based rosters, so each team can contain multiple factions, difficulties, bosses, and specials at once.
Battle Royale and Free For All support solo, duo, trio, and squad setups.
Point-based Team Deathmatch and Free For All modes with respawns, kills, deaths, KD tracking, and optional endless score limit.
Optional Team Deathmatch setting for NPCs to respawn at their original spawn points.
Manual team spawn placement with coloured in-world spawn rings.
Random battle generator for quickly creating battles in any mode.
Save/load battle presets.
Normal factions, custom ped sets, Van der Linde Gang, Micah’s Gang, bosses, and special characters.
Separate custom ped set INI so users can add their own normal NPC groups without editing the main config.
Bosses and specials have custom stats, outfits, loadouts, blips, protection rules, and advanced combat behaviour.
Extreme, Special, and Boss fighters use improved headshot protection to reduce unfair one-shot kills.
Bosses include John Marston, Arthur Morgan, Dutch Van Der Linde, Micah Bell, and Colm O’Driscoll.
Special characters include Javier, Bill, Tommy, and Charles, each with different combat strengths.
Bosses and specials have enhanced combat movement, faster reactions, stronger accuracy, unique weapon behaviour, and improved survivability.
Spectator camera with target switching, kill info, force-spectate options, and player hiding while spectating.
In large-radius fights, spectating helps load terrain around the watched NPC.
Offscreen battle simulation keeps huge Battle Royale and Free For All matches progressing when fighters are far away or unloaded.
Long-distance convergence behaviour makes NPCs move toward far-away enemies instead of standing still.
Leaderboards for kills, deaths, KD, team placement, individual placement, and who killed the player.
Blips show combatants clearly with different colours for hostile, neutral, and friendly relations.
Bosses use standout blips so they are easier to track.
Battle modifiers include No Dead Eye, start countdown, auto-spectate, manual team spawns, and neutral retaliation behaviour.
INI-driven balance for difficulty stats, boss stats, special stats, healing, protection, cleanup, performance, keys, and combat tuning.

Modes

Team Survival
A one-life team battle mode. Up to four teams can fight, and each team can contain multiple sets of NPCs. Teams can be friendly, neutral, or hostile to the player. If the player dies while participating, they become a spectator.

Battle Royale
A one-life free-for-all/squad survival mode. Add any sets you want, choose solo/duo/trio/squad size, and let everyone fight until one fighter or squad remains.

Team Deathmatch
A respawning team mode with a score limit. Teams fight until one team reaches the kill target. Set the score limit to 0 for an endless match.

Free For All
A respawning free-for-all mode with a score limit, KD tracking, and solo/duo/trio/squad support. Set the score limit to 0 for an endless match.

Customisation
Most of the mod can be tuned through INI files. You can adjust difficulty stats, boss stats, special stats, spawn distances, score limits, respawn behaviour, cleanup, performance, battle modifiers, and more.
Custom normal ped groups can be added through BattleCreatorCustomPeds.ini.

Install
Install ScriptHookRDR2 V2.
Extract the download.
Put BattleCreator.asi, BattleCreator.ini, and BattleCreatorCustomPeds.ini in your main Red Dead Redemption 2 folder next to RDR2.exe.
Launch story mode and press F9 to open the menu.

BattleCreatorPresets.ini is created automatically when you save battle presets.

Controls
F9: open/close the menu and clear the post-battle leaderboard.
Up/Down: move through menu rows.
Left/Right: change selected values.
Shift + Left/Right: larger numeric steps.
N: randomize the current mode setup.
R: reload INI files while the menu is open.
K: enter/exit spectator camera during battles, or toggle leaderboard view after a battle.
Enter or Space: activate the selected menu row.
Delete: clear the current battle.

Requirements
ScriptHookRDR2 V2.

Notes
Very large battles can still stress RDR2, especially in dense towns such as Saint Denis.
The included README has the full difficulty, boss, special, INI, preset, and custom ped set details.
This is my first mod so let me know if there are any issues 🙂

Credits:

smxjko