Guilds in Structs — choosing and joining one, ranks and rank-permissions, membership flows, settings, UGC moderation, charter vs entitlement founding, and the Central Bank (mint/redeem/convert). Use when picking a guild to join, creating a guild, managing members or ranks, moderating member identity, or running guild token operations.
A guild is your faction: it gives you a reactor to infuse, a substation to draw power from, a market to sell into, a token to mint, and allies (or moderators). For a new player, which guild you join is one of your most consequential early choices — it shapes your power source, your economy, and who has your back. This skill covers choosing/joining, running a guild, ranks/permissions, identity moderation, and the Central Bank.
Conventions (TX_FLAGS, -- rule, charge bar, one-tx-at-a-time) are in conventions.md.
When to use it
New player deciding which guild to join (or whether to go solo).
Creating or administering a guild.
Managing members, ranks, or moderating member identity.
Minting/redeeming guild tokens or managing Central Bank collateral.
Decisions
Choosing a guild (beginner) — evaluate candidates on:
Reactor commission — lower = more capacity per gram you infuse (structsd query structs reactor [id]).
Join requirements — joinInfusionMinimum you must meet (or get an invite to bypass).
Activity & size — guild-all then inspect members; an active guild means a working market and defenders.
Token economy — a guild whose token is actually used (providers priced in it) makes your earnings liquid.
Politics — see knowledge/lore/factions and your standing-orders. Joining a guild at war inherits its enemies.
A guild is rarely a trap, but its moderators gain reach into your name/pfp while you're a member (see UGC below). If you dislike a policy, you can leave.
Creating a guild (advanced) is either the chain-global charter PoW (guild-create-compute, weeks for a lone miner) or a one-time reactor entitlement (guild-create without proof: bonded validator past ~30 days, PermReactorGuildCreate on the reactor). A founder who owns a guild must transfer it first. Founding leaves your current guild if you are only a member. Third-party solvers need guild-charter-consent. See hashing.md — Guild Charter.
Rank system
Numeric ranks, lower number = higher privilege:
Rank
Meaning
1
Maximum (guild creator)
2–100
Custom ranks assigned by leadership
101
Default on join
0
Unset
A player can only modify members whose rank is strictly worse (higher number) than their own. Rank-permissions (granting a permission to everyone at/above a rank) are the scalable way to delegate — see structs-permissions.
Procedure
Join
Discover: structsd query structs guild-all, then guild [id] and reactor [id] for the candidates.
Meet the infusion minimum (or secure an invite). Join:
text
You get the default entry rank (101). Flows: invite (guild-membership-invite → invitee ...-invite-approve/-deny), request (guild-membership-request → owner ...-request-approve/-deny), proxy (a guild signs you in: guild-membership-join-proxy -- [address] [proof-pubkey] [proof-signature], with optional --substation-id, --player-name, --player-pfp, --player-pfp-client-render-attributes).
Administer
Ranks: player-update-guild-rank TX_FLAGS -- [player-id] [rank] (needs PermAdmin or rank authority); guild-update-entry-rank TX_FLAGS -- [rank] (new rank ≥ your own).
Membership: guild-membership-kick -- [player-id] (the guild is implicit in the target player); invite/request approve/deny/revoke as above.
Settings: guild-update-endpoint, guild-update-entry-substation-id, guild-update-join-infusion-minimum (+ -by-invite/-by-request; unknown bypass-level values are denied), guild-update-owner-id (Tier 2 — transfers the guild). Invite/request approve and accept require a pending application — they do not create one.
Founding: entitlement guild-create -- [reactor-id] [endpoint] [entry-substation-id] or charter guild-create-compute -D 3 (query guild-charter first). Third-party solver: guild-charter-consent then proof-path create.
UGC moderation
Structs has no global moderator — each guild sets its own name/pfp standards for member-owned objects, and the chain emits an audit event on every override. Grant moderation by rank (recommended) or per player:
bash
# Members at rank 5 or better can moderate guild-mate UGC
structsd tx structs permission-guild-rank-set TX_FLAGS -- [guild-id] [guild-id] 16777216 5
# Or a single moderator on the guild object
structsd tx structs permission-grant-on-object TX_FLAGS -- [guild-id] [moderator-player-id] 16777216
Perform a moderation: player-update-name/player-update-pfp/planet-update-name/substation-update-name/substation-update-pfp TX_FLAGS -- [target-id] "value". When the actor isn't the owner, the chain emits ugc_moderated (actor, target, field, old/new) — audit it. Note pfpClientRenderAttributes is owner-only and not guild-moderatable. Full philosophy + validation: knowledge/mechanics/ugc-moderation.
Central Bank (mint / redeem / convert)
Mint tokens against Alpha collateral: guild-bank-mint TX_FLAGS -- [alpha-amount] [token-amount] (signer's guild implicit; raw integers; ratio captured at action time). Guild-privileged.
Redeem tokens for Alpha: guild-bank-redeem TX_FLAGS -- [amount]uguild.[guild-id] [min-amount-alpha] — coin string plus Alpha slippage floor. Payout is floor(amount * collateral / supply) but still rejected if that payout is below min-amount-alpha.
Convert ualpha into an existing guild token at the live collateral ratio: guild-bank-convert TX_FLAGS -- [guild-id] [alpha-amount] [min-amount-token]. Needs PermTokenTransfer on the signer. Convert-in fee stays in collateral. min-amount-token is the slippage floor.
Convert token → token: guild-bank-convert-token TX_FLAGS -- [amount]uguild.[source-id] [target-guild-id] [min-amount-token] — redeems the source then converts into the target in one tx; both guilds keep their fees.
Confiscate & burn (Tier 2 act of war, audited forever): guild-bank-confiscate-and-burn TX_FLAGS -- [amount]uguild.[guild-id] [address] — token amount first, then the address it is taken from. The destination of a uguild.* send must be a registered player, the structs module, or an indexed provider pool — not IBC.
Mint/redeem are Tier 1 within your standing-order caps, Tier 2 above. Convert is the open market path. Economics: knowledge/economy/guild-banking.
