DiSky

Modrinth

The best Skript add-on for Discord management! Slash commands, interaction, components, modal, and much more are available!

34.5K downloads44 followersUpdated 6d ago

4.29.0 · MC 26.1.2 · Paper

View on Modrinth

Files

5.0.0-b1
beta
DiSky 5.0.0-b1
26.326.226.1.226.1.1+8paperpurpur
2026-10-26 · 102 downloads
DiSky-5.0.0-b1.jar · 22 MB
4.29.0
release
DiSky 4.29.0
26.1.226.1.126.11.21.11+11paper
2026-05-24 · 2.9K downloads
DiSky 4.29.0.jar · 23 MB
4.28.0
release
Role colors, checkboxes/radios, file uploads in modals and more!
26.1.226.1.126.11.21.11+18paperpurpurspigot
2026-04-20 · 1.2K downloads
DiSky 4.28.0.jar · 16 MB
4.27.0
release
Support for Skript 2.14, new features, hotfixes, and more!
1.21.111.21.101.21.91.21.8+10paperpurpurspigot
2026-02-01 · 1.7K downloads
DiSky 4.27.0.jar · 16 MB
4.26.0
release
QoL Update & Embed Enhancements
1.21.101.21.91.21.81.21.7+14paperspigot
2025-10-19 · 2.2K downloads
DiSky 4.26.0.jar · 18 MB
4.25.0
release
Components V2 with modals are here!
1.21.81.21.71.21.61.21.5+12paperspigot
2025-09-16 · 882 downloads
DiSky 4.25.0.jar · 18 MB
4.24.0-beta3
release
Bugfixes & new retrieve pinned message effect!
1.21.81.21.71.21.61.21.5+12paperspigot
2025-08-12 · 953 downloads
DiSky 4.24.0-beta3.jar · 18 MB
4.24.0-beta2
release
Message/User Commands now finally work!
1.21.81.21.71.21.61.21.5+12paperspigot
2025-07-31 · 428 downloads
DiSky 4.24.0-beta2.jar · 18 MB
4.24.0-beta1
release
Components V2 is here!
1.21.81.21.71.21.61.21.5+12paperspigot
2025-07-24 · 283 downloads
DiSky 4.24.0-beta1.jar · 18 MB
4.23.0
release
New event system, stickers & emojis events, and more!
1.21.51.21.41.21.31.21.2+9paperspigot
2025-05-14 · 1.9K downloads
DiSky 4.23.0.jar · 15 MB
4.23.0-alpha3
alpha
DiSky 4.23.0-alpha3
1.21.51.21.41.21.31.21.2+14bukkitpaperspigot
2025-04-09 · 693 downloads
DiSky 4.23.0-alpha3.jar · 15 MB
4.23.0-alpha2
alpha
DiSky 4.23.0-alpha2
1.21.51.21.41.21.31.21.2+9paperspigot
2025-03-29 · 249 downloads
DiSky 4.23.0-alpha2.jar · 15 MB
4.23.0-alpha1
alpha
The event-rework update is here!
1.21.51.21.41.21.31.21.2+9paperspigot
2025-03-28 · 101 downloads
DiSky 4.23.0-alpha1.jar · 15 MB
4.22.1
release
Command Registration & Message Handling
1.21.41.21.31.21.21.21.1+13paperspigot
2025-03-09 · 1.3K downloads
DiSky 4.22.1.jar · 15 MB
4.22.0
release
DiSky 4.22.0
1.21.41.21.31.21.21.21.1+13paperspigot
2025-02-23 · 486 downloads
DiSky 4.22.0.jar · 15 MB
4.21.1
release
The quickest update ever?
1.21.41.21.31.21.21.21.1+13paperspigot
2025-01-18 · 1.1K downloads
DiSky 4.21.1.jar · 15 MB
4.21.0
release
The biggest update yet?
1.21.41.21.31.21.21.21.1+13paperspigot
2025-01-18 · 153 downloads
DiSky 4.21.0.jar · 15 MB
4.20.2
release
The Improvement Update
1.21.41.21.31.21.21.21.1+35bukkitpaperspigot
2024-12-20 · 1.1K downloads
DiSky 4.20.2.jar · 15 MB
4.20.1
release
Hotfix: delayed bot initialization
1.13.21.13.11.13bukkitpaperspigot
2024-10-14 · 329 downloads
DiSky 4.20.1.jar · 15 MB
4.20.0
release
The Async Acceleration Update
1.21.11.211.20.61.20.5+32bukkitpaperspigot
2024-10-13 · 674 downloads
DiSky 4.20.0.jar · 15 MB
4.19.0
release
Listen once section, bugfixes and more!
1.21.11.211.20.61.20.5+21paperspigot
2024-09-04 · 430 downloads
DiSky 4.19.0.jar · 15 MB
4.18.0
release
The 'long time no see' update
1.211.20.61.20.51.20.4+28bukkitpaperpurpurspigot
2024-08-03 · 663 downloads
DiSky 4.18.0.jar · 15 MB
4.17.2
release
The "Mixed Additions" update!
1.20.61.20.51.20.41.20.3+27paperspigot
2024-05-17 · 869 downloads
DiSky 4.17.2.jar · 14 MB
4.17.1
release
Hot & bug fixes Latest
1.20.61.20.51.20.41.20.3+30paperspigot
2024-05-14 · 202 downloads
DiSky.4.17.1.jar · 14 MB
4.17.0
release
Slash Structure, QoL enchantements and bug fixes!
1.20.61.20.51.20.41.20.3+27paperspigot
2024-05-12 · 171 downloads
DiSky 4.17.0.jar · 14 MB
4.16.0
release
Bugfixes & New Features!
1.20.61.20.51.20.41.20.3+27paperspigot
2024-05-03 · 225 downloads
DiSky 4.16.0.jar · 14 MB
4.15.1
release
Bugfixes & QoL Enhancements
1.20.51.20.41.20.31.20.2+26paperspigot
2024-04-29 · 158 downloads
DiSky 4.15.1.jar · 14 MB
4.15.0
release
DiSky 4.15.0
1.20.51.20.41.20.31.20.2+26paperspigot
2024-04-28 · 176 downloads
DiSky 4.15.0.jar · 14 MB
4.14.3
release
Oh my god, too much update?!
1.20.41.20.31.20.21.20.1+11paperspigot
2024-04-22 · 195 downloads
DiSky 4.14.3.jar · 14 MB
4.14.2
release
And yet another update!
1.20.41.20.31.20.21.20.1+20paperspigot
2024-04-21 · 129 downloads
DiSky 4.14.2.jar · 14 MB
4.14.1
release
Better polls and optimizations
1.20.41.20.31.20.21.20.1+25paperspigot
2024-04-20 · 135 downloads
DiSky 4.14.1.jar · 14 MB
4.14.0
release
The "Asynchronous" Update
1.20.41.20.31.20.21.20.1+31paperspigot
2024-04-18 · 247 downloads
DiSky 4.14.0.jar · 14 MB
4.12.2-beta1
beta
DiSky 4.12.2-beta1
1.13.21.13.11.13spigot
2024-01-08 · 675 downloads
DiSky 4.12.2-beta1.jar · 18 MB
4.12.2-beta1
beta
DiSky 4.12.2-beta1
1.13.21.13.11.13paper
2024-01-08 · 203 downloads
DiSky 4.12.2-beta1.jar · 18 MB
4.12.1
release
The cleanup update!
1.13.21.13.11.13paperpurpurspigot
2023-08-26 · 4.8K downloads
DiSky 4.12.1.jar · 18 MB
4.12.0
release
The 'I don't have any title' update is here!
1.20.41.20.31.20.21.20.1+52foliapaperpurpur
2023-08-11 · 2.4K downloads
DiSky 4.12.0.jar · 18 MB
4.12.0-beta2
beta
Voice message & member flags supports!
1.13paperspigot
2023-05-27 · 167 downloads
DiSky 4.12.0-beta2.jar · 17 MB
4.11.1
release
Bug fixes & enhancements
1.19.4paperspigot
2023-04-08 · 1.2K downloads
DiSky 4.11.1.jar · 17 MB
4.11.0
release
DiSky 4.11.0
1.19.3paperspigot
2023-03-11 · 362 downloads
DiSky 4.11.0.jar · 17 MB
4.10.0
release
DiSky v4.10.0
1.19.3paperspigot
2023-02-17 · 220 downloads
DiSky 4.10.0.jar · 14 MB
4.9.0
release
DiSky v4.9.0 - Audio updates & default expressions.
1.19.31.13bukkit
2023-01-18 · 373 downloads
DiSky 4.9.0.jar · 14 MB
4.8.0
release
Scheduled events, bugfixes and much more!
1.19.3paperspigot
2022-12-10 · 1.5K downloads
DiSky 4.8.0.jar · 14 MB
4.7.0
release
Conflicts & Bug fixes + Member Thread Management
1.19.21.19.11.191.18.2+21paperpurpurspigot
2022-11-19 · 329 downloads
DiSky 4.7.0.jar · 14 MB

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

