LSR Gang Creator

LSR Gang Creator is an expansion plugin for Los Santos RED that allows players to create, configure, customize, and manage their own gangs directly in GTA V.

The plugin replaces the long and error-prone process of manually editing multiple Los Santos RED XML files. Instead, it provides an in-game interface that guides the player through every major part of gang creation, including the gang’s identity, territory, hideout, ambient members, outfits, vehicles, and spawn settings.

All generated content is stored in separate additive XML files. The original Los Santos RED files are never overwritten.

Main Features

In-Game Gang Creation

The plugin provides a standalone menu that can be opened with F7.

From this menu, the player can create a new gang without manually editing XML files. The creator handles identifiers, XML references, file structure, validation, and compatibility between the different Los Santos RED systems.

The interface is divided into dedicated submenus to keep navigation clear and avoid excessively long option lists.

The main sections are:

• General gang information

• Hideout and territory

• Gang members

• Gang vehicles

• Validation and saving

• Management of previously created gangs

Most values can be changed directly with the left and right arrow keys. The Enter key is mainly reserved for explicit actions such as text input, position capture, adding or removing elements, validation, and final saving.

General Gang Configuration

The player can configure the main identity and behavior of the gang, including:

• Internal gang identifier

• Gang display name

• Member name

• Contact name

• Hideout name

• Gang classification

• Gang color

• License plate prefix

• Ambient spawn limit

• Relationships and inherited settings from an existing gang template

An existing Los Santos RED gang can be used as a template. This allows the creator to inherit valid default settings while replacing the important identifiers and customized values.

Gang Hideout

The plugin can create a dedicated gang hideout based on the player’s current position.

The player can:

• Define the hideout entrance at the current position

• Save the player’s current heading

• Select an existing hideout as a configuration template

• Customize the hideout name and identifier

• Enable or disable the map blip

• Reuse safe map icon settings from existing Los Santos RED gangs

• Add ambient member spawn points

• Add parked vehicle spawn points

• Remove individual points or clear all saved points

The hideout is generated as a Los Santos RED gang den inside a separate additive location file.

The current implementation is primarily designed for exterior hideouts. It does not require the player to manually define custom interior data, IPLs, doors, teleport positions, or interior navigation.

Territory Creation

The player can assign the current game zone as a territory for the gang.

Territories are stored in the current in-memory draft and are only written to disk during the final save process. This prevents accidental XML changes while the player is still configuring the gang.

The generated territory is automatically linked to the correct gang identifier.

Ambient Gang Members

LSR Gang Creator can generate a dedicated ambient member group for each created gang.

Members use the GTA V freemode male model:

mp_m_freemode_01

The shared model name is normal for freemode characters. Individual members are differentiated through their complete appearance data rather than through separate model names.

The plugin can generate:

• Multiple outfit variants

• Multiple facial identities for every outfit

• Randomized head blends

• Randomized facial features

• Different hairstyles

• Different hair colors

• Different eye colors

• Custom clothing components

• Custom accessories

The number of generated faces per outfit can be configured. For example, two outfits with six generated faces per outfit will produce twelve different ambient member definitions.

This prevents all gang members from appearing with the same default freemode face.

Outfit Editor

The in-game outfit editor includes a temporary preview character.

The player can customize clothing components such as:

• Mask

• Arms and torso

• Pants

• Bags

• Shoes

• Accessories

• Undershirt

• Body armor

• Decals

• Upper body clothing

Supported accessories include:

• Hats

• Glasses

• Ear accessories

• Watches

• Bracelets

Drawable and texture values can be changed using the left and right arrow keys.

The number of available variations is read directly from GTA V, reducing the risk of selecting invalid drawable or texture indexes.

The player can create, rename, duplicate, preview, and delete several outfit variants before saving them.

Gang Vehicle System

Each gang can have its own vehicle group.

Vehicles may be added in two different ways.

Vehicle Catalogue

The plugin builds a vehicle catalogue from the DispatchableVehicles XML files installed with Los Santos RED.

The catalogue can include:

• Vanilla GTA V vehicles

• DLC vehicles

• Vehicles referenced by optional Los Santos RED configurations

• Compatible addon vehicle models referenced by installed XML files

The player can search the catalogue by model name or display name.

Vehicle preview is automatic. Entering the catalogue or moving between models with the left and right arrow keys immediately replaces the temporary preview vehicle.

A custom spawn name can also be entered manually for addon vehicles that are not already present in the catalogue.

Current Vehicle Capture

The player can also add the vehicle they are currently driving.

This method can capture additional configuration from the actual vehicle, including:

• Primary and secondary colors

• Pearlescent color

• Wheel color

• Interior and dashboard colors

• Window tint

• Livery

• Wheel type

• Installed modifications

• Extras

• Plate type

• Seat count

