Documentação do Guild Butler

O Guild Butler conduz os raides, os pagamentos de espólio, os regears e a presença da sua guilda de Albion Online direto de dentro do Discord — quase tudo com botões, então não há quase nada para decorar.

Um raide é uma atividade em grupo agendada em Albion Online (uma luta PvP, uma reunião de coleta, uma grande batalha de aliança). O Guild Butler é um bot do Discord que cuida de todo o ciclo em torno de um raide: ele publica a convocação, coleta as inscrições, rastreia quem apareceu, divide a prata (a moeda do jogo de Albion) de forma justa quando o raide termina, e gerencia os regears (reembolsando membros que perderam equipamento). Oficiais apertam alguns botões; membros, ainda menos.

O ciclo do raide em poucas palavras

Quase tudo no Guild Butler é uma volta no mesmo ciclo. Aqui está ele, do início ao fim:

1. Convocar — um oficial publica um raide com /raid ou um botão de um clique no painel.
2. Inscrever — os membros clicam no botão do seu papel na publicação para entrar.
3. Executar — o raide acontece no jogo; oficiais podem atribuir papéis e fazer a chamada.
4. Acertar — um oficial aperta 💰 Acertar, insere o total do espólio, e o Guild Butler o divide.
5. Receber — a parte de cada membro cai no seu saldo rastreado; um oficial paga em jogo.
6. Regear (em paralelo) — quem perdeu equipamento registra um pedido de regear; um oficial revisa e credita.

Encontre a sua trilha

Esta documentação cobre três tipos de leitor, e todo título de seção é marcado para que você possa navegar direto para a sua parte:

• Jogadores — você entra em raides, se inscreve, registra regears e confere seu saldo.
• Oficiais — você convoca e acerta raides, conduz campanhas de regear e paga as pessoas.
• Admins — você configura o servidor: papéis, impostos, idioma e o painel de raides.

O Guild Butler nunca toca na sua conta de Albion Online e nunca mexe com dinheiro real — ele só rastreia números dentro do Discord, e um oficial envia a prata de verdade dentro do jogo. O bot vem em inglês e Українська.

2 · Adicionar o bot Admins

Clique em Adicionar ao Discord, escolha seu servidor, e o Guild Butler começa a funcionar na hora com padrões sensatos.

1. Clique em Adicionar ao Discord e escolha o servidor onde você quer o bot.
2. Confirme o convite na tela de autorização do Discord.
3. Pronto — o bot cria seus próprios registros e roda imediatamente com padrões seguros (sem papel de membro, impostos pré-definidos, inglês, UTC).

Você não precisa configurar nada para experimentar. Quando estiver pronto para ajustar para sua guilda — papel de membro, impostos, fuso horário, idioma — vá para §5 Configuração do servidor com /settings.

3 · Papéis & permissões Todo mundo

O Guild Butler tem quatro níveis de permissão — Membro, Oficial, Admin, Dono — e você se qualifica para cada um de um jeito diferente. Níveis mais altos podem fazer tudo o que os mais baixos podem.

Um nível decide quais botões e comandos você tem permissão para usar. Ele é baseado nas suas permissões e papéis do Discord, não em nada que você compra. Aqui está quem é quem:

Nível	Como você se qualifica	O que você pode fazer
Membro	Qualquer pessoa no servidor.	Abrir /menu, ver seu próprio perfil, saldo e estatísticas, criar raides sem imposto, se inscrever, salvar templates pessoais, registrar regears e avaliar raides.
Oficial	Detém o papel de oficial configurado, ou tem Administrador do Discord.	Tudo o que um membro pode, mais convocar e acertar raides, /manage, /assign, conduzir campanhas e revisões de regear, templates e presets de guilda, temporadas, pagamentos, bancos e compartilhamento de aliança.
Admin	Tem a permissão nativa de Administrador do Discord (uma permissão do Discord, não um papel do bot).	Tudo o que um oficial pode, mais configuração do servidor: /settings, /config, /raidboard settings e perfis de conteúdo.
Dono	A pessoa ou equipe que hospeda o bot para você.	Gerencia o lado da hospedagem (planos e marca própria). Você raramente vai lidar com esse nível diretamente — sua equipe cuida disso.

Duas coisas que vale lembrar. Primeiro, qualquer pessoa com Administrador no Discord é automaticamente oficial também — então admins podem conduzir raides sem também deter o papel de oficial. Segundo, ser membro de guilda é uma ideia separada: é sobre dinheiro (se o seu espólio é taxado e rastreado), não sobre quais comandos você pode rodar. Você vai configurar isso no §5.

4 · O hub /menu Todo mundo

Digite /menu uma vez para abrir um painel de botões privado e feito sob medida para você — a partir daí é quase tudo clique, não digitação.

O Guild Butler é construído em torno de botões, então você raramente precisa lembrar comandos slash. Rodar /menu abre um painel privado (só você consegue ver) que te recebe com o seu saldo de prata atual e organiza as ações em quatro grupos. O painel só mostra o que o seu nível pode usar, então membros veem menos botões que oficiais ou admins.

• Você — seu perfil, saldo, estatísticas, avaliações e 📊 Meu status (um cartão pessoal com seu saldo, pagamentos recentes e seus próximos raides inscritos, cada um com uma contagem regressiva ao vivo).
• Raides — convocar um raide, navegar e gerenciar templates, atalhos de inscrição.
• Economia — saldos, pagamentos, bancos e temporadas (voltado para oficiais).
• Admin — configurações do servidor e o painel de raides (só admins).

Prefere uma lista simples? Rode /commands para um resumo direto de cada comando ao qual você tem acesso. Mas na maioria dos dias, /menu mais alguns cliques é tudo que você vai precisar.

5 · Configuração do servidor com /settings Admins

Rode /settings para dizer ao Guild Butler quem são seus membros, qual idioma e fuso horário usar, e como o espólio é taxado. Esse é o passo que compensa — acerte e todo raide, pagamento e temporada simplesmente funciona.

Digite /settings e um hub privado se abre (só você consegue ver), organizado em quatro seções nas quais você entra:

• Server — papel de membro, papel de oficial, idioma, fuso horário.
• Economy — o modo de imposto e as taxas de imposto/líder.
• Raids — papéis de menção e o aviso automático na hora de reunião.
• Status — o painel de status do bot e o canal de feedback (veja abaixo).

Dentro de uma seção, a maioria dos controles são seletores de menu suspenso — escolha um valor e ele salva na alteração, sem precisar confirmar. Os campos numéricos (taxas de imposto, parte do líder, bônus do líder) ficam atrás da modal "Taxas" da seção Economy, que tem um botão Enviar — nada ali salva até você apertá-lo. Um botão ⬅ Voltar em cada seção te leva de volta ao hub.

Cada configuração do servidor

Aqui está a lista completa do que /settings controla. Você não precisa mexer em tudo — os padrões são sensatos, e os dois papéis no topo são os mais importantes.