Gallery

About

DiSky

DiSky is a Skript addon for writing Discord bots in Skript, on your Minecraft server. It is built on JDA: anything a JDA bot can do, DiSky aims to expose as Skript syntax.

This branch is DiSky 5, a rewrite of DiSky 4. It is in public beta: most of DiSky 4 is covered, the syntax is close but not identical, and V4 scripts need a few changes (see the migration guide).

Syntax reference: atlas.disky.me
Porting DiSky 4 scripts: migration guide
Download: Modrinth
Bugs and requests: GitHub issues

Requirements

A Paper server, 1.21.5 or newer (or a Paper fork such as Purpur)
Java 21 or newer
Skript 2.16.1 or newer, with use type properties: true in its config.sk (the default)
A bot token from the Discord Developer Portal

Installation

Put DiSky-<version>.jar in your server's plugins/ folder, next to Skript.
Restart the server.

DiSky has no config file. At each boot it writes plugins/DiSky/disky-syntax.json, a list of every syntax it registered; you don't need to touch it.

Anonymous statistics (FastStats)

DiSky reports anonymous usage statistics and errors to FastStats. Nothing is sent during the first start: submission begins after the next restart, so you can opt out beforehand.

What is sent:

Usage: a random server id (regenerated if you delete it), the DiSky version, the Minecraft version, the server software and its version, online mode, the player count, the Java vendor and version, the OS name, version and architecture, and the CPU core count.
Errors: errors raised by DiSky syntaxes at runtime (the exception type, its message truncated to 500 characters and a shortened stack trace).