Adding the same model again updates its existing entry instead of creating unnecessary duplicates.

Vehicle Customization

Vehicles selected from the catalogue can be customized through an in-game workshop-style submenu.

Changes are immediately applied to the preview vehicle.

Supported settings include:

• Primary color

• Secondary color

• Pearlescent color

• Wheel color

• Window tint

• Livery

• Wheel type

• Vehicle extras

• Occupant limits

• Ambient spawn probability

• Wanted-level spawn probability

• DLC or addon requirement

• Random or fixed customization behavior

Supported vehicle modification categories include:

• Spoiler

• Front bumper

• Rear bumper

• Side skirts

• Exhaust

• Grille

• Hood

• Roof

• Engine

• Brakes

• Transmission

• Suspension

• Armor

• Front wheels

• Rear wheels

The creator detects how many modification options are available for the selected vehicle. Unsupported options are not applied.

Safe Validation and Saving

Editing menus only modify an in-memory draft. They do not immediately write changes to the Los Santos RED files.

Saving follows a protected three-step process:

1. Validate every section

2. Arm the save operation

3. Confirm the final save

The plugin calculates an internal fingerprint of the validated draft.

If any gang setting is modified after validation:

• The validation becomes invalid

• The save is automatically disarmed

• Final confirmation is locked

• The player must validate the gang again

This prevents outdated or partially validated data from being written accidentally.

Gang Creation Cost

Creating a new gang can require an in-game payment.

The default cost is:

$300,000

The amount is configurable through LSRGangCreator.ini.

Example:

[GangCreation]
RequireMoney=true
CreationCost=300000
IncludeBankAccounts=true

Available options include:

• Enabling or disabling the creation cost

• Changing the required amount

• Using cash only

• Combining cash and Los Santos RED bank accounts

The cost only applies when creating a new gang identifier.

Editing a gang that was already created by LSR Gang Creator is free.

The player’s available Los Santos RED funds are checked during validation and checked again before the final save.

The payment is taken immediately before the XML files are written. If the save operation fails, the plugin attempts to refund the deducted amount.

Created Gang Management

LSR Gang Creator includes a management menu for gangs previously created by the plugin.

Only gangs stored inside the plugin’s own generated XML files are displayed.

Original Los Santos RED gangs and gangs installed by unrelated addons are not offered for deletion.

Deleting a gang removes its related entries from the generated files, including:

• Gang definition

• Hideouts

• Territories

• Ambient member groups

• Vehicle groups

• Rival references from other plugin-created gangs

Deletion uses a two-step confirmation system to prevent accidental removal.

Timestamped backup files are created before modified XML files are overwritten.

Generated Files

Depending on the selected features, the plugin creates or updates additive files such as:

Plugins\LosSantosRED\Gangs+_000_GangCreator.xml
Plugins\LosSantosRED\GangTerritories+_000_GangCreator.xml
Plugins\LosSantosRED\Locations+_000_GangCreator.xml
Plugins\LosSantosRED\DispatchablePeople+_000_GangCreator.xml
Plugins\LosSantosRED\DispatchableVehicles+_000_GangCreator.xml

These files follow the additive naming system already used by Los Santos RED.

The original files, such as Gangs.xml, Locations.xml, and DispatchablePeople.xml, are not replaced.

Multilingual Support

Version 1.0 includes multilingual interface support.

Included languages:

• English

• French

The language can be selected in LSRGangCreator.ini:

[General]
Language=auto

Supported values include:

Language=auto
Language=en
Language=fr

With auto, the plugin uses French on a French Windows installation and English on other systems.

Additional languages can be added without recompiling the plugin.

Language files are stored in:

Plugins\LSRGangCreator\Languages\

A custom translation can be created by copying en.lang, renaming it with another language code, translating its values, and selecting that code in the INI file.

Missing translation entries automatically fall back to the default text.

Requirements

LSR Gang Creator requires:

• Grand Theft Auto V Legacy

• RAGE Plugin Hook

• Los Santos RED

• RAGENativeUI

• .NET Framework 4.8

Installation

Copy the compiled files into the GTA V Plugins directory:

Plugins\
├── LSRGangCreator.dll
├── LSRGangCreator.ini
└── LSRGangCreator\
    └── Languages\
        ├── en.lang
        └── fr.lang

The plugin menu can then be opened in game with:

F7

After creating or modifying a gang, Los Santos RED should be restarted or reloaded so that it can read the newly generated XML data.

Project Goal

The goal of LSR Gang Creator is to make custom gang creation accessible to players who do not want to manually maintain multiple interconnected XML files.

It reduces repetitive configuration work, prevents common reference and identifier errors, preserves the original Los Santos RED installation, and provides an organized in-game workflow for creating complete gangs with custom hideouts, territories, members, outfits, vehicles, and economic requirements.