Documentation menu

Guilds

Federate groups with membership, ban feeds, guild hall, settings sync, and roster commands.

A guild is Lucy’s federation for groups that deliberately share organization and moderation. Each group holds exactly one membership. Groups (and guilds) may also subscribe to another guild’s ban feed without joining it.

Membership vs subscription

Relationship Direction What you get
Membership Bidirectional Shared roster standing, category settings sync, hall inheritance, guild bans
Subscription One-way Consume that guild’s ban list (ban default, or quarantine); optional reputation signal; no authority granted

Subscriptions are one hop and non-transitive. A guild never passes along bans it only subscribed to. Self-subscription is rejected.

Guild hall

The shared admin chat is the guild hall. Bind it with /adminchat in DM (guild owner) then /claim on a G… code. Group cards still prefer a local admin chat first, then the hall, then DM fan-out. Guild-scoped notices (gbans, roster, membership) go to the hall, or to the owner while unbound.

Settings sync

Category Default Covers
Moderation synced warn limit, warn action
Detection synced watch and quarantine thresholds
CAPTCHA synced mode, delivery
Greetings local welcome/goodbye and templates
Persona local intensity
Housekeeping local system message removal, report destination

Never synced: admin chat bindings and reputation sharing (each group’s privacy choice). /settings badges guild-managed categories; owners can change guild-wide or unsync for one group.

Roster and lifecycle commands

Command Who Purpose
/guildnew NAME DM Create a guild; you become owner
/guildinvite Guild owner (DM) Single-use join code (10 minutes)
/guildjoin CODE Group owner Preview authority, then confirm membership
/guildleave Group owner Leave the current guild
/guildpromote Guild owner Add guild admin (reply or USER_ID); fan-out promote
/guilddemote Guild owner Remove guild admin from the roster
/guildsub slug [quarantine] Group owner (or guild owner in DM) Subscribe to a ban feed
/guildunsub slug Same Drop a subscription
/guildstatus Admin / owner contexts Membership, roster, and feed summary

Guild bans

Command Who Purpose
/gban Guild roster admin Guild-wide ban (USER_ID reason or reply + reason in a member group)
/ungban Guild roster admin Revoke the live guild ban and reverse owned enactments only

Local /unban of a guild-banned user creates an exemption; local override wins and no guild ban re-enacts over it.

Ethics note

Guild bans amplify human decisions. Every gban carries an actor, origin, and reason. Propagated enforcement writes audit receipts; it does not create extra reputation events per group. One decision across twelve groups still counts as one human decision for reputation. Detection never invents a guild ban on its own.