No IP address, player data, bot token, Discord content or script source is collected.

To opt out, edit plugins/faststats/config.properties (shared by every plugin that uses FastStats) and restart:

enabled=false turns FastStats off entirely;
submitMetrics=false stops usage statistics only;
submitErrors=false stops error reports only.

The JVM flag -Dfaststats.enabled=false also turns it off.

A first bot

Save this as plugins/Skript/scripts/bot.sk, put your token in it, and run /sk reload bot:

options:
    token: "YOUR-BOT-TOKEN"

on load:
    set {_bot} to a new discord bot
    set token of {_bot} to {@token}
    login {_bot} as "my-bot"

on unload:
    shutdown the bot named "my-bot"

# Slash commands are declared in the script, then sent to Discord explicitly.
on guild ready:
    update the discord commands (all structured application commands) in event-guild

slash command ping:
    description: Check that the bot is alive
    trigger:
        reply with hidden "Pong!"

slash command ban <target: member> [<reason: string>]:
    description: Ban a member
    enabled for: ban members
    trigger:
        try:
            ban {_target} because of {_reason}
        catch {_errors::*} and stop:
            reply with hidden "Could not ban %{_target}%: %error meaning of {_errors::1}%"
        reply with hidden "%{_target}% was banned."

on message received seen by "my-bot":
    discord content of event-message is "!about"
    set {_e} to a new discord embed
    set title of {_e} to name of event-guild
    set description of {_e} to "%member count of event-guild% members"
    set color of {_e} to orange
    reply with {_e}

