Перейти к содержимому
Mineforgian

DiSky

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

Загрузки
31K
Подписчики
45
Обновлён
24 мая 2026 г.
Лицензия
Apache-2.0

Опубликован 19 ноября 2022 г.

DiSky: The Ultimate Discord Integration for Minecraft

DiSky is a powerful Skript addon that allows you to seamlessly integrate Discord functionality into your Minecraft server. With DiSky, you can create advanced Discord bots, manage servers, and enhance player interactions—all using the simple and intuitive Skript language.

Key Features

  • Easy Bot Creation: Set up and manage Discord bots with just a few lines of code.
  • Comprehensive Discord API Support: Access a wide range of Discord features, from sending messages to managing roles and channels.
  • Slash Commands: Create and handle Discord slash commands effortlessly.
  • Rich Embeds: Design beautiful, informative embeds for your Discord messages.
  • Event Handling: React to Discord events in real-time, bridging the gap between Minecraft and Discord.
  • Voice Channel Integration: Manage voice channels and even play audio.
  • Webhook Support: Use Discord webhooks for advanced message control and formatting.

Basic Examples

Creating a Discord Bot

define new bot named "MyBot":
    token: "YOUR_BOT_TOKEN"
    intents: default intents
    policy: all
    auto reconnect: true
    
    on ready:
        send "Bot is online!" to console

Sending a Message

discord command ping:
    prefixes: !
    trigger:
        reply with "Pong! Bot latency: %bot ping of event-bot% ms"

Creating an Embed

command /serverinfo:
    trigger:
        make embed:
            set title of embed to "Server Information"
            set description of embed to "Welcome to our Minecraft server!"
            set color of embed to green
            add field named "Online Players" with value "%number of all players%" to fields of embed
            set footer of embed to "Powered by DiSky"
        
        post last embed to channel with id "CHANNEL_ID"

Handling Discord Events

on message receive:
    if event-channel is channel with id "CHANNEL_ID":
        if message starts with "!players":
            reply with "There are %number of all players% players online!"

Why Choose DiSky?

  • User-Friendly: Leverage the simplicity of Skript to create complex Discord integrations.
  • Powerful: Access advanced Discord features without the need for traditional programming knowledge.
  • Flexible: Customize your Discord bot to fit your server's unique needs.
  • Actively Maintained: Regular updates ensure compatibility with the latest Discord features.
  • Community-Driven: Join a vibrant community of developers and get support when you need it.

DiSky empowers server owners and developers to create seamless connections between Minecraft and Discord, enhancing player engagement and server management capabilities. Whether you're looking to create a simple moderation bot or a complex cross-platform system, DiSky provides the tools you need to bring your vision to life.

Ready to revolutionize your server's Discord integration? Get started with DiSky today!

Requirements and Resources

System Requirements

  • Minecraft: 1.19+ (Latest version recommended)
  • Skript: 2.10.0+ (Latest version recommended)
  • Java: Java 16 or higher

Important Links

Ченджлог

4.29.0Релиз26.1, 26.1.1, 26.1.2 · 24 мая 2026 г.

Hi there! Back with a pretty packed update 🚀

Huge thanks to @P0wders who handled a bunch of the PRs in this release (slash command id, activity & primary guild events, and more)!

✨ New Features Scheduled Events Full support for Discord's scheduled events!

11 new events: create, delete, user subscribe/unsubscribe, plus name/description/location/start & end time/status/cover image updates. The status update is how you catch an event starting or ending. New scheduled event description and scheduled event jump url properties. ⚠️ Needs the SCHEDULED_EVENTS intent + cache flag (both off by default)!

🎮 Activities & Rich Presence Member Activities (activities of %member%): every current activity of a member (game, stream, custom status...). 10 new activity properties: details, state, large/small image url & hover text, party size/max size, start/end timestamp. New user activity start / user activity end events. ⚠️ Needs the GUILD_PRESENCES intent + the ACTIVITY cache flag!

