NINENITYECOSYSTEM
Acesso rápidoComeçando com o CoreBase do Core↵O modelo mentalComeçando com o Core↵Estrutura do Template BotComeçando com o Core↵Configure o ClientComeçando com o Core↵Inicialize o runtimeComeçando com o Core↵Crie o primeiro móduloComeçando com o Core↵Variáveis de ambienteComeçando com o Core↵ComandosBase do Core↵
Documentação/Operação
OPERAÇÃO / CONFIGURAÇÃO

Configuração

Leia variáveis, canais e cargos globais ou específicos de cada guild sem espalhar IDs pelo código.

appConfigChannelsRolesHUB

De onde vem a configuração#

O Client começa com defaults locais e pode ser hidratado pela API quando as credenciais estão presentes.

  1. 1
    Defaults locais

    O objeto config passado ao LibsClient garante valores básicos mesmo sem API.

  2. 2
    Hidratação

    Com API_KEY e API_SECRET, o Core solicita a configuração persistida do bot.

  3. 3
    Resolução por guild

    appConfig(guildId?) mescla a base global com a entrada em guilds[guildId].

  4. 4
    Contexto automático

    Em comandos, eventos, callbacks e tasks por guild, o ID atual é resolvido pelo runtime.

Estrutura persistida#

A configuração base e as sobrescritas de cada guild seguem o mesmo formato.

JSONexemplo conceitual de AppConfig
{  "channels": {    "support": "123456789012345678"  },  "roles": {    "staff": "223456789012345678"  },  "variables": {    "general": {      "prefix": { "type": "string", "value": "!" },      "maxTickets": { "type": "number", "value": 3 },      "features": { "type": "list", "value": ["tickets", "logs"] }    }  },  "guilds": {    "323456789012345678": {      "channels": { "support": "423456789012345678" },      "variables": {        "general": {          "prefix": { "type": "string", "value": "?" }        }      }    }  }}
TipoValor resolvido
stringTexto
numberNúmero, sem conversão para string
objectObjeto JSON de chave e valor
listArray JSON ordenado

Ler variáveis no contexto atual#

O runtime remove os wrappers type/value; sua lógica recebe os valores puros.

TSconfiguração dentro de comando
Client.slash({  data: new SlashCommandBuilder()    .setName('settings')    .setDescription('Mostra as configurações atuais.'),  execute: async interaction => {    const config = Client.appConfig()    const general = config.variables?.general ?? {}    await interaction.reply({      content: [        'Prefixo: ' + (general.prefix ?? '!'),        'Máximo de tickets: ' + (general.maxTickets ?? 1),        'Recursos: ' + (general.features ?? []).join(', ')      ].join(''),      flags: 64    })  }})
TSfora de uma interação
async function refreshGuild(guildId: string) {  const config = Client.appConfig(guildId)  const enabled = config.variables?.automation?.enabled ?? false  if (!enabled) return  await synchronizeGuild(guildId, config)}

Aliases de canais e cargos#

Aliases tornam o código legível e permitem trocar IDs no HUB sem editar o bot.

TSuso de aliases
const channels = Client.getAppChannels()const roles = Client.getAppRoles()const supportChannel = channels.supportconst staffRole = roles.staffif (supportChannel) {  console.log(    '[Config] support=' + supportChannel.Name +    ' id=' + supportChannel.Id  )}await interaction.reply({  content: [    'Suporte: ' + (supportChannel?.Mention ?? 'não configurado'),    'Equipe: ' + (staffRole?.Mention ?? 'não configurado')  ].join(''),  flags: 64})
CampoCanalCargo
IDIdId
NomeNameName
MençãoMention / toString()Mention / toString()
MetadadoTypeColor e Position

Defaults locais#

Defaults permitem desenvolver sem depender da API e documentam o formato esperado.

TSShared/Settings/Client.ts
const Client = new LibsClient<AppConfig>({  intents: [GatewayIntentBits.Guilds],  token: process.env.BOT_TOKEN,  config: {    channels: {},    roles: {},    variables: {      general: {        prefix: { type: 'string', value: '!' },        maxTickets: { type: 'number', value: 1 },        features: { type: 'list', value: [] }      }    }  }})