Compatibility
Minecraft: Java Edition
Platforms
Supported environments
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Changelog
Due to the sunsetting of Javacord, this mod migrated to JDA, which meant that introducing breaking changes was inevitable, so I chose to use this update to add more improvements that introduce breaking changes.
The naming convention of "parsables" in the documentation and changelogs have changed. These map values used as function parameters are now referred to as "schemas" or "objects". A "schema" is the format of the fields a parsable has, while an "object" will be referred to as a map value following that schema.
Breaking changes
The following changes may break existing scripts. Make sure to update them to work with this new discarpet version.
Event changes
Due to JDA having no built-in message caching, the following events were changed:
- The
__on_discord_message_edit
event now no longer provides the previous message and whether it was actually edited - The
__on_discord_message_delete
now only gives the deleted message id and the channel object instead of the message object
Function changes
- The channel or message for creating a thread is no longer provided in the schema (previously "parsable"), but as an argument to
dc_create_thread
dc_react
has been split todc_add_reaction(msg, emoji)
anddc_remove_reaction(msg, emoji?, user?)
dc_set_channel_topic
was removed in favor of the newdc_update_channel
- Removed
dc_get_display_name
in favor ofmember~'effective_name'
- Removed
dc_get_timeout
in favor ofmember~'timeout_end'
- Removed
dc_get_user_color
in favor ofmember~'color'
- Removed
dc_get_user_roles
in favor ofmember~'roles'
- Added
dc_update_presence()
to replacedc_set_status()
anddc_set_activity()
Value changes
- The command value types are now all the same value type
dc_command
and can be distinguished withcommand~'type'
- Removed
user~'discriminated_name
, since discriminators are phased out by discord - Replaced
reaction~'message'
withreaction~'message_id'
since messages are not cached anymore slash_command_interaction~'arguments'
andslash_command_interaction~'arguments_by_name'
no longer include the subcommand and subcommand group. Additionally,slash_command_interaction_option~'options'
was removed, since subcommand groups and subcommands are no longer expressed as nested options, but can be retrieved usinginteraction~'sub_command'
or~'sub_command_group'
.- Replaced
~'is_subcommand_or_group'
in slash command interaction option values with~'type'
Schema changes
- Replaced
thread
schemachannel_type
withis_private
. - Changes to message content schema
- Renamed
reply_to
toreferenced_message
since it can now also used to forward messages - Added
message_reference_type
which can be set toforward
to forward messages instead of replying - Made
content
field optional for messages without content, like forwarded messages
- Renamed
- The
file
,url
,bytes
, andimage
fields of the attachment schema have been moved to afile
parsable- The
file
field is now no longer a system file path, but a scarpet resource path, just like it is used in scarpet'sread_file
. bytes
has been renamed tostring
- The
- The following fields of schemas now use the
file
schema (see above)thumbnail
andimage
inembed
icon
inembed_author
andembed_footer
avatar
inwebhook_profile
andwebhook_profile_updater
Type strings
ALL type strings are now returned in lowercase. Additionally, the type fields of schemas are now all case-insensitive, so you can interchangeably use upper or lower case strings everywhere.
Most values returned by the ~'type'
queries of values are now also different:
~'type'
strings
The type
s of a channel value have changed:
SERVER_TEXT_CHANNEL
->text
SERVER_VOICE_CHANNEL
->voice
SERVER_FORUM_CHANNEL
->forum
SERVER_STAGE_VOICE_CHANNEL
->stage
SERVER_NEWS_CHANNEL
->news
SERVER_STORE_CHANNEL
-> removedSERVER_PUBLIC_THREAD
->guild_public_thread
SERVER_PRIVATE_THREAD
->guild_private_thread
SERVER_NEWS_THREAD
->guild_news_thread
PRIVATE_CHANNEL
->private
GROUP_CHANNEL
->group
CHANNEL_CATEGORY
->category
SERVER_DIRECTORY_CHANNEL
-> removed-
- ->
media
- ->
Other changes:
webhook~'type'
CHANNEL_FOLLOWER
changed tofollower
sticker~'type'
SERVER
changed toguild
Schema type strings
The component
type in a component schema have partially different names now:
BUTTON
->button
SELECT_MENU_STRING
->string_select
SELECT_MENU_USER
->user_select
SELECT_MENU_ROLE
->role_select
SELECT_MENU_MENTIONABLE
->mentionable_select
SELECT_MENU_CHANNEL
->channel_select
TEXT_INPUT
->text_input
The style
of the button schema is now no longer the color name, but the types name as discord refers to them:
BLURPLE
->primary
GREY
->secondary
GREEN
->success
RED
->danger
URL
->link
Other breaking changes
- Exception hierarchy and values have changed
New features
- Added
slash_command_interaction~'subcommand'
andslash_command_interaction~'subcommand_group'
- Added
channel_types
to select menu schema - Added
mention_channels
,mention_emojis
,mention_slash_commands
,mention_here
fields to allowed mentions schema - Added
mention_replied_user
to allowed mentions - Emoji fields in schemas now support many more string notations
- Added
dc_remove_reaction(msg, emoji?, user?)
- Added
message~'stripped_content'
- Added
message~'stickers'
- Added
emoji~'type'
- Added
reaction~'channel'
andreaction~'server'
- Added
respond_later_data
schema to third parameter ofdc_respond_interaction
when using typerespond_later
to specify ephemeral.
New file schema
Added a new file
schema for specifying the source of a file
- It uses some of the same fields previously found in the
attachment
schema - The
file
field is now no longer a system file path, but a scarpet resource path, just like it is used in scarpet'sread_file
. bytes
has been renamed tostring
base64
was added as a way to provide data for the file- This is now used for the following fields of schemas:
thumbnail
andimage
inembed
icon
inembed_author
andembed_footer
avatar
inwebhook_profile
andwebhook_profile_updater
- The
file
,url
,bytes
andimage
fields of theattachment
field have been replaced with a singlefile
field.
New member value
Added dc_member
value type, referencing a user in a server.
This can be used to retrieve data of a user specific to a server, like nicknames and roles.
In order to retrieve this value, the following has been added:
- Added
message~'member'
- Added
message~'member'
- Added
interaction~'member'
- Added
role~'members'
- Added
server~'members'
- Added
channel~'position
- Added
dc_member_from_user(user, server)
function for retrieving a member from the user and server.
Update channel function
- Added
dc_update_channel
, replacingdc_set_channel_topic
, allowing to update many options of channels. - Added
channel_updater
schema.
Dependencies
Files
Metadata
Release channel
ReleaseVersion number
1.6.0Loaders
Game versions
1.21.5Downloads
117Publication date
May 25, 2025 at 6:28 PMPublisher
replaceitem
Owner