🎨 More properties & conditions Member Colors (colors of %member%): the RoleColors of the member's highest non-default role. Invite Creation Date (expanded invites only!). User is Showing Server Tag condition. New user primary guild update event (past/new primary guild id & user tag). Added a slash command id expression in slash command events. 🗳️ Retrieve Poll Voters New retrieve poll voters effect: get who voted for a given poll answer (by position or pollanswer). Just pass the poll's message, the bot rebind is handled like retrieve message. 🎧 Audio: important DAVE update Discord enforces DAVE (E2EE for audio/video) since March 1st, 2026; without it, audio connections stop working. DiSky now wires it automatically.

⚠️ macOS isn't supported by DAVE (Linux & Windows only). If your bots use voice, updating is strongly recommended!

Improvements has role and the bot-in-thread condition now accept lists and proper negation (isn't, doesn't have...). discord id now works on pollanswer objects. Big documentation pass + cleaner generated docs (thread states now included). Full Changelog: 4.28.0...4.29.0

4.28.0Релиз26.1, 26.1.1, 26.1.2 · 20 апреля 2026 г.

Hi there! I'm finally back :rocket: It's been a while since the last update (February 1st, oof), and I'm slowly coming back to DiSky, which I still try to maintain in my (shrinking) free time. This release brings Skript 2.15 support, a major JDA v6 upgrade, brand new modal components, and a few quality-of-life improvements!

Thanks to @sovdeeth for the async optimizations and format fixes!

:sparkles: New Features

  • Checkbox & Radio components for Modals: You can now use new checkbox group and new radio group inside your modals, along with their associated new component option for dropdowns, checkboxes and radios.
  • Attachment Upload in Modals: Added the new attachment upload builder component and the received attachments expression to grab files uploaded through modals.
  • Role Color Properties: Added primary role color, secondary role color and tertiary role color properties, along with conditions to check a role's colors.
  • Retrieve Role Member Count: New retrieve role member count effect to fetch and store, in a list variable, the members assigned to a role.
  • Members with roles expression: Introduced a cleaner expression to retrieve members by roles — combining sync & async versions — that replaces the now-deprecated find members with roles.

:information_source: You can browse all the new syntax, along with patterns and examples, using the tag:new query on DiSky Syntax!

:hammer_pick: Improvements

  • Skript 2.15 support — DiSky is now compatible with the latest Skript release.
  • JDA updated to v6.4.1 — major dependency bump for better Discord API compatibility and access to newer features.
  • Enhanced the find member section with native return support.
  • Improved patterns and documentation for the modal component value expression and new component option builders.
  • Refactored DocBuilder to support modern Skript SyntaxInfo, improving documentation generation.
  • Switched to DiSky's internal registration system over Skript's default one for better consistency.
  • Minor performance optimizations on permission checks and array creation.

:bug: Bug Fixes

  • Fixed multi-threading and variable de-sync issues inside the find member section.
  • Prevented duplicated event values in the event system, with some cleanup around guild events.
  • Simplified and fixed boolean checks for the bot member is in thread condition and several property conditions.

:warning: Breaking Changes

  • Skript 2.15+ is now required — following the dependency update, DiSky v4.28 no longer supports Skript 2.14.
  • find members with roles is deprecated in favor of the new members with roles expression. Please update your scripts :slight_smile:

That's all for this one! The next update will likely bring soundboard sounds support, voice channel effects, and more bug fixes if anything pops up. Thanks a lot for your patience and continued support :blue_heart:

Full Changelog: https://github.com/DiSkyOrg/DiSky/compare/4.27.0...4.28.0

4.27.0Релиз1.21.9, 1.21.10, 1.21.11 · 1 февраля 2026 г.

This new version of DiSky mainly brings support for Skript 2.14 and upward, making any previous version of Skript NOT usable! From now on, DiSky will only support Skript 2.14+.

