(1-6 letters/digits), is stored uppercased, and must be unique across all guilds. The tag color accepts a hex value (with or without a leading `#`) or a named color.\n\nGuild data is backed up as part of the automatic backup system if enabled in `settings.yml`.\n","frontmatter":{"title":"Guilds","description":"Player-run guilds with roles, invites, and join requests","order":5},"project":"Voxy","version":"v1","category":"Features","categoryPath":"features","categoryFsPath":"Features","extension":".mdx","lastUpdatedAt":"2026-07-21T10:47:51+03:00","contributors":[{"name":"iiAhmedYT","email":"61851106+iiAhmedYT@users.noreply.github.com","avatar":"https://github.com/iiahmedyt.png?size=64"}],"toc":[{"level":2,"text":"Guild Roles","id":"guild-roles"},{"level":2,"text":"Guild Features","id":"guild-features"},{"level":2,"text":"Guild Management","id":"guild-management"}]}

Guilds

Guilds

Guilds are player-run groups with their own roles, membership management, and cross-server sync. Guild data is stored in MongoDB and changes propagate across all servers via Redis packets.

Guild Roles

Role Permissions
Owner Full control - set tag and tag color, toggle invite-only, disband, plus invite players and accept join requests
Officer Invite players and accept join requests
Member Basic membership

The guild creator becomes the Owner. The Officer role grants invite and accept-request rights, but there is currently no command to promote or demote members, so members cannot be assigned to Officer in-game.

Guild Features

  • Invites - Owners and officers can invite players to join. Invites respect each player's guild-invite privacy setting, so players can choose who is allowed to invite them. Invites expire automatically after 5 minutes.
  • Join requests - When a guild is invite-only, players can request to join; owners and officers accept them with /guild accept. There is no deny command - unaccepted requests simply remain pending.
  • Cross-server sync - Guild updates (joins, tag changes, disband) propagate to all servers immediately
  • No leave command - there is currently no /guild leave or member-removal command; the only way a guild ends is the owner running /guild disband.

Guild Management

Commands — /guild (alias: g) | Permission: voxy.guild

Subcommand Description
create <name> Creates a new guild
join <name> Joins a guild directly, or sends a join request if it is invite-only
invite <player> Invites a player (Owner/Officer)
accept <player> Accepts a join request (Owner/Officer)
chat [message] Sends to guild chat or switches to it
info Shows your guild info
tag <tag> Sets your guild tag (Owner only)
tagcolor <color> Sets your guild tag color (Owner only)
settings inviteonly <true/false> Restricts joins to invited players only (Owner only)
disband Disbands the guild (Owner only)

Tag rules: a guild tag must match ^[A-Za-z0-9]{1,6}$ (1-6 letters/digits), is stored uppercased, and must be unique across all guilds. The tag color accepts a hex value (with or without a leading #) or a named color.

Guild data is backed up as part of the automatic backup system if enabled in settings.yml.