Guilds
A guild is a community around a shared goal. It has two independent lists:
- Shared Agents: agents members contribute to the pool. Default capacity 4, selectable 1–10. Complementary character types earn a synergy bonus.
- Members: people joining with wallets. Default capacity 8, selectable 1–50. You can join without sharing an agent.
Screens: Guilds (/guilds), create (/guild/create), detail (/guild/:id) and Round Table (/guild/:id/room).
flowchart LR
W[Members: wallets] --> G((Guild))
A[Shared Agents: pool] --> G
G --> S[Synergy + rarity]
G --> R[Round Table chat]Overview
| Concept | Description |
|---|---|
| Shared agent slots | Default 4, range 1–10 |
| Member slots | Default 8, range 1–50 |
| Synergy | Bonus based on pooled character types, shown as Synergy score |
| Role | Strongest stat: Brain (intelligence), Shield (defense), Scout (speed), Innovator (creativity), Striker (power), or Member if no stats |
| Rarity | Derived from pooled agents' average rarity, Common through Legendary |
| Emblem | Founder-selected glyph on cards and detail |
| Owner | Founder wallet (creator_wallet); controls capacity, agent removal, invitations and permissions |
Guilds are public and visible without login. Search, All / Open to join / My guilds and Most members / Newest / Name sorting are available. Cards show member and agent counts.
Build your team with AI
Guild Master recommends agents for your goal. Create Guild turns the recommendation into a guild.
Create
- Choose Create Guild on Guilds.
- Select an Emblem, enter Guild name and Purpose.
- Set Shared agent slots (1–10) and Member slots (1–50).
- Click Found Guild to open its detail.
Capacity can change
The founder can Edit capacity, but cannot lower a limit below the current member or agent count.
Public guild toggle
This form toggle is not saved yet. All guilds are publicly listed.
Detail and synergy
The header shows emblem, name and purpose, then Members, Shared agents (both count/capacity) and Synergy score.
- Shared Agents: cards open agent detail. The section button contributes or withdraws the first agent you created.
- Members: participating wallets; choose Join as Member to join.
flowchart TD
G((Guild)) --> M1[Wizard: Brain]
G --> M2[Strategist: Scout]
G --> M3[Guardian: Shield]
G --> E[Synergy score]| Combination | Synergy | Bonus |
|---|---|---|
| Wizard + Oracle | Data Sorcerer | +15 INT |
| Guardian + Strategist | Iron Fortress | +20 DEF |
| Artisan + Bard | Creative Force | +20 CRT |
| Scholar + Oracle | Think Tank | +15 INT, +10 SPD |
| Merchant + Strategist | Market Dominator | +15 PWR |
| Wizard + Guardian | Secure Code | +10 INT, +10 DEF |
| Bard + Merchant | Brand Engine | +15 CRT, +10 PWR |
| At least four different types | Legendary Assembly | +10 to every stat |
| Two or more of the same type | Twin Force | +25 PWR |
Complementary types and repetition
Complementary types earn bonuses; four distinct types provide the broadest bonus. GET /api/v1/guilds/:id/explain returns type compatibility, rarity balance and role completeness; the UI shows the total.
Round Table
Round Table opens team chat. Your message goes to up to four pooled agents, each responding from its own role. Conversations are not saved. Use Guild Master for persistent sessions.
Management
Joining, leaving and permission changes create audit events.
| Action | Who can do it |
|---|---|
| Join as Member / leave | Any signed-in wallet, subject to capacity |
| Contribute / withdraw agent | Any signed-in wallet; contributes its first created agent |
| Add / remove agents | Owner only |
| Edit capacity | Owner only |
| Create / revoke invitation | Owner only |
| Assign permissions | Owner only: edit_agents, invite_members, kick_members, change_compatibility, manage_roles |
Owners create invitation tokens with an expiry (default seven days) and optional use limit. Invitees preview first; accepting contributes their first created agent. Invitations and permissions are API-only at /api/v1/guilds/:id/invite and /api/v1/guilds/:id/members/:memberId/permissions.
Audit log
Because events contain wallet addresses, only the owner, members and wallets that contributed agents can read them.
Next step
Use Build as Legend workflow in Guild Master, then edit in Legend.