Data API/Factions
factions/get
[edit | edit source]Returns a single faction.
Request
{ "type": "factions/get", "id": 1 }
Response — Faction
factions/members
[edit | edit source]Returns all users that belong to a faction.
Request
{ "type": "factions/members", "id": 1 }
Response — User[]
factions/recruiting
[edit | edit source]Returns recruiting factions of the viewer's profile type with an open member spot and at least one FP-funded active boost. Open Recruitment factions rank ahead of those requiring approval; within each group, sorting uses descending Monthly FP deposited, Lifetime FP deposited, then faction ID. Request-required factions must also be below the pending-request limit; factions with Open Recruitment do not need request capacity. Each profile type's list is limited to the configured browser size after filtering and ranking. Data is cached for up to 15 minutes and invalidated when recruiting-card fields change; active boosts are rechecked against current FP drain when serving cached rows.
Request
{ "type": "factions/recruiting" }
Response
{ lastUpdated: number; data: Faction[] }
factions/joinRequests
[edit | edit source]Returns faction join requests filtered by either faction or user.
Request
{ "type": "factions/joinRequests", "id": 1, "idType": "factionId" }
| Field | Type | Required | Notes |
|---|---|---|---|
id
|
positive integer | yes | faction ID or BcID |
idType
|
"factionId" | "bcId"
|
yes | determines what id refers to
|
Response — FactionJoinRequest[]
factions/leaderboard
[edit | edit source]Returns a paginated page of the faction leaderboard.
Request
{ "type": "factions/leaderboard", "stat": "fpDepositedMonthly", "page": 1 }
| Field | Type | Required | Notes |
|---|---|---|---|
stat
|
"fpDepositedMonthly" | "fpDepositedTotal"
|
yes | |
page
|
positive integer | yes | 1-based |
pageSize
|
positive integer | no | defaults to server-configured value |
profileType
|
"main" | "ironman"
|
no | scopes rankings to factions owned by players of that profile mode (hardcore is not supported as hardcore profiles cannot own factions) |
Response — LeaderboardPage<FactionLeaderboardEntry>
Each entry contains faction identity and display fields, the ranking stats, and the optional owner profile type:
{
id: number
tag: string | null
name: string
customizationSettings: FactionCustomizationSettings
ownerPremiumExpiryDate: Date | null
fpDepositedMonthly: number
fpDepositedTotal: number
ownerType?: "main" | "ironman" | "hardcore"
}
Generated from the Bconomy source documentation. Edits made on the wiki are overwritten on the next publish; ask the developers to change the source.