BASE DO CORE / PRIMEIROS PASSOS

Começando com o Core

Entenda o papel do runtime, a estrutura do Template Bot e o caminho percorrido até o primeiro comando responder.

@ninenity/coreTypeScriptDiscord.js

O modelo mental#

O Core não substitui o Discord.js. Ele organiza o ciclo de vida ao redor dele.

Você declara

Cada arquivo registra um comando, evento, task ou interação no Client.

O Core carrega

O auto-loader percorre settings.baseDir, importa os módulos e valida os registros.

O runtime executa

Cooldown, fila, contexto de guild e respostas são preparados antes do seu execute.

Estrutura do Template Bot#

A estrutura já separa código carregado automaticamente de helpers importados explicitamente.

1src/2├─ Bot.ts                         # ponto de entrada3├─ Discord/4│  ├─ Commands/                  # slash, prefixo e menus de contexto5│  ├─ Events/                    # eventos do Discord.js6│  ├─ Interactions/              # modais, callbacks, prompts e paginações7│  └─ Tasks/                     # rotinas periódicas8├─ Shared/9│  ├─ Settings/Client.ts         # LibsClient, token e intents10│  ├─ Settings/Database.ts       # plugin opcional de banco11│  ├─ Emojis/                    # emojis do aplicativo12│  └─ Translate/                 # idiomas13└─ Utils/                        # regras e helpers importados por módulos

Pasta	Carregamento	Use para
`Discord/Commands`	Automático	Comandos slash, prefixados e menus de contexto
`Discord/Events`	Automático	Eventos emitidos pelo Discord.js
`Discord/Interactions`	Automático	Modais, prompts, paginações e callbacks registrados
`Discord/Tasks`	Automático	Rotinas globais ou executadas por servidor
`Shared` e `Utils`	Explícito	Configuração, serviços e regras reutilizáveis

Configure o Client#

O LibsClient estende o cliente do Discord.js e adiciona os registradores do ecossistema.

1import {2  GatewayIntentBits,3  LibsClient,4  type AppConfig5} from '@ninenity/core'67const Client = new LibsClient<AppConfig>({8  intents: [9    GatewayIntentBits.Guilds,10    GatewayIntentBits.GuildMessages,11    GatewayIntentBits.MessageContent,12    GatewayIntentBits.GuildMembers13  ],14  token: process.env.BOT_TOKEN || process.env.DISCORD_TOKEN,15  config: {}16})1718export default Client

Intent	Necessário quando
`Guilds`	Quase sempre: slash commands, canais, cargos e configuração por servidor
`GuildMessages`	O bot observa mensagens ou usa comandos prefixados
`MessageContent`	O conteúdo textual das mensagens precisa ser lido
`GuildMembers`	Entradas, saídas, cargos ou dados completos de membros são usados

Inicialize o runtime#

Ninenity.init() prepara plugins e auto-loader antes de Client.login() abrir a conexão com o Discord.

1import 'dotenv/config'2import { Ninenity } from '@ninenity/core'3import Client from './Shared/Settings/Client'4import { databasePlugin } from './Shared/Settings/Database'56Ninenity.init({7  bots: [Client],8  plugins: databasePlugin ? { database: databasePlugin } : undefined,9  settings: { baseDir: __dirname }10})1112Client.login()

1
Variáveis são carregadas
O import de dotenv/config disponibiliza o token e integrações antes de criar o Client.
2
O runtime recebe os bots
bots aceita mais de um Client, mas cada bot mantém seus próprios registradores e timers.
3
Módulos são encontrados
baseDir aponta para src em desenvolvimento e para dist após o build.
4
O login começa
Depois dos registros, Client.login() conecta e conclui as etapas de bootstrap.

Crie o primeiro módulo#

O arquivo só precisa importar o Client compartilhado e fazer seu registro no escopo do módulo.

1import {2  SlashCommandBuilder,3  type SlashInputCommandInteraction4} from '@ninenity/core'5import Client from '../../Shared/Settings/Client'67Client.slash({8  data: new SlashCommandBuilder()9    .setName('ping')10    .setDescription('Mostra a latência atual.'),11  cooldown: '3s',12  execute: async (interaction: SlashInputCommandInteraction) => {13    await interaction.reply('Pong!')14  }15})

Você não importa Ping.ts em Bot.ts. O auto-loader encontra o arquivo, executa o módulo uma vez e o Client.slash() guarda a definição para deploy e execução.

Variáveis de ambiente#

Comece com o mínimo e adicione integrações somente quando forem usadas.

1BOT_TOKEN=seu_token_do_discord23# Opcionais: integração com API e HUB4API_KEY=5API_SECRET=67# Opcional: banco de dados8DATABASE_URL=

Nunca envie .env para o Git; mantenha apenas um .env.example sem secrets.
Use um token de bot, não o client secret da aplicação.
A ausência de API_KEY e API_SECRET desativa a hidratação remota, mas não impede o bot de conectar ao Discord.
Mantenha src e dist com a mesma árvore para o auto-loader funcionar após o build.