Thanks to @Fusezion & @EquipableMC as always for their help on a few things for this release!

✨ New Features

  • Added Member Can Interact With Member(s)/Role(s) condition
  • Added Thread Owner and Thread Message Count properties
  • Added User Tag Icon/Badge URL and User Tag properties

ℹ️ You can take a look at their syntax, along with examples and description using the new tag:new query in DiSky Syntax!

⚒️ Improvements

  • Upgraded to Skript 2.14+ compatibility - Complete refactoring to support the latest Skript API changes
  • JDA dependency updates - Updated to the latest JDA version for better Discord API compatibility and performance
  • Optimized expression parsing - Improved performance when handling complex Discord object expressions
  • Enhanced error handling - More descriptive error messages when syntax fails or Discord API calls encounter issues
  • Code cleanup and refactoring - Removed deprecated code and improved overall codebase maintainability
  • Better null safety checks - Added additional validation to prevent null pointer exceptions in edge cases
  • Improved documentation generation - Enhanced syntax documentation system for better searchability

🐛 Bug Fixes

  • Fixed issues with thread-related properties not being accessible in certain contexts
  • Resolved crashes when accessing member properties with invalid or missing permissions
  • Fixed embed field manipulation causing unexpected behavior in some scenarios
  • Corrected inconsistent behavior with permission checks across different guild contexts

⚠️ Breaking Changes

  • Skript 2.13 and below are no longer supported
  • Every modules MUST be updated! Please refer to this page to check which version of each module you need.

What's Changed

New Contributors

Full Changelog: https://github.com/DiSkyOrg/DiSky/compare/4.26.0...4.27.0

4.26.0Релиз1.21.8, 1.21.9, 1.21.10 · 19 октября 2025 г.

Hello there! Here comes DiSky v4.26.0 with some nice quality of life improvements and bug fixes! Thanks to @EquipableMC and @Fusezion for their help on some stuff!

:sparkles: New Features

  • Embed Fields as Expressions: Embed fields are now accessible and manipulable as expressions, giving you more flexibility when working with embeds. See here
  • Embed Templates: Brought back the embed template system from DiSky v3! You can now register and reuse embed templates for more efficient embed creation. You may also use them in data structures!
  • Member Boost Time Support: Added support for Member's boost time, allowing you to retrieve how long a member has been boosting the guild. See here
  • Better Variable String Support: This enables more intuitive variable storage for Discord objects (channels, messages, members, etc.). You can now use {blah::%{_member}%} instead of {blah::%discord id of {_member}%}.

:tools: Improvements

  • Enhanced Message Editing: The edit message effect now supports full or transient replacement modes, giving you better control over whether previously unedited content (like embeds) should be replaced or preserved. See here

:bug: Bug Fixes

  • Fixed global and guild slash commands creation/updating system that was broken due to command ID changes on server restart.

What's Changed

Full Changelog: https://github.com/DiSkyOrg/DiSky/compare/4.25.0...4.26.0

4.25.0Релиз1.21.6, 1.21.7, 1.21.8 · 16 сентября 2025 г.

Hi there! This is a rather small, yet useful update, that brings text display, labels, and select menus into modals! You may now mix those new components when opening modals, and gather the input easily!

[!CAUTION] Breaking Changes: DiSky v4.25.0 requires an update to the way you previously created text inputs for your modals. Refer to the new documentation page about modals for examples and more information.

I've also launched Projects! This will help me (and you!) keep track of what should/must be done until the next release. You may add your review anytime to any idea already inside the [DiSky v4 Project)(https://github.com/orgs/DiSkyOrg/projects/1)!

4.24.0-beta3Релиз1.21.6, 1.21.7, 1.21.8 · 12 августа 2025 г.

