🧱 Sintaxe Básica

Cada linha da GratianLang representa um comando com seus respectivos parâmetros. A estrutura geral é:

.comando[param1;param2;param3]

Exemplo:

.titulo[Seja bem-vindo!]

Todos os comandos começam com um ponto (.) e os parâmetros são separados por ponto e vírgula ;.


🧠 Como a linguagem executa comandos

A GratianLang interpreta o script linha por linha, de cima para baixo. Alguns comandos, como .if[] e .loop[], controlam o fluxo e permitem desvios e repetições.

Você pode combinar comandos que executam ações (como enviar uma mensagem) com comandos que retornam valores (como .uuid[] ou .usuario[]).


🔁 Uso de Variáveis

Você pode definir variáveis temporárias durante a execução com:

.definir[nome;valor]

Para utilizar uma variável, basta usar ${nome} em qualquer lugar de um parâmetro:

.definir[nome;Luiz]
.descricao[Olá, ${nome}!]

Isso irá resultar em:

Olá, Luiz!

🧩 Interpolação dentro de argumentos

A GratianLang suporta interpolação dinâmica dentro de argumentos de comandos. Isso significa que você pode fazer:

.descricao[Seu ID é ${usuarioID} e seu UUID é ${uuid}]

E esses valores serão substituídos automaticamente.


📦 Escopo e persistência

Atualmente, as variáveis existem apenas durante a execução do script atual. Cada execução é isolada. No futuro, poderá existir suporte a persistência em arquivos ou banco de dados.


✅ Tipos de comandos

  • Comandos de ação: executam algo, como .novaEmbed[], .mensagem[], .esperar[].
  • Comandos de valor: retornam algo, como .uuid[], .usuario[], .random[].

Você pode usar comandos de valor dentro de outros comandos, graças à interpolação ${}.