Faction Generator

Define the core groups and teams that players can join on your server.

---

Overview

Use this tool to generate the Lua structure for your custom faction. Once generated, the code should be placed in a new file within your schema's factions directory.

Recommended Placement:

garrysmod/gamemodes/[schema folder]/schema/factions/[faction_name].lua

---

Faction Index: The unique identifier for this faction (e.g., FACTION_POLICE)

Faction Name:

Description:

Color (R,G,B):

Comma-separated RGB values (0-255)

Logo: Logo material path or URL for scoreboard (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%)

Member Limit: Hard cap on total characters in this faction (online or offline). Leave empty for no cap.

Models:

+ Add Model Add player model paths

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 Whitelist of skin IDs players can select. Leave empty to allow all skins.

Allowed Bodygroups:

+ Add Bodygroup Whitelist of bodygroup values players can select, by bodygroup index and allowed values. Leave empty to allow all.

Health:

Armor:

Run Speed: Use as multiplier

Walk Speed: Use as multiplier

Jump Power: Use as multiplier

Pay/Salary: Currency amount per paycheck

Pay Timer (seconds): Interval in seconds between paychecks (defaults to global salary interval if not set)

Model Scale: Model scale multiplier. Also adjusts view offset proportionally. Leave empty for default (1).

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 constant applied on spawn. Leave default unless the faction is non-human.

Weapons:

+ Add Weapon Add weapon classes

Starting Items:

+ Add Item Add item unique IDs

Recognizes Globally Members are always globally recognized

Globally Recognized Faction is globally recognizable to others

Member Auto-Recognition Members automatically recognize each other

Hidden from Scoreboard Faction won't appear in scoreboard categories

Scoreboard Priority: Lower numbers appear first in scoreboard (default: 999)

Scoreboard Classes Public All players 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 Map Name, Position Vector, Angle

Main Menu Position:

+ Add Main Menu Position Map Name (leave empty for all), Position Vector, Angle

NPC Relations:

+ Add NPC Relation NPC class (e.g. npc_combine_s) and disposition (D_LI, D_HT, D_FR, D_NU)

Commands:

+ Add Command Command names members of this faction can execute

Generate Faction Code Generate Example

Generated Code

---