Faction Fields
This document describes all the configurable FACTION
fields available in the codebase, with their descriptions and example usages.
Unspecified fields will use sensible defaults.
Overview
Each faction in the game is defined by a set of fields on the global FACTION
table. These fields control everything from display name and lore, to starting weapons and player statistics. All fields are optional; unspecified fields will fall back to sensible defaults.
Field Summary
Field | Type | Description |
---|---|---|
name |
string |
Display name shown to players. |
desc |
string |
Lore or descriptive text. |
isDefault |
boolean |
Whether the faction is available without whitelist. |
color |
Color |
UI color representing the faction. |
models |
string[] |
Available player model paths. |
uniqueID |
string |
Internal string identifier. |
weapons |
string[] |
Automatically granted weapons. |
items |
string[] |
Automatically granted items. |
index |
number |
Numeric ID assigned at registration time. |
pay |
number |
Payment amount per interval. |
payLimit |
number |
Maximum accumulated pay. |
payTimer |
number |
Interval (in seconds) between paychecks. |
limit |
number |
Maximum number of players in the faction. |
oneCharOnly |
boolean |
Restrict players to one character only. |
health |
number |
Starting health. |
armor |
number |
Starting armor. |
scale |
number |
Player model scale multiplier. |
runSpeed |
number |
Base running speed. |
runSpeedMultiplier |
boolean |
Multiply base speed instead of replacing it. |
walkSpeed |
number |
Base walking speed. |
walkSpeedMultiplier |
boolean |
Multiply base walk speed instead of replacing it. |
jumpPower |
number |
Base jump power. |
jumpPowerMultiplier |
boolean |
Multiply base jump power instead of replacing it. |
MemberToMemberAutoRecognition |
boolean |
Auto-recognition among faction members. |
bloodcolor |
number |
Blood color enum. |
bodyGroups |
table |
Bodygroup name→index mapping applied on spawn. |
NPCRelations |
table |
NPC class→disposition mapping on spawn/creation. |
RecognizesGlobally |
boolean |
Global player recognition. |
ScoreboardHidden |
boolean |
Hide members from the scoreboard. |
Field Details
Basic Info
name
Type: string
Description: Display name shown for members of this faction.
Example:
FACTION.name = "Minecrafters"
````
#### `desc`
**Type:** `string`
**Description:** Lore or descriptive text about the faction.
**Example:**
```lua
FACTION.desc = "Surviving and crafting in the blocky world."
isDefault
Type: boolean
Description: Set to true
if players may select this faction without a whitelist.
Example:
uniqueID
Type: string
Description: Internal string identifier for referencing the faction.
Example:
index
Type: number
Description: Numeric identifier assigned during faction registration.
Example:
Appearance & Models
color
Type: Color
Description: Color used in UI elements to represent the faction.
Example:
models
Type: string[]
Description: Table of player model paths available to faction members.
Example:
bodyGroups
Type: table
Description: Mapping of bodygroup names to index values applied on spawn.
Example:
Economy & Limits
weapons
Type: string[]
Description: Weapons automatically granted on spawn.
Example:
items
Type: string[]
Description: Item uniqueIDs automatically granted on character creation.
Example:
pay
Type: number
Description: Payment amount for members each interval.
Example:
payLimit
Type: number
Description: Maximum pay a member can accumulate.
Example:
payTimer
Type: number
Description: Interval in seconds between salary payouts.
Example:
limit
Type: number
Description: Maximum number of players allowed in this faction.
Example:
oneCharOnly
Type: boolean
Description: If true
, players may only create one character in this faction.
Example:
Movement & Stats
health
Type: number
Description: Starting health for faction members.
Example:
armor
Type: number
Description: Starting armor for faction members.
Example:
scale
Type: number
Description: Player model scale multiplier.
Example:
runSpeed
Type: number
Description: Base running speed.
Example:
runSpeedMultiplier
Type: boolean
Description: If true
, multiplies the base speed rather than replacing it.
Example:
walkSpeed
Type: number
Description: Base walking speed.
Example:
walkSpeedMultiplier
Type: boolean
Description: If true
, multiplies the base walk speed rather than replacing it.
Example:
jumpPower
Type: number
Description: Base jump power.
Example:
jumpPowerMultiplier
Type: boolean
Description: If true
, multiplies the base jump power rather than replacing it.
Example:
Recognition & Relations
MemberToMemberAutoRecognition
Type: boolean
Description: Whether faction members automatically recognize each other on sight.
Example:
RecognizesGlobally
Type: boolean
Description: If true
, members recognize all players globally, regardless of faction.
Example:
NPCRelations
Type: table
Description: Mapping of NPC class names to disposition constants (D_HT
, D_LI
, etc.). NPCs are updated on spawn/creation.
Example:
bloodcolor
Type: number
Description: Blood color enumeration constant for faction members.
Example:
ScoreboardHidden
Type: boolean
Description: If true
, members of this faction are hidden from the scoreboard.
Example: