Skip to content

Scripting language for building Discord bots - built on top of discord.jar

Notifications You must be signed in to change notification settings

discord-jar/Discript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Discript

Discript is a work-in-progress proof of concept scripting language for the Discord API. Similar to discord.jar, the library it's built on, Discript is being built as a proof-of-concept and as just a fun hobby project to do - it's not production ready and won't necessarily make it there.

Files

All Discript files end with the file ending .discript.

Syntax

During Discript's development, you'll be able to fiind essentially the entire syntax inside the test.dscript file. It uses a similar style to Python for code blocks, so indentation is necessary (by 1 tab, not spaces!), and most primitives will be defined in a relativly similar way, such as "string" or 123. At the top of each script, there's a "@login with " statement - which defines the Discord bot token. You can either provide a string straight in the file, or use an environment variable with: env:ENV_VARIABLE_NAME. Event listeners are defined using on EVENT_TYPE_HERE as eventVariableNameHere:, with the codeblock following as an indented section.

In-built functions

  • `log("log message here")` - prints to the standard output
  • `str(NON-STRING-HERE)` - converts anything to a string

Event names
A full list of event names can be found on Discord's developer documentation: https://discord.com/developers/docs/topics/gateway-events#event-names

When defining an event listener with something like on MESSAGE_CREATE as event, the event variable, in this case event, is an object with the same structure as the raw JSON provided by Discord. For example, if you wanted to then print the author of a message's username, you'd write: log(event.author.username)

Compatibility

Discript supports all events that discord.jar does (keep in mind, that's not all of them currently), but will support things like specfiic variables of an event DESPITE if it's implemented in discord.jar or not.

Releases

No releases published

Packages

No packages published

Languages