Geral

Primeiros Passos

Conheça a Macchi e veja por onde começar.

Publicado por solever7 solever7
intro discord scripts eventos

Macchi é um bot para servidores que têm o próprio jeitinho de funcionar. Sabe quando o
servidor sempre repete a mesma piada, a mesma resposta, o mesmo aviso de boas-vindas ou
aquele “olha o canal tal primeiro”? A Macchi foi feita pra esse tipo de coisa.

Em vez de esperar uma configuração pronta encaixar exatamente na sua ideia, você pode
escrever um pequeno script Lua e fazer o bot responder com a cara do seu servidor. Esse
script pode ser um comando que alguém roda de propósito, ou pode rodar sozinho quando
alguma coisa acontece.

O bom é que você não precisa começar com algo enorme. Uma linha que responde “oi” já é
um script de verdade. Depois você troca as palavras, deixa mais pessoal, adiciona
botões, reage a uma menção ou transforma aquilo em uma ferramentinha que o servidor
realmente usa.

Para Que Serve Este Wiki

Este wiki é a parte mais tranquila da documentação. Ele explica a Macchi como você
explicaria para alguém no servidor: o que ela faz, por que scripts são úteis e qual
página abrir quando quiser aprender o próximo pedaço.

Se você quer escrever sua primeira resposta, comece por Seu Primeiro Script.
A página acompanha o ciclo completo de criação, edição e execução. Se você quer
entender coisas que rodam sozinhas, leia Eventos. Eventos são o jeito
da Macchi responder a menções, dar boas-vindas ou reagir a mensagens com prefixo sem
alguém chamar um comando manualmente.

Quando quiser conferir os nomes exatos disponíveis no Lua, a página API
Lua é a referência. A página de Downloads da API
Lua é mais para ajuda no editor e arquivos gerados.

Uma Primeira Ideia Pequena

Teste um comando que só responde a pessoa:

macchi.reply("Oi " .. ctx.user.username .. ", estou viva.")

Isso já ensina o ciclo principal: escrever algo pequeno, testar, trocar as palavras e
rodar de novo. Use /check codigo_fonte:macchi.reply('olá') para validar em privado
código Lua transitório, /novo com escopo explícito para criar um script salvo e /run
para executar uma referência tipada precisa.

Scripts publicados podem ser encontrados pela busca do Discord. Quando alguém
compartilhar uma referência pública, abra a revisão exata com:

/buscar script:u123/boas-vindas@1

Cada script publicado também pode receber Hypes pelo Discord. Um hype é um pequeno
impulso com estrela, e cada usuário pode dar um hype por dia no total.

Você também pode explorar scripts publicados em /library, abrir a referência tipada
canônica, conferir readme e código e copiar a mesma referência no Discord.

Comandos, Eventos e “Qual Eu Uso?”

Use comando quando alguém deve escolher rodar o script. Um comando customizado é bom
para links do servidor, uma resposta de FAQ, uma frase boba ou uma ajuda pequena que as
pessoas chamam quando precisam.

Use evento quando o bot deve reagir sozinho. Se alguém mencionar a Macchi, seu script
pessoal onMentionMacchi pode responder com um “olha o que eu faço”. Se qualquer
menção de usuário importar,
onMention pode observar esse caso mais amplo. Se alguém entrar, onMemberJoin pode
dar boas-vindas. Se alguém sair, onMemberLeave pode ajudar a registrar ou reagir ao
momento. Se alguém mandar uma mensagem com prefixo que não é um comando salvo,
onPrefixedMessage pode decidir o próximo passo.

onMentionMe e os outros eventos automáticos do servidor são Automação do servidor. Um
gerente configura um script ativo para cada evento concreto. Novos usuários recebem um
script pessoal hello editável com onMentionMacchi, executado somente quando o próprio
usuário menciona a Macchi.

Você não precisa decorar os nomes agora. Comece pela situação que quer melhorar. “Quero
que a pessoa digite algo e receba uma resposta” parece comando. “Quero que a Macchi
perceba algo acontecendo” parece evento.

Mapa Da Documentação

Referências usam u123/nome@0, g123/nome@1 ou c123/nome@2. Rascunhos usam a revisão
@0; revisões publicadas são imutáveis. Entradas são detalhes de execução e não aparecem
nas referências comuns.

E se tudo isso ainda parecer novo, tudo bem. Os melhores scripts da Macchi geralmente
começam com “eu só queria que o bot respondesse isso do meu jeito”.

Explorar com agentes
ChatGPT