hidden makes a reply visible only to the user who ran the command. If the ban fails (missing permission, member above the bot), the catch block gets a readable error instead of a stack trace in the console.

What you can do

Bots: several bots at once, intents, cache settings, sharding, presence.
Messages: send, reply, edit, delete, pin, react, read history; embeds, file uploads and downloads, polls.
Commands: slash commands with typed options, autocomplete, subcommands, cooldowns and translations; user and message (right-click) commands; classic text commands with a prefix.
Components: buttons, select menus, modals, and the newer layout components (containers, sections, galleries).
Server management: members, roles and their order, channels and threads, permissions and channel overrides, emotes and stickers, invites, scheduled events, welcome screen, AutoMod rules, webhooks.
Moderation: ban, kick, timeout, purge, audit log reasons.
Events: about 130 Discord events, from messages and reactions to voice, roles and AutoMod.

The Atlas lists every syntax with its patterns and examples.

Three things that differ from plain Skript

Talking to Discord takes time. Anything that sends something to Discord (posting a message, banning a member) runs off the server thread, so your server never lags waiting for Discord. Values DiSky has in memory are read directly; values it has to ask Discord for are read with await, which waits for the answer:

await set {_bans::*} to bans of event-guild

Reading such a value without await is an error when the script loads, not a silent <none>.

Builders. To create something on Discord (a role, a channel, a message with several parts), you fill a builder first, then send it:

set {_b} to a new role builder named "Helpers" in event-guild
set color of {_b} to light blue
await set {_role} to the build result of {_b}

Errors. A failed Discord action prints a readable message to the console. Put it in a try block to handle it yourself, as in the ban command above, or listen to on discord error to catch the ones no try handled.

Coming from DiSky 4

DiSky 5 replaces DiSky 4: same plugin name, same Modrinth page, and addons that depend on DiSky keep working by name. V4 scripts do not run as-is.

Read the migration guide on the Atlas before switching a bot over. It gives the order to port a script in, before/after examples for every change (retrieve becoming await, builders, the discord prefix, commands, components, events), and the list of what DiSky 5 does not have yet.

Building from source

./gradlew build

Needs JDK 21. The plugin is build/libs/DiSky-<version>.jar (the -thin jar next to it does not contain JDA and will not load).

License

Apache License 2.0

DiSky

Files

5.0.0-b1

4.29.0

4.28.0

4.27.0

4.26.0

4.25.0

4.24.0-beta3

4.24.0-beta2

4.24.0-beta1

4.23.0

4.23.0-alpha3

4.23.0-alpha2

4.23.0-alpha1

4.22.1

4.22.0

4.21.1

4.21.0

4.20.2

4.20.1

4.20.0

4.19.0

4.18.0

4.17.2

4.17.1

4.17.0

4.16.0

4.15.1

4.15.0

4.14.3

4.14.2

4.14.1

4.14.0

4.12.2-beta1

4.12.2-beta1

4.12.1

4.12.0

4.12.0-beta2

4.11.1

4.11.0

4.10.0

4.9.0

4.8.0

4.7.0

Gallery

About

DiSky

Requirements

Installation

Anonymous statistics (FastStats)

A first bot

What you can do

Three things that differ from plain Skript

Coming from DiSky 4

Building from source

License