Configuração	O que controla	Padrão	Valores
Papel de membro	Marca quem conta como membro de guilda (taxado e com saldo rastreado) versus um pug (um jogador de fora que só recebe uma parte igual, sem rastreamento). É a configuração mais importante da página.	Não definido	Qualquer papel do servidor
Papel de oficial	Concede poderes de oficial (convocar e acertar raides, conduzir campanhas de regear, gerenciar membros) a pessoas que não têm Administrador do Discord.	Não definido (só admins são oficiais)	Qualquer papel do servidor
Modo de imposto	Quem um raide taxa e rastreia no saldo: por papel (só membros de guilda, o padrão), todo mundo (cada participante), ou ninguém (uma divisão igual sem imposto). Defina o padrão do servidor aqui em Economy — você também pode pré-configurá-lo por tipo de conteúdo, e cada raide ainda pode ser convocado em um modo diferente. Veja §12.	Por papel	Por papel · Todo mundo · Ninguém
Idioma	O idioma do bot em todo lugar — tanto as mensagens públicas quanto seus painéis privados.	Inglês	English · Українська
Fuso horário	O fuso usado para interpretar os horários de raide que você digita. Os horários são armazenados em UTC e mostrados a cada pessoa no seu próprio horário local.	UTC	Qualquer fuso IANA (ex.: Europe/Kyiv)
Imposto de mercador %	A parte retirada da fatia reparada de cada membro e enviada ao banco Mercador (uma reserva da guilda para consumíveis e equipamento).	10%	0–100
Imposto de regear %	A parte enviada ao banco Regear (a reserva que financia a reposição de equipamento perdido). Também absorve quaisquer restos de arredondamento na divisão do espólio.	10%	0–100
Parte do líder %	Uma fatia do espólio total (bruto) retirada antes de tudo e entregue ao líder (o oficial que comandou o raide) antes de qualquer outra divisão.	0%	0–100
Pontos bônus do líder	Pontos de presença extras concedidos ao líder em cada raide, além de aparecer. Os pontos decidem as partes de pagamento da temporada.	0	Número inteiro
Papéis de menção	Um conjunto selecionado de chips de menção de um clique que você pode tocar ao publicar um raide, para não precisar procurar o papel certo toda vez.	Vazio	0–25 papéis
Painel de status	Um painel fixado (instalado a partir da seção Status) que mostra se o bot está online e qual versão está rodando, muda para atualizando durante um deploy, publica notas curtas de "novidades" nas atualizações, e traz um botão 💬 Feedback.	Não instalado	Qualquer canal de texto
Canal de feedback	Onde o feedback dos membros (pelo botão 💬 Feedback ou /feedback) é publicado para os seus oficiais verem.	Não definido	Qualquer canal de texto

Ordem de configuração recomendada

Faça nessa ordem na primeira vez. Os dois papéis vêm primeiro porque tudo o resto depende deles.

1. Defina o Papel de membro — escolha o papel que seus membros de guilda de verdade têm. É isso que separa membros de pugs.
2. Defina o Papel de oficial para que seus oficiais possam convocar e acertar raides sem precisar de Administrador do Discord.
3. Escolha seu Idioma se você não estiver rodando em inglês.
4. Defina seu Fuso horário para que os horários de raide digitados caiam na hora que você quer dizer.
5. Em Economy, abra Taxas e defina seu Imposto de mercador % e Imposto de regear %, depois aperte Enviar.
6. Ainda em Economy, escolha seu Modo de imposto se o padrão (por papel) não for o certo — escolha todo mundo se toda a sua escalação for de guilda, ou ninguém para divisões sem imposto.
7. Opcionalmente adicione uma Parte do líder %, Pontos bônus do líder, e alguns Papéis de menção — você sempre pode voltar a isso depois.

Painel de status & feedback

