Ao criar um bot do Discord com um comando de ajuda que lista muitos comandos, você pode ver um erro como Embed Field Limit Exceeded. Isso acontece porque o Discord impõe um limite estrito de 25 campos por embed. Se o seu comando de ajuda usa um campo por comando e você tem mais de 25 comandos, o bot não consegue enviar o embed. Este artigo explica por que o limite existe e como dividir seu comando de ajuda em vários embeds ou usar um sistema de paginação.
O erro é causado pelas restrições da API do Discord em objetos embed. Cada embed pode ter no máximo 25 campos, e cada campo tem um limite de 1024 caracteres para seu valor. Comandos de ajuda longos que listam dezenas de comandos frequentemente excedem o limite de 25 campos. A correção envolve reestruturar seu comando de ajuda para permanecer dentro desses limites, geralmente agrupando comandos em categorias ou adicionando navegação por páginas.
Vamos abordar a causa raiz técnica e depois mostrar três métodos para corrigir o erro: usar múltiplos embeds, adicionar paginação com botões e agrupar comandos em categorias. Também cobrimos erros comuns e uma comparação de cada abordagem.
Ao final, você saberá como reescrever o comando de ajuda do seu bot para que nunca mais atinja o limite de campos do embed.