This is the concise normative reference for the implemented language. The parser in src/parser/ remains authoritative when syntax and prose disagree.
A program is a sequence of statements. Blocks use { and }; statements may be separated by newlines or semicolons; control-flow bodies are blocks.
name = "discript"
if (name == "discript") {
print(name)
}
Values include null, booleans, numbers, strings, arrays, objects, functions, and normalized Discord results. Discord snowflake IDs are strings.
From lowest to highest precedence: ??; ||; &&; == and !=; <, <=, >, >=; + and -; *, /, and %; **; unary ! and -; then member access ., indexes [], and calls (). Indexes may contain any expression and can be used for arrays or computed object properties.
Compound assignments +=, -=, *=, /=, and %= update an existing variable, member, or index. ?? returns its right side only when the left side is null; an unknown identifier is still an error.
Conditional expressions use test ? consequent : alternate and evaluate only the selected branch. Optional access uses ?., ?.[index], and ?.(); it returns an absent value when the receiver or callable is null-like. Ordinary access through a null value raises a runtime error.
Array expressions support spread elements ([...items]), and object expressions support spread properties ({...defaults, mode: "safe"}). Spread creates a new value and does not mutate its source.
Destructuring assignments use array or object patterns on the left side. Rest patterns (...remaining) capture the remaining array values or object properties. Destructuring assigns into ordinary script variables and returns the original source value.
settings = {name: "general", position: 0}
names = ["rules", "welcome", "general"]
settings["name"] = names[0]
Assignment binds or updates a variable. Functions use fn name(parameters) { ... }; return exits with any value.
fn preview(name) {
return {name: name, dryRun: true}
}
print(preview("staging"))
if (condition) {
print("yes")
} else {
print("no")
}
for (item in items) {
print(item)
}
while (condition) {
// update condition inside the block
}
Discord methods return values that can be assigned and passed to later operations. Keep dependent operations in order. Event callbacks use on("eventName") { ... }; the current payload is available as event and keeps the process alive until shutdown or --timeout.
on("messageCreate") {
print({author: event.author, content: event.content})
}
guildId = env.TEST_GUILD
tokenMode = env.get("DISCRIPT_MODE")
env.set("DISCRIPT_LAST_RUN", "agent")
env.clear("DISCRIPT_LAST_RUN")
Built-ins include print(value), exit(code, message), env, args, defer callback, length, keys, values, range, now, race, allSettled, mapLimit, timeout, retry, language, capabilities, on, every, after, and the discord API root. Environment values are strings or absent/null-like values. Registration helpers return cancellable handles. language.version, language.supports(feature), and language.requireVersion(version) support runtime compatibility checks. See the standard library for helper contracts.
Mutating methods accept options where supported:
guild.channels.create("preview", {type: "text", dryRun: true})
guild.roles.create("Moderator", {force: true})
dryRun: true previews without changing Discord. force: true approves script-level guarded operations. Use exit(2, "message") for intentional invalid input; unexpected errors should propagate to the CLI so it can emit its stable code and process status.