A seção Status é opcional, mas útil. Instale um painel de status do bot fixado em um canal (escolha um, ou deixe o bot criar #bot-status) e ele mostra rapidamente se o Guild Butler está online e qual versão está rodando. Durante um deploy ele muda para 🟠 atualizando, depois volta para 🟢 online — e em uma nova versão ele solta uma nota curta de "novidades" nesse canal.

O painel também traz um botão 💬 Feedback, e qualquer um pode rodar /feedback. Ambos abrem um formulário curto; o relatório — junto com um pequeno resumo restrito ao remetente (seu saldo, atividade recente, a versão do bot) — é publicado no Canal de feedback que você define aqui, para que os oficiais vejam relatos de bugs e ideias em um só lugar.

6 · Regras de regear Oficiais

Um regear é a guilda repondo equipamento que um membro perdeu em uma luta. Defina essas regras uma vez com /regear settings antes de conduzir uma campanha de regear, para que os pedidos caiam no canal certo com as provas que você espera.

Uma campanha é uma sessão de regear para um raide — os membros registram suas perdas, os oficiais as revisam. Essas configurações moldam como cada campanha se comporta. Rode /regear settings para abrir o painel.

Configuração	O que controla	Padrão
Categoria de evento	A categoria do Discord onde o bot cria automaticamente um canal novo para cada campanha de regear, mantendo os pedidos organizados e separados do seu chat principal.	Não definido
Canal de revisão	Onde os pedidos de regear são publicados para os oficiais aprovarem ou negarem. Se você deixar não definido, os pedidos caem de volta no canal da própria campanha.	Volta para o canal da campanha
Capturas mínimas	O número mínimo de imagens de prova que um membro deve anexar por item antes de poder enviar um pedido.	1
Valor máximo	Um teto sobre quanta prata um único pedido pode solicitar. Acima disso, o pedido não pode ser enviado como está.	Sem teto
Auto-aprovar abaixo de	Pedidos abaixo desse valor de prata são aprovados automaticamente — mas só o primeiro pedido aprovado do membro naquela campanha. Tudo depois disso ainda precisa de um humano. Defina como 0 para desativar a auto-aprovação por completo.	0 (desativado)
Texto de condições padrão	Uma nota padrão mostrada aos membros quando eles registram um pedido — as regras de regear da sua guilda, nas suas próprias palavras.	Não definido

7 · Painel de raides & perfis de conteúdo Admins

O painel de raides é uma mensagem persistente com botões de um clique para começar um raide. Cada botão é um perfil de conteúdo — um "tipo de raide" salvo (PvP, PvE, e assim por diante). Configure com /raidboard settings, depois solte em um canal com /raidboard post.

Um perfil de conteúdo é um botão de "tipo de raide" de um clique — aperte e o construtor de raide abre pré-preenchido para aquele conteúdo, então você não fica preenchendo os mesmos campos toda vez. O Guild Butler gera automaticamente três perfis para começar: PvP, PvE e Guild. Edite-os ou adicione os seus.

Campos por perfil

Campo	O que controla
Rótulo	O texto mostrado no botão (ex.: "PvP", "ZvZ").
Emoji	O ícone no botão, ao lado do rótulo.
Construtor	Simples abre uma modal rápida (título, horário como texto, papéis); Completo abre o construtor de raide completo.
Modo	Sem imposto (divisão igual, nada rastreado) ou Taxado (espólio e pagamentos rastreados). Botões em modo Taxado são só para oficiais.
Modo de imposto	Para perfis Taxados, pré-configura quem é taxado — por papel, todo mundo, ou ninguém — para que esse tipo de conteúdo sempre comece no modo certo (volta para o padrão do servidor). Veja §12.
Papel de menção	O papel automaticamente mencionado quando um raide é publicado a partir desse perfil.
Template	A composição de papéis salva (a "comp") da qual esse perfil parte.
Canal de publicação	Onde os raides desse perfil são publicados, se diferente do padrão do servidor.
Canal de voz de reunião	O canal de voz onde os jogadores se reúnem — defini-lo ativa a Chamada para o raide.
Ativado	Se o botão aparece no painel ou não.
Ordem	A posição do botão no painel em relação aos outros.

Também existe um único canal de publicação de raide do servidor todo — o lugar padrão onde os raides caem quando um perfil não define seu próprio canal de publicação.

Configurando

1. Rode /raidboard settings para configurar seus perfis e o canal de publicação de raide do servidor todo.
2. Ajuste os perfis PvP / PvE / Guild gerados automaticamente, ou adicione novos, e defina para cada um o rótulo, modo, template e canal.
3. Rode /raidboard post no canal onde você quer que o painel fique.

8 · Templates & comps Oficiais Jogadores

Um template (também chamado de comp) é uma lista de papéis salva e nomeada que você coloca em um raide em vez de digitar toda a escalação toda vez.

Pense em uma comp como a lista de compras de papéis do seu raide — "2 Tanks, 4 Curandeiros, 6 DPS, 1 Líder", e assim por diante. Salve uma vez, reutilize para sempre. Quando você convoca um raide, você só escolhe uma comp e os botões de inscrição aparecem automaticamente. Um template só define a escalação de papéis — nada sobre pagamentos, horário ou pontuação vive nele.

Pública vs Pessoal

Toda comp tem um escopo — quem pode ver e gerenciar. Existem dois:

• Pública — criada por um oficial e compartilhada com o servidor todo. Essas são as escalações oficiais da sua guilda (uma comp de ZvZ, uma comp small-scale, uma comp de gank). Só oficiais podem criar, editar ou excluir.
• Pessoal — qualquer um pode criar uma, e ela fica privada para você. Ninguém mais a vê. Ótima para salvar um cinco-homens favorito antes de convocar um raide sem imposto.

Quando você roda /template create você pode passar uma opção de escopo (Pública ou Pessoal (só você)). Deixe de fora e o bot escolhe por você: oficiais recebem uma comp Pública, todo mundo mais recebe uma Pessoal. Um não-oficial que pede explicitamente Pública é recusado.

As comps também são marcadas como PvP (jogador contra jogador) ou PvE (jogador contra ambiente, como masmorras). A marcação é puramente um rótulo de agrupamento — ela ordena as comps no painel e nos gerenciadores, e nada mais. Você a escolhe quando cria a comp, e pode mudá-la depois com um único botão (veja abaixo).

O painel de templates

/template board (oficiais) publica um painel persistente no canal — uma mensagem que fica lá para que qualquer um possa usá-la depois. Ele lista suas comps públicas agrupadas por marcação (uma linha ⚔️ PvP e/ou uma linha 🐉 PvE), com quatro botões embaixo:

• ⚔️ Nova PvP e 🐉 Nova PvE — abrem o formulário de criação. Se a nova comp cai como Pública ou Pessoal é decidido da mesma forma que o comando: oficial → Pública, todo mundo mais → Pessoal.
• 📋 Gerenciar públicas — abre o gerenciador de templates públicos (só oficiais).
• 👤 Meus templates — abre seu próprio gerenciador pessoal.

Os dois botões de gerenciador abrem um painel privado que só você consegue ver, então várias pessoas podem usar o mesmo painel ao mesmo tempo sem atrapalhar umas às outras. Cada comp no painel também mostra um breve resumo de estrutura — suas contagens de grupos e vagas (por exemplo 3 grupos · 50 vagas), para que você possa avaliar uma escalação rapidamente.

A sintaxe de especificação de papel

Quando você monta uma comp, você descreve cada papel em sua própria linha, ou separados por vírgulas. Cada entrada segue esta forma:

Só o Name é obrigatório. As partes, em ordem:

• Category > — um grupo opcional ao qual o papel pertence, escrito como Category > Name com um > entre eles (por exemplo Tanks > Main Tank ou Healers > Holy). O > é proposital — ele deixa a / livre para uso dentro de um nome de papel, então um nome de escolha de arma como Heavy mace / Hammer funciona bem. Categorias viram o menu de escolha de grupo em comps grandes.
• Name — como o papel se chama (até 40 caracteres).
• :slots — quantas pessoas podem assumir aquele papel, de 1 a 50. Deixe de fora e você tem 1 vaga.
• :emoji — um emoji opcional mostrado no botão de inscrição. Note que ele vive dentro da linha do papel — não há um campo de emoji separado na comp.

Algumas linhas de exemplo:

Múltiplos grupos

Uma comp não precisa ser uma única lista plana de papéis — você pode dividi-la em vários subgrupos (Grupo 1, Grupo 2, e assim por diante). Cada subgrupo é só um conjunto rotulado de vagas de papéis — pense em um deles como um cinco-homens autônomo ou uma ala de uma força maior. É assim que você organiza ZvZ e outras comps grandes em grupos legíveis (um grupo Frontline, um grupo Flank, um grupo Ranged) em vez de uma parede gigante de papéis.

Para abrir um subgrupo, coloque uma linha que comece com # e dê um nome a ela. Toda linha de papel abaixo desse cabeçalho pertence a esse grupo, até que o próximo cabeçalho # comece um novo. O # foi escolhido porque é o que se digita mais rápido. Aqui está uma comp de dois grupos:

Grupos e categorias trabalham juntos — o grupo (o cabeçalho #) é o agrupamento externo, e as categorias (o > antes de um nome) agrupam papéis dentro de um grupo. Na publicação do raide, uma comp com múltiplos grupos mostra cada subgrupo como sua própria coluna lado a lado, com uma reserva compartilhada embaixo que abrange o raide inteiro.

A inscrição funciona da mesma forma, só que consciente dos grupos. Em uma comp pequena com múltiplos grupos, cada papel ainda é seu próprio botão, com o nome do subgrupo grudado para não haver confusão (por exemplo ⚔️ Spear · DPS). Em uma grande (mais de 20 papéis) o menu pede para você escolher primeiro um subgrupo, depois um papel dentro dele. Oficiais recebem o mesmo passo de "grupo primeiro" quando usam /assign.

Colunas — a aparência de múltiplos grupos, sem subgrupos

Subgrupos te dão colunas lado a lado no cartão, mas eles também mudam a inscrição (em uma comp grande o seletor pede o grupo primeiro). Se você só quer o layout de colunas em uma comp simples de um único grupo — e manter a inscrição como botões de papel de um clique — adicione uma linha columns: N em qualquer lugar na caixa de Papéis:

columns: 1 (ou deixar a linha de fora) é o cartão clássico de coluna única. Você pode pedir de 1 a 4 colunas — o Discord mostra até três lado a lado no desktop e joga uma quarta para uma segunda linha. Uma comp que já usa subgrupos # ignora columns: (seus subgrupos já são as colunas), e um template salvo lembra sua quantidade de colunas.

Como a escalação preenche as colunas. O Guild Butler escolhe automaticamente um de dois jeitos:

• Por categoria — quando você marca papéis com Category > e há pelo menos tantas categorias quanto colunas, cada categoria é mantida inteira e colocada na coluna que estiver mais curta no momento. O resultado prático: uma categoria por coluna, em ordem, quando o número de categorias é igual às suas columns. Essa é sua alavanca para escolher exatamente o que vai onde — no exemplo acima, a Coluna 1 é toda a categoria Melee e a Coluna 2 é toda a categoria Ranged. (Com mais categorias do que colunas, as menores são agrupadas juntas para equilibrar.)
• Por posição — com nenhuma categoria (ou menos que columns), a lista plana é dividida de cima para baixo em blocos iguais e contíguos. Então columns: 2 sobre cinco papéis coloca as linhas 1–3 na primeira coluna e as linhas 4–5 na segunda; columns: 3 sobre seis papéis dá as linhas 1–2, 3–4, 5–6.

O formulário de criação

Criar ou editar uma comp abre um formulário curto com apenas duas caixas:

• Nome do template — um rótulo curto para a comp.
• Papéis — um papel por linha, usando a sintaxe de especificação de papel acima. É aqui também que você digita seus cabeçalhos de grupo # — a escalação inteira, grupos e tudo, vive nessa única caixa.

Você não define a marcação (PvP/PvE) nem o escopo (Pública/Pessoal) dentro desse formulário — formulários do Discord não conseguem conter esses menus. Ambos são escolhidos antes do formulário abrir, a partir da opção do comando ou do botão do painel/gerenciador que você clicou. A marcação ainda pode ser mudada depois pelo gerenciador. Editar uma comp com múltiplos grupos vai e volta de forma limpa: o formulário se preenche de novo com seus cabeçalhos # intactos, e renomear ou reordenar um grupo mantém no lugar todo mundo que já se inscreveu.

Gerenciando suas comps

Existem dois painéis de gerenciamento, e eles funcionam da mesma forma:

• /template manage (oficiais) — a biblioteca pública.
• /template mine (qualquer um) — sua biblioteca pessoal.

Cada painel lista suas comps (PvP primeiro, depois PvE) com um botão por comp, mais botões Nova PvP / Nova PvE embaixo. Clique em uma comp para abrir suas ações:

• ✏️ Editar — reabre o formulário de criação (nome + papéis) para mudar a escalação. Renomear uma comp acontece aqui também — não há um botão de renomear separado.
• Alternar marcação — um botão mostrando a marcação atual (⚔️ PvP / 🐉 PvE); clique nele para alternar a comp entre PvP e PvE no lugar.
• ⧉ Duplicar — fazer uma cópia, mantendo o mesmo escopo e marcação.
• 🗑️ Excluir — remover a comp.
• ← Voltar — retornar à lista.

As regras de permissão seguem o escopo: uma comp pessoal só pode ser tocada pelo seu dono, e uma comp pública só pode ser tocada por oficiais — para cada um desses botões.

Os comandos

Predefinições — salve o raide inteiro

Uma comp salva apenas a lista de papéis. Uma predefinição vai além e salva a configuração de um raide inteiro — comp, modo, horário de início, tier e requisitos de comida/poção, avaliações, papéis de ping e todo o resto — para que uma convocação recorrente seja publicada em poucos toques, em vez de montar tudo do zero toda vez. Pense em "faça exatamente como na CTA da última terça."

O painel de predefinições

As predefinições ficam em seu próprio painel fixado que se atualiza sozinho — nenhum comando para decorar. Um oficial o instala uma única vez (/preset board, ou /menu → 📚 Presets board e escolha um canal); depois disso, ele se reescreve no lugar sempre que uma predefinição muda.

Discord

🛡️

Guild Butler✓ APPHoje às 20:14

📚 Biblioteca de raides — Predefinições

Uma predefinição é uma convocação inteira salva — comp · horário · modo · requisitos · ping. Inicie uma em dois toques. Um modelo é apenas o layout da composição.

• Hideout Defend — 🏛️ · 🕒 20:00 · 🛡️ T8 · ⭐ · 👥×2
• CTA — Zone Blob — 🏛️ · 🛡️ T8 · 🍖 🧪 · 👥×3
• Ava Roads — 🎲 · 🛡️ T6 · 👤×7
• Faction Warfare — 🏛️ · 🕒 21:30 · 👤×15
• …e mais 22

📋 Escolha uma predefinição…▾

➕ Nova predefinição🔎 Ver todas (26)

Publique em dois toques

Escolha uma predefinição no menu suspenso e um painel privado se abre (só você o vê). Toque em ▶️ Usar e o construtor de raides abre já preenchido — a data salva no calendário é descartada e recalculada a partir de quão à frente a predefinição foi agendada (uma predefinição de "amanhã" sempre cai como amanhã), então normalmente você só define o horário e publica. Qualquer pessoa pode Usar uma predefinição; um não-oficial é limitado com segurança a uma convocação casual e sem imposto.

Discord

Só você pode ver isto

Gerenciando Hideout Defend

🏛️ · 🕒 20:00 · 🛡️ T8 · ⭐ · 👥×2 · 40

▶️ Usar ✏️ Editar ✏️ Renomear ⧉ Duplicar 🗑️ Excluir

Edite uma predefinição no lugar

Oficiais têm o ✏️ Editar, que reabre o construtor de raides na própria predefinição — altere a comp, o horário, os requisitos ou qualquer outra coisa pelos controles normais do construtor, e o botão final salva as mudanças de volta na predefinição em vez de publicar um raide. O ➕ Nova predefinição no painel monta uma do zero da mesma forma, então você nunca precisa publicar um raide descartável só para salvar uma configuração.

Discord

Só você pode ver isto

✏️ Editando predefinição: Hideout Defend

Modo

🏛️ Taxado (cargo)

Papéis

👥×2 · Tank×2 · Healer×4 · DPS… — 40

Horário

20:00

Requisitos

🛡️ T8 · comida · poções

🧩 Papéis🕒 Horário🛡 Requisitos🔔 Ping

💾 Salvar alterações

Gerencie, navegue e mantenha tudo organizado

O painel também traz Renomear, Duplicar e Excluir (oficiais). Os nomes das predefinições são únicos por servidor — tente salvar uma segunda "CTA" e o bot oferece editar a existente. Quando uma guilda acumula mais de 25 predefinições, um botão 🔎 Ver todas abre um seletor privado e paginado, para que nenhuma fique fora de alcance.

Discord

Só você pode ver isto

Todas as 26 predefinições — escolha uma:▾

◀1 / 3▶

Seguro por padrão

O construtor de raides mantém um único rascunho de trabalho por vez, então, se você estiver no meio de uma montagem e abrir uma predefinição, o bot pergunta antes de descartar seu rascunho em vez de perdê-lo silenciosamente. E a comp de uma predefinição é capturada como um instantâneo quando você a salva — editar ou excluir o modelo que a originou nunca pode alterar às escondidas o que a predefinição gera.

Discord

Só você pode ver isto

⚠️ Você tem um rascunho de raide não salvo. Abrir isto vai descartá-lo.

Descartar e abrirManter meu rascunho

Prefere comandos? Eles continuam funcionando: /preset list para navegar, /preset manage para o gerenciador em menu suspenso, /preset delete <name> para remover uma, e /preset board para (re)instalar o painel.

9 · Convocando um raide Oficiais Jogadores

Existem duas formas de publicar um raide: o construtor completo (/raid) para controle total, e o construtor simples (um botão no painel de raides) para um jeito rápido.

Um raide é um evento agendado no qual as pessoas se inscrevem. Publicar um solta uma publicação no seu canal de raide com um botão de papel para cada um reclamar sua vaga.

O construtor completo — /raid

Rode /raid e percorra o painel de rascunho. Você também pode anexar uma imagem de cara com /raid [image].

1. Rode /raid para abrir o rascunho.
2. Defina o Nome — isso é obrigatório; nada publica sem ele.
3. Escolha um template (comp) salvo ou digite os papéis você mesmo usando a sintaxe de especificação de papel do §8.
4. Escolha o modo (Sem imposto ou Taxado) e defina o horário — data, horário de reunião, horário de início e duração.
5. Adicione quaisquer requisitos (tier de equipamento, comida, poções) e mídia (um link de build com um rótulo, uma imagem).
6. Defina a menção (quem é notificado), escolha um canal de voz de reunião, e ative ou desative as avaliações.
7. Aperte o botão verde Publicar.

Algumas coisas que vale saber sobre o construtor completo:

• Não-oficiais só podem publicar raides Sem imposto. Raides Taxados (os que rastreiam espólio e pagam) são só para oficiais.
• Publicar é tudo ou nada. Se a publicação falhar por qualquer motivo, tudo é revertido de forma limpa — você não vai acabar com um raide meio criado.
• Escolher um canal de voz de reunião é o que ativa a Chamada mais tarde (veja §11).
• Avaliações vêm desativadas por padrão.

O construtor simples — a partir do painel de raides

Se o seu servidor tem um painel de raides (um conjunto de botões de um clique para tipos comuns de raide), clicar em um botão abre um formulário curto em vez do painel completo. Preencha:

• Título — o nome do raide.
• Horário — inserido como texto livre (qualquer formulação que seus membros entendam).
• Descrição — uma linha curta sobre o plano.
• Papéis — a comp, usando a mesma sintaxe de especificação de papel.

Depois aperte Publicar. É o jeito mais rápido de colocar um raide sem imposto no painel. Botões do painel definidos no modo Taxado abrem o construtor completo em vez disso e são só para oficiais.

10 · Se inscrevendo Jogadores

Reclame sua vaga em um raide clicando em um botão de papel na publicação — e saia com a mesma facilidade.

Comps pequenas — clique no seu papel

• Clique no botão de papel da vaga que você quer.
• Um papel já cheio aparece desativado — você não pode clicar nele.
• Clicar de novo no seu próprio papel sai daquele papel e libera a vaga.

Comps grandes — mais de 20 papéis

Quando um raide tem mais de 20 papéis, botões para cada um seriam difíceis de manejar, então você usa um menu em vez disso:

1. Clique em 🎯 Entrar.
2. Escolha uma categoria (o grupo de papéis da comp).
3. Escolha seu papel dentro daquela categoria.

Para sair de um raide com comp grande, clique em 🚪 Sair.

A reserva

Clique em 🪑 Reserva para ficar de prontidão sem assumir um papel específico. Isso é feito para jogadores flex — pessoas que o líder pode encaixar em qualquer papel que abrir na noite.

Deixe os líderes te encontrarem — /profile

Seu perfil registra quais papéis você realmente sabe jogar — Tank, Curandeiro, Support, Corpo a corpo, À distância, Montaria de batalha e Líder. Defina isso com /profile. Quando você fica na reserva, os líderes usam seus papéis listados para te encaixar em uma vaga aberta — então mantenha atualizado.

11 · Atribuir, gerenciar & chamada Oficiais

Uma vez que um raide está ativo, oficiais recebem ferramentas para posicionar pessoas, corrigir seu status, e conferir quem realmente apareceu.

Atribuir alguém — /assign

/assign coloca um membro diretamente em um papel específico (e grupo) no raide. Use para posicionar jogadores flex da reserva ou para organizar uma escalação manualmente em vez de esperar as pessoas clicarem em botões. Em um raide com múltiplos grupos, /assign pede que você escolha primeiro o subgrupo, depois o papel — e seu autocompletar rotula cada vaga com seu grupo para que papéis duplicados sejam fáceis de distinguir.

Gerenciar um membro — /manage

/manage (também acessível pelo botão 🛠️ Gerenciar na publicação) abre controles por membro. Para qualquer pessoa você pode:

• Alternar membro de guilda vs pug — sobrepõe como ela é taxada e rastreada para esse raide.
• Marcá-la como isenta de imposto de mercador ou isenta de imposto de regear — para que sua parte escape daquele desconto.
• Movê-la para a reserva ou de volta para ativo.
• Expulsá-la do raide por completo.

Chamada

Se você definiu um canal de voz de reunião ao montar o raide, a chamada compara quem se inscreveu com quem está realmente sentado nesse canal de voz — um jeito rápido de detectar quem faltou antes de sair.

12 · Acertando o espólio Oficiais

Quando um raide termina, o acerto transforma a pilha de espólio em prata que cai no saldo de cada membro e nos bancos da guilda. Um oficial roda isso uma vez por raide.

Primeiro, duas palavras. Bruto é o valor total em prata de tudo que o raide rendeu — você digita isso como um único número. Reparo é a prata que a guilda adianta para consertar o equipamento quebrado depois da luta. O acerto divide o bruto, depois retira alguns impostos pequenos para os bancos da guilda.

Rodar um acerto

1. Clique no botão 💰 Acertar na publicação do raide (ou rode /settle).
2. Insira a prata bruta e escolha um resultado (vitória / derrota / empate) para o raide.
3. Insira o valor de reparo — isso é cobrado só do pool de membros, nunca dos pugs.
4. Revise a prévia: ela mostra o líquido de cada membro, o total dos pugs, e os cortes de ambos os bancos.
5. Clique em Confirmar para travar — ou Recalcular antes se a escalação mudou e você quer os números atualizados.

Membros vs. pugs, em termos simples

Um membro de guilda é um participante que o raide taxa e rastreia; um pug (abreviação de "pick-up group" — um estranho que preencheu uma vaga) recebe uma parte fixa, sem nada rastreado. Os custos de reparo e os dois impostos da guilda saem só do pool de membros; pugs são pagos antes de tudo e saem sem dever nada. Quem conta como membro depende do modo de imposto do raide (abaixo): em por papel são os detentores do seu papel de membro; em todo mundo é cada participante (sem pugs); em sem imposto ninguém é taxado e todo mundo recebe uma divisão igual.

Os cinco compartimentos

Todo acerto divide o bruto em exatamente cinco compartimentos. Aqui estão eles com um exemplo prático — 700.000 de bruto, 7 pessoas no grupo (4 membros de guilda + 3 pugs), 50.000 de reparo, e um imposto total de 20% (10% mercador + 10% regear):

Compartimento	Quem / o quê	Este exemplo
Líquidos dos membros	O que cada membro de guilda leva, depois do reparo e imposto	70.000 cada (4 membros = 280.000)
Pugs	Parte fixa paga aos 3 estranhos	300.000
Reparo	Reservado para consertar equipamento (só pool de membros)	50.000
Banco Mercador	Imposto de mercador sobre a parte reparada dos membros	35.000
Banco Regear	Imposto de regear (também absorve restos de arredondamento)	35.000

Esses cinco sempre somam de volta ao bruto — nada aparece nem desaparece. Essa é a identidade de reconciliação:

Em números: 700,000 == 300,000 + 50,000 + 280,000 + 35,000 + 35,000. Se a prévia nunca fechar, o acerto não vai confirmar.

Modos de imposto

Como um raide é taxado depende do modo de imposto em que ele foi convocado. O construtor de raide rotula a escolha como Taxado (todo mundo/papel) ou Sem imposto; você define o padrão do servidor em /settings → Economy (ou pré-configura por tipo de conteúdo), e cada raide pode sobrepor:

• Sem imposto — uma divisão igual e simples do bruto entre todo mundo. Nada é taxado e nada é rastreado (sem saldos, sem estatísticas, sem bancos). Essa é a antiga divisão "casual".
• Taxado · por papel — o padrão. Só membros de guilda (detentores do seu papel de membro) são taxados e rastreados; pugs recebem uma parte fixa. Essa é a divisão completa de cinco compartimentos acima.
• Taxado · todo mundo — cada participante é tratado como membro: todos taxados e rastreados no saldo, sem pugs. Útil quando toda a sua escalação é de guilda.

Separadamente, um raide pode ser acertado em um Pool: sua prata líquida flui para uma temporada ativa em vez de pagar na hora, para ser dividida depois pelos pontos de presença (veja §16). Pool é sobre quando a prata é paga; modo de imposto é sobre quem é taxado — eles são independentes.

Errou em um acerto de guilda normal? Rode /unsettle para reverter e recomeçar. Note que isso só pode desfazer um acerto comum — não pode recuperar um pagamento de temporada ou pool depois de já ter sido distribuído.

13 · Saldos & recebendo pagamento Todo mundo

Todo raide acertado atualiza um total corrente de prata por membro — seu saldo. Membros conferem o seu; oficiais o pagam a partir de um painel.

Membros: confira seu saldo

Rode /balance para ver seu total corrente de prata mais o histórico recente do seu livro-razão — o registro linha por linha do que foi adicionado (líquidos de raide, ajustes) e pago. Seu saldo sobe quando raides são acertados e regears são aprovados, e desce quando um oficial te paga.

Oficiais: o painel de pagamento

Rode /balances para abrir o painel de pagamento — todo membro com saldo positivo. Para pagar alguém:

1. Abra /balances e escolha um membro no painel.
2. Escolha Pagar tudo, ou Outro valor para pagar uma soma parcial (deve ser ≤ o saldo atual dele).
3. O bot registra uma entrada de pagamento no livro-razão dele e reduz seu saldo por esse valor.

Ajustes manuais & os bancos

Use /adjust para adicionar ou deduzir prata do saldo de um membro manualmente — útil para correções ou bônus avulsos. Tem uma flag de contar como regear caso o ajuste deva ser rastreado como um reembolso de regear em vez de um ajuste comum.

Rode /bank para ver os dois bancos da guilda que os impostos alimentam: o banco Mercador e o banco Regear. Esses são fundos de guilda em conjunto, separados do saldo de qualquer indivíduo.

14 · Energia sifonada Todo mundo

Opcional. Se a sua guilda rastreia Energia Sifonada — o recurso compartilhado que os membros retiram do seu esconderijo — o Guild Butler espelha o log de energia do jogo e mantém todo mundo responsável pelo que tirou, então substitui um bot separado de rastreamento de energia.

A ideia: qualquer jogador pode copiar o log de energia de até 4 semanas da sua guilda dentro do jogo, e um oficial o cola no discord. O bot o reconcilia em um saldo de energia por membro (depósitos menos saques), o mostra em um painel ao vivo, e envia mensagens diretas para qualquer um que ficar negativo. Prata e energia são rastreadas separadamente — energia nunca toca nos seus saldos de prata.

Ativar e instalar o console Oficiais

1. Rode /siphoned hub — o hub do oficial, com uma pequena lista de verificação "primeiros passos".
2. Clique em 📥 Instalar console e escolha um canal. O bot publica um console de energia fixado ali (e ativa o rastreamento).

Manter atualizado — colar o log

O jogo só lembra ~4 semanas, então colar o log regularmente (diariamente é ideal). Qualquer um pode pedir uma atualização; só oficiais (ou um papel que você designar) colam de verdade.

1. No console, clique em 🔄 Solicitar atualização. Se você conseguir colar, uma thread abre com instruções; se não conseguir, ele avisa os responsáveis pelo log para fazerem isso.
2. Cole o log da tela de Guild Management → Siphoned Energy do jogo (o Discord anexa colas longas como arquivo automaticamente — tudo bem).
3. O bot mostra uma visualização — quantas linhas são novas versus já registradas, e um aviso se houve uma lacuna desde a última importação. Clique em Importar.
4. Marque qualquer saque grande que tenha sido gasto da guilda (núcleos de poder, sala principal, etc.) no seletor para que não contem contra o jogador que os retirou, depois Pronto.

Colar o mesmo log novamente é seguro — o bot só registra linhas que não viu, então colas sobrepostas nunca contam duplo.

Membros: confira seu saldo Jogadores

O log fala em nomes no jogo, então link do seu uma vez para ter funcionalidades pessoais: rode /ign set <your in-game name>. De lá em diante:

• Seu saldo de energia aparece no console (como sua menção), em /menu ao lado da sua prata, e via /siphoned balance ou o botão ⚡ Meu saldo do console.
• Se seu saldo ficar negativo, o bot te envia uma mensagem direta empurrando para depositar (no máximo uma vez por semana enquanto você estiver no vermelho).
• /siphoned transfer <member> <amount> passa um pouco da sua energia para outro membro; /siphoned top lista os maiores devedores.

Migrar de outro bot Oficiais

Vindo de outro bot de energia? Traga seus saldos existentes para que ninguém comece do zero. A ordem importa, porque seu saldo antigo e o log de 4 semanas se sobrepõem no último mês:

1. Importe o log primeiro (Solicitar atualização → colar → Importar, como acima). Isso coloca as últimas 4 semanas.
2. Depois /siphoned hub → 📥 Migrar saldos e cole a lista de saldos do seu bot antigo.
3. No seletor (ordenado maior primeiro), pule qualquer conta de "detentor de dívida" — o personagem fictício que alguns bots estacionam toda a dívida da guilda — para que seu saldo fantasma não seja dado a um jogador de verdade. Depois Aplicar.

A migração recalcula retroativamente cada saldo de abertura para que todo membro caia exatamente no seu número do bot antigo, com o histórico real de 4 semanas por baixo. É re-executável — se você migrar antes de importar o log por engano, basta rodar a migração novamente depois e ela se autocorrige.

15 · Regear: pedir & revisar Todo mundo

Um regear reembolsa um membro pelo equipamento que perdeu em um raide. O membro registra um pedido com provas; um oficial o revisa, e aprovar credita o saldo do membro.

Um regear é registrado contra uma campanha — um evento que um oficial abre para coletar pedidos de um raide ou dia específico. Tudo acontece em uma thread privada para que capturas de tela e valores fiquem organizados.

Membro: registrar um regear

1. Um oficial abre uma campanha com /regear board.
2. No painel, clique em 📸 Pedir regear — o bot abre uma thread privada só para você.
3. Clique em ➕ Adicionar morte para uma morte com perda de equipamento, ou ➕ Adicionar OC para adicionar uma linha de "fora de conteúdo" (equipamento perdido fora da luta principal).
4. Insira o valor em prata daquele item — o que o equipamento valia.
5. Solte suas capturas de tela na thread como prova.
6. Clique em ✅ Enviar assim que todo item tiver um valor e pelo menos o número mínimo de capturas de tela.

Oficial: revisar um pedido

Cada pedido enviado cai como um embed de revisão com quatro ações mais uma revogação:

• ✅ Aprovar — aceita o pedido. Você pode editar valores para baixo antes de aprovar, ou definir uma linha como 0 para descartá-la por completo.
• ❌ Negar — rejeita o pedido de vez.
• ✍️ Pedir informação — reabre a thread e pede ao membro mais detalhes ou capturas melhores.
• ↩️ Revogar — desfaz um regear que você já aprovou.

Se você ativou a auto-aprovação nas suas configurações de regear, pequenos pedidos de primeira vez podem passar instantaneamente sem revisão manual, para que os membros não esperem por valores minúsculos.

Quando todos os pedidos de uma campanha forem resolvidos, feche-a com /regear close.

16 · Presença, avaliações & estatísticas Todo mundo

Raides taxados constroem discretamente o seu histórico: pontos de presença se registram sozinhos, avaliações são opcionais, e /stats mostra o que você ganhou e como você apareceu.

Pontos de presença

Pontos de presença são uma contagem simples de quantos raides você apareceu. Você nunca os concede manualmente — eles se registram automaticamente toda vez que um raide taxado é acertado. Um "raide taxado" é um rodado em modo Taxado (os modos 🏛️), em oposição a um raide sem imposto, que é uma execução rápida e não rastreada.

Todo raide taxado acertado vale um ponto de presença; raides sem imposto não valem nada. Os pontos vêm do modo do raide — conteúdo rastreado (taxado) versus sem imposto — não de nenhuma configuração por template. (Um líder pode ganhar alguns pontos bônus por raide se um admin configurou isso.) Raides sem imposto não rastreiam nada — sem pontos, sem histórico de ganhos — então não espere que eles apareçam aqui.

Avaliações (opcionais)

Depois de um raide, a equipe e o líder (o oficial que comandou o raide) podem se avaliar mutuamente — um jeito leve de sinalizar bons companheiros de equipe e boa liderança. Avaliações só são coletadas quando o oficial ativou o botão de avaliações para aquele raide (ele vem desativado por padrão), então a maioria das execuções não vai perguntar.

Se suas avaliações aparecem no painel público é totalmente sua escolha. Suas avaliações são privadas por padrão. Use estes dois comandos para controlar isso:

Suas estatísticas

Três comandos leem os números, dependendo de quem você é e de quem você quer ver o histórico:

/stats caller vale a pena olhar de perto se você conduz raides. Ele resume como os raides de um líder foram: bruto total e médio (a prata que um raide trouxe), qual parte foi para reparo (o custo de consertar equipamento), e a mistura de resultados (vitória/derrota registrados na hora do acerto). É uma medida justa e rápida da eficiência de um líder ao longo do tempo.

17 · Temporadas Oficiais Opcional

Uma temporada é um modelo alternativo de pagamento: em vez de dividir cada raide na hora, o espólio se acumula durante toda a temporada e paga por presença no final.

Como uma temporada funciona

Normalmente, cada raide taxado é acertado e pago individualmente. Uma temporada muda isso: enquanto uma temporada está rodando, raides em modo pool não pagam um por um — sua prata líquida flui para um único pote compartilhado. No final da temporada você divide esse pote entre todo mundo pelos pontos de presença, então quem mais apareceu leva mais para casa.

1. Um oficial roda /season start para abrir a temporada.
2. Raides em modo pool são acertados normalmente, mas sua prata líquida alimenta o único pote sazonal em vez de pagar imediatamente. Cada participante também ganha pontos de presença.
3. Qualquer um pode rodar /season status para ver o tamanho atual do pote e sua própria parte projetada.
4. Um oficial roda /season end para dividir o pote pelos pontos de presença e fechar a temporada.

O líquido que alimenta o pote é o que sobra da prata de um raide depois das deduções normais (impostos, reparo, qualquer parte do líder). Você ainda acerta raides em modo pool da forma normal — a diferença é só para onde o dinheiro vai depois.

18 · Compartilhamento de presença entre alianças Oficiais Opcional

Duas guildas aliadas podem compartilhar presença de raide entre si — nunca prata, nunca escalações — para que membros que lutam ao lado de um aliado ainda recebam crédito em casa.

O que é compartilhado (e o que nunca é)

O compartilhamento de presença entre alianças permite que uma guilda repasse pontos de presença de jogadores que participaram de um raide em nome de uma guilda aliada. Ambos os lados precisam consentir, e o vínculo é deliberadamente restrito: só a presença atravessa. Nenhuma prata jamais se move entre guildas, e nenhum dos lados vê a escalação ou a economia do outro.

Existem dois papéis nesse acordo: a guilda fonte (a que compartilha presença dos seus raides) e a guilda assinante (a que segue, cujos membros recebem o crédito).

Configurando o vínculo

1. Na guilda fonte, um oficial roda /alliance e escolhe o papel que marca os jogadores do aliado.
2. O bot retorna um código único que expira em 24 horas.
3. Envie esse código a um oficial na guilda assinante.
4. O oficial assinante roda /alliance, escolhe Seguir, e cola o código.

Assim que o vínculo estiver ativo, sempre que a guilda fonte acertar um raide, quaisquer participantes que detenham o papel vinculado (o papel escolhido no passo 1) são creditados à guilda assinante — só presença. Qualquer um dos lados pode revogar o vínculo depois; revogar interrompe o crédito futuro e não recupera o que já foi compartilhado.

19 · Marca própria & planos Admins Opcional

O Guild Butler é totalmente gratuito para usar. O único upgrade pago hoje é a marca própria — deixar o bot vestir o nome e o rosto da sua própria guilda.

Planos

Existem dois níveis, e vamos ser diretos com você sobre a diferença:

Plano	O que você recebe
Gratuito	O bot inteiro — cada recurso de raide, acerto, regear, temporada e estatísticas nesta documentação.
Pro	Tudo do Gratuito, mais marca própria.

Sinceramente: marca própria é a única diferença paga hoje. Todo recurso de raide e economia funciona no Gratuito. Confira seu nível a qualquer momento com /plan show.

O que a marca própria faz

Marca própria permite que o bot assuma a identidade da sua guilda em vez da marca padrão do Guild Butler. Existem duas variantes:

• Um apelido no bot compartilhado — o mesmo bot Guild Butler que todo mundo usa, mas vestindo um apelido por servidor da sua escolha.
• Um bot totalmente dedicado — seu próprio bot com seu próprio nome e avatar, rodando só para a sua guilda.

Ativando

Uma vez que seu servidor está no plano certo, oficiais gerenciam a marca com um comando:

O caminho do apelido funciona na hora, direto do Discord. Um bot totalmente dedicado — com seu próprio nome e avatar — é configurado junto com a equipe do Guild Butler, já que precisa de um bot separado provisionado para você. Fale com a equipe para colocar isso em andamento.

20 · Painel web Todo mundo

Uma visão web somente leitura da economia da sua guilda e das suas próprias estatísticas — entre com o Discord, sem senha nova.

O painel web é um site complementar ao bot. Tudo o que ele mostra já vive no Discord — o painel só te dá uma janela maior e ordenável para isso. Ele nunca muda nada: é somente leitura e privado à sua guilda.

1. Vá para app.guild-butler.com no seu navegador.
2. Clique em Entrar com Discord — você autoriza com sua conta Discord existente, então não há senha nova para criar.
3. Escolha seu servidor na lista. Só aparecem os servidores que você compartilha com o bot.
4. Leia sua visão: oficiais veem a visão geral de economia, tendências ao longo do tempo, e o quadro de membros; membros veem a visão geral mais suas próprias estatísticas.

O que cada papel vê corresponde ao que já pode ver no Discord — a visão de saldo e pagamentos de um oficial, o próprio saldo de um membro (prata devida a ele) e presença. Ninguém vê os dados de outra guilda, e membros não veem os números privados de outros membros.

21 · Referência de comandos Todo mundo

Todo comando slash, agrupado por quem o usa. A maioria dos membros nunca precisa disso — botões atrás de /menu cobrem o dia a dia.

Digite / em qualquer canal para ver os comandos que suas permissões permitem. Abaixo, cada cartão lista o comando, o que ele faz, e quem pode rodá-lo. Membro = qualquer um no servidor, Oficial = detém o papel de oficial ou tem Administrador do Discord, Admin = tem Administrador do Discord.

Você

Raides

Economia

Admin

22 · FAQ & solução de problemas Todo mundo

Respostas rápidas para perguntas comuns, depois correções para as configurações que costumam confundir as pessoas.

Perguntas comuns

Solução de problemas

23 · Glossário Todo mundo

Definições em linguagem simples para cada termo do Guild Butler e de Albion Online usado nesta documentação, em ordem alfabética.

Termo	Significado
Compartilhamento de aliança	Um vínculo de mão única entre duas guildas. A guilda fonte compartilha seus raides acertados para que participantes marcados também ganhem presença na guilda assinante. Só presença é compartilhada — nunca prata.
Pontos de presença	Pontos que um membro ganha por aparecer em raides rastreados. Eles direcionam as estatísticas e, em uma temporada, como o pote é dividido.
Saldo	A prata que a guilda atualmente deve a um membro (ou que um membro deve à guilda). Cresce quando raides são acertados a seu favor, encolhe quando ele é pago.
Escalação base	Uma fatia igual do espólio acertado da qual cada participante qualificado parte, antes de impostos e cortes serem aplicados.
Reserva	Um jogador inscrito mantido de prontidão em vez de ativo para um raide. Jogadores na reserva ficam de prontidão e podem ser trocados para dentro.
Líder 👑	A pessoa que comanda um raide. Pode receber uma parte de líder e/ou pontos de presença bônus.
Parte do líder	Uma porcentagem do espólio bruto retirada antes de tudo para o líder, antes do resto ser dividido. Padrão 0%.
Casual / raide sem imposto 🎲	Um modo de raide descontraído que qualquer membro pode criar — rotulado Sem imposto no bot. Ele divide o espólio igualmente e não rastreia nada — sem impostos, sem presença, sem pote de temporada.
Categoria (papel)	Um agrupamento de papéis dentro de uma comp (por exemplo, tanks ou curandeiros). Em comps grandes você escolhe uma categoria primeiro, depois um papel específico.
Perfil de conteúdo / painel de raides	Um botão de conteúdo de um clique no painel de raides (PvP, PvE, Guild gerados automaticamente). Cada perfil traz seu próprio rótulo, emoji, modo, template, papel de menção, e canal.
Campanha / evento	Uma sessão de regear. Oficiais abrem uma campanha; membros registram pedidos de regear contra ela, muitas vezes em seu próprio canal ou categoria.
Efêmero	Uma mensagem do Discord que só você consegue ver. Muitas respostas do bot (como confirmações privadas) são efêmeras para não lotar o canal.
Bruto	O valor total de espólio de um raide antes de qualquer imposto, custo de reparo, ou parte ser retirada.
Membro de guilda 🛡️	Um jogador no papel de Membro configurado. Membros de guilda são taxados e rastreados; suas partes alimentam o pool de membros.
Livro-razão	O registro corrente de todo crédito e débito no saldo de um membro — acertos, pagamentos, e ajustes manuais.
Pool de membros	A parte da prata de um acerto que é dividida entre os membros de guilda qualificados depois do reparo e cortes retirados antes de tudo.
Banco Mercador	Um fundo de guilda construído a partir do imposto de mercador — uma parte da fatia reparada de cada membro. Usado para despesas da guilda.
Líquido	O que um membro realmente recebe de um acerto — sua parte base depois de reparo e impostos serem aplicados.
Resultado	Um resultado de vitória/derrota (ou similar) registrado quando você acerta um raide. Não pode ser preenchido depois, então defina-o no acerto.
Pug / estranho ⚔️	Um jogador que não está no papel de Membro da guilda. Pugs não são taxados nem rastreados, e todo mundo conta como pug até que um papel de Membro seja definido.
Papéis de menção	Papéis selecionados do Discord oferecidos como chips de menção de um clique ao publicar um raide, para que as pessoas certas sejam notificadas. Configurável de 0 a 25.
Plano	O nível de recursos em que um servidor está (por exemplo, Gratuito ou Enterprise). Hoje ele só controla os recursos de marca própria.
Preset	Uma configuração de raide salva que você pode reutilizar para convocar raides parecidos rapidamente sem reinserir cada campo.
Avaliações	Feedback opcional por raide que se acumula em uma avaliação para os membros. Cada membro escolhe se a sua é pública.
Regear	Um reembolso por equipamento perdido em conteúdo. Um membro registra um pedido com o valor e capturas de tela; um oficial o revisa. Itens podem ser uma morte (um loadout inteiro perdido) ou um OC (uma perda fora do cooldown / parcial), e cada um precisa de um número mínimo de capturas (screenshots).
Banco Regear	Um fundo de guilda construído a partir do imposto de regear; também absorve restos de arredondamento. Nota: aprovar um regear credita o saldo do membro — isso não reduz o banco regear.
Reparo	O custo de reparar equipamento para um raide, inserido no acerto e retirado do pool de membros antes das partes serem divididas.
Chamada	Uma checagem de presença vinculada ao canal de voz de reunião de um raide, usada para confirmar quem realmente apareceu.
Escalação por especificação de papel	A abreviação para definir um papel de comp: [Category > ]Name[:slots[:emoji]] — uma categoria opcional, um nome, uma contagem de vagas opcional, e um emoji opcional. Uma linha começando com # abre um novo subgrupo.
Pool / temporada	Um período durante o qual raides em modo pool acumulam sua prata líquida em um pote compartilhado e marcam pontos de presença. No fim da temporada o pote é dividido pelos pontos — isso é irreversível.
Modo de acerto	Quando um raide paga: imediato (divide agora) ou pool (líquido alimenta o pote da temporada, dividido depois). Independente do modo de imposto — veja Modo de imposto.
Prata	A moeda do jogo de Albion Online. O Guild Butler rastreia saldos de prata só no Discord; ele nunca move prata dentro do jogo.
Subgrupo	Um grupo rotulado de vagas de papéis dentro de uma comp — Grupo 1, Grupo 2, e assim por diante — usado para organizar comps grandes em grupos legíveis. Você abre um com uma linha de cabeçalho # na caixa de papéis. Dividir uma comp em subgrupos não afeta o acerto de espólio.
Modo de imposto	Quem um raide taxa e rastreia: por papel (só membros de guilda, o padrão), todo mundo (cada participante), ou ninguém (divisão igual sem imposto). Definido por servidor e por tipo de conteúdo, registrado em cada raide. O construtor mostra como Taxado / Sem imposto.
Impostos	Porcentagens retiradas das partes reparadas dos membros para os bancos da guilda: o imposto de mercador alimenta o banco Mercador, o imposto de regear alimenta o banco Regear. Cada um tem padrão de 10%.
Template / comp	Uma escalação salva de papéis (uma composição) para um raide. Templates podem ser Públicos (de toda a guilda) ou Pessoais (seus), e são tipicamente marcados como PvP ou PvE.
Marca própria	Apresentar o bot sob o nome e avatar da sua própria guilda. Um apelido simples funciona no bot compartilhado; uma configuração dedicada roda um bot com sua própria identidade global (a equipe configura isso para você).
ZvZ / CTA	Conteúdo de Albion em larga escala. ZvZ (zerg-vs-zerg) é uma grande batalha em mundo aberto; CTA (call to arms, convocação às armas) é um evento de comparecimento obrigatório.