Faction Generator

Define the major playable groups in your schema, such as civilians, police, staff, medical teams, military units, or custom setting-specific organizations. Factions are the top-level structure for character creation, whitelisting, models, limits, and default roleplay permissions.

Output Location:

garrysmod/gamemodes/[schema folder]/schema/definitions/sh_factions.lua

You can also add callback fields like OnTransferred, OnSpawn, NameTemplate, GetDefaultName, GetDefaultDesc, or any custom logic manually after generation. You can find those in Faction Definitions.

Faction Index: The constant name you want to assign to the registered faction index.

Faction Name:

Description:

Color (R,G,B):

Use three numbers from 0 to 255.

Logo: Logo shown on the scoreboard. You can use a material path or a web URL. Leave empty for no logo.

Is Default Faction Can new characters join this faction by default?

One Character Only Players can only have one character in this faction?

Player Limit: 0 = unlimited, decimals = percentage of server (e.g., 0.1 = 10%)

Models:

+ Add Model Add the player models this faction can use. Each entry is split into a model row and a second row for the skin/bodygroup rules tied to that model.

Allow Skin Selection Players in this faction can pick a skin for their character during character creation.

Allow Bodygroup Selection Players in this faction can customize bodygroups for their character during character creation.

Allowed Skins:

+ Add Skin Skin numbers players are allowed to choose. Leave empty to allow all skins.

Allowed Bodygroups:

+ Add Bodygroup Allowed bodygroup values by bodygroup number. More advanced setups can be added manually later.

Health:

Armor:

Run Speed Multiplier: Always multiplies the configured run speed. Use 1 for default speed.

Walk Speed Multiplier: Always multiplies the configured walk speed. Use 1 for default speed.

Jump Power Multiplier: Always multiplies the player's base jump power. Use 1 for default jump.

Pay/Salary: How much they get paid each paycheck.

Pay Timer (seconds): How often this faction gets paid. Leave empty to use the server salary timer.

Model Scale: Character size. Leave empty for normal size.

Blood Color: Default (BLOOD_COLOR_RED) BLOOD_COLOR_RED BLOOD_COLOR_YELLOW BLOOD_COLOR_GREEN BLOOD_COLOR_MECH BLOOD_COLOR_ANTLION BLOOD_COLOR_ZOMBIE Blood color used for this faction. Leave default for normal human characters.

Weapons:

+ Add Weapon Weapons this faction receives on spawn.

Starting Items:

+ Add Item Items new characters in this faction start with.

Recognizes Globally Members of this faction always recognize everyone.

Globally Recognized Everyone automatically recognizes members of this faction.

Member Auto-Recognition Members of this faction automatically recognize each other.

Hidden from Scoreboard Faction won't appear in scoreboard categories

Scoreboard Priority: Lower numbers show higher on the scoreboard.

Scoreboard Classes Public Everyone can see this faction's classes on the scoreboard.

See All Classes on Scoreboard Members of this faction can see every faction's classes on the scoreboard.

Custom Spawns:

+ Add Spawn Point Where this faction can spawn on each map.

Main Menu Position:

+ Add Main Menu Position Where this faction preview appears in the main menu.

NPC Relations:

+ Add NPC Relation How NPCs react to this faction.

Commands:

+ Add Command Command names that members of this faction can execute.

Generate Faction Code Generate Example

Generated Code