Hi there! I'm back from vacation :P Here's another small update that brings some bugfixes, QoL things, but mainly fixes attachments issue with file uploads!

  • Added retrieve pinned messages effect, with its new pinnedmessage class; it can be used as a normal message, but has one more property: pin date of %pinnedmessage%.
  • Enhanced new separator syntax: large/small is now optional; it'll default to large if none is specified.
  • post effect may now be given file uploads directly (so you may upload only files this way)
  • The inline message builder expression has been reworked to work with the new file upload system; you cannot give strings for its files anymore.

Every effect/expression that previously used attachments (= accepted strings or images, DiSky had to hint its source anyway) will now require a file upload instead, you'll have to create according to this doc page!

⚠️ You can find more info about it in the Migration page, from v4.23 (or older) to v4.24

4.24.0-beta2Релиз1.21.6, 1.21.7, 1.21.8 · 31 июля 2025 г.

This is a late night release, I know. This comes with a much needed release, and much needed features.

🎉 Message/User Commands now finally work!

Thanks to Sovde on the SkriptLang team, he has helped me fix the issue with message commands/user commands, so they should properly enable and register now! Check the docs for more information!

🤫 Suppress Link Embeds!

You can now suppress (or hide) link embeds from either a bot or a certain user! If its in dms, you can only suppress link embeds from the bot in the dms, not the user. Documentation for this will come tomorrow as I need much needed sleep. Right now, the syntax is the following: (suppress|hide) [the] [discord] [link] embed[s] [message] (of|from) [the] [discord] [message] %message% () means its required, and [] means its optional, and %message% is obviously required to specify the exact message.

❓ Why beta?

Now I know you all are going to be asking this, so I am going to explain while taking snippets from JDA's (Java Discord API's) message. We are in beta considering this a huge new update with a heck ton new features for you all to mess around with and also find anymore bugs/issues that may arise. Now for the 2nd part. JDA (Java Discord API) is what we use to make DiSky work, and with that comes it's own issues. As from JDA, "For now, this [6.0.0-rc.1] is just a release candidate, since we might want to do some more breaking changes before the stable release of 6.0.0." This is obviously a beta build of JDA which can lead to even more issues. the next release candidate might include more breaking changes, potentially with components or other parts of JDA." This is why this is a beta.

⚠️ Known Issues

We are aware attachments aren't in the best of shape right now, I am waiting on Sky to get back to investigate further. Resources site is down. We are aware. Sky is not home so there is not much we can do. Sorry.

4.24.0-beta1Релиз1.21.6, 1.21.7, 1.21.8 · 24 июля 2025 г.

It's been awhile since the last update! This is finally announcing the release of DiSky 4.24.0-beta1. I will try to keep this short and sweet and explain why this is in beta, so please take some time to read this as this is extremely important.

🎉 Components V2/Containers Update!

Yes, you heard it here, DiSky now supports the new Components v2/Containers. Discord has introduced a completely new component system (which is not compatible with the old one!) meant to replace embeds and components within messages. It allows you to create customizable layouts with sections, galleries, files, and much more, all within one component called a "Container". You can find the documentation for containers here, although this is a beta and you should expect bugs. We have actively tested with our @👑 - Platinum members and have hopefully ironed out most bugs/problems!

🛠 File Upload enhancements

We have made some changes as to how File Uploading is now handled, so this should hopefully be better now!

❓ Why beta?

Now I know you all are going to be asking this, so I am going to explain while taking snippets from JDA's (Java Discord API's) message. We are in beta considering this a huge new update with a heck ton new features for you all to mess around with and also find anymore bugs/issues that may arise. Now for the 2nd part. JDA (Java Discord API) is what we use to make DiSky work, and with that comes it's own issues. As from JDA, "For now, this [6.0.0-rc.1] is just a release candidate, since we might want to do some more breaking changes before the stable release of 6.0.0." This is obviously a beta build of JDA which can lead to even more issues. the next release candidate might include more breaking changes, potentially with components or other parts of JDA." This is why this is a beta.

We hope you enjoy this update, and thank you for using DiSky! ❤

Комментарии

Загружаем…