slash-create

Create and sync Discord slash commands.

Features

• Multiple server support (Express, Fastify, etc.)
• Hook into an existing Discord bot client
• Sync loaded commands to Discord from slash-create
• Load commands from a folder
• Command throttling/cooldowns

Quickstart

If you want an easy start on getting slash commands on your bot, you can use slash-up to create a project using a template.

npx slash-up init

After creating a project, you can edit commands to your liking and start it up with yarn start.

You can also deploy a slash-create template to the following services:

Cloudflare Workers	Vercel	Heroku	Railway

Installation

npm i slash-create

Or, using yarn:

yarn add slash-create

Using webservers

In order to use a specific webserver, you will need to install the dependency associated with that server. The following server types require these dependencies:

• AWSLambdaServer: none technically, meant for use with AWS Lambda and Amazon API Gateway, see example
• AzureFunctionServer: none technically, meant for use with Azure Functions, see example
• BunServer: none, meant for use in the Bun runtime
• CloudflareWorkerServer: none, only available in the web export via slash-create/web
• ExpressServer: express
• FastifyServer: fastify
• GatewayServer: none, see example
• GCFServer: none technically, meant for use with @google-cloud/functions-framework, see example
• VercelServer: none, see example

Examples

• Creating a SlashCreator
  • Using Webservers
    • Using AWSLambdaServer
    • Using AzureFunctionServer
    • Using GCFServer
    • Using VercelServer
  • Using Discord Bots
• Creating commands

Useful Links

• Discord Documentation on Application Commands
• Website (source)
• Documentation
• Commands Template
• GitHub
• NPM

Resources & References

This project borrows resources and references from the following repositories:

• dbots.js
• eris
• discord.js
• Commando
• slash-worker
• slash-commands
• discord-interactions

Changelog

[6.3.0] - 2024-09-25

Changed:

• POST callbacks will now return responses as InitialCallbackResponse, multiple functions can return this instead of a boolean denoting success

Added:

• SlashCreators using webservers can use the postCallbacks option to serve 202s to interactions and POST a callback instead
• Launching activities with MessageInteractionContext#launchActivity
• Entry points
• SlashCommand#getMention
• MessageInteractionContext#defer now supports using any message flags
• Support for editing message flags
• Support for sending polls
• [types] Updated MessageAttachmentOptions to support voice message properties
• Message classes now support the following:
  • call objects (call)
  • more thread properties (position and thread)
  • polls (poll)
  • activity
  • applicationID
  • message snapshots / forwarded messages (messageSnapshots)
  • stickers (stickerItems)

Fixed:

• HTTP errors will now properly format request errors
• Fastify/Express servers should no longer respond early to some interactions
• Message#interactionMetadata parsing has been updated and fixed to include more data
• [types] Updated AutocompleteChoice to include name_localizations
• [types] Updated MessageAttachment to include waveform, duration_secs, flags, title, and ephemeral
• [types] Updated Message#components to be an array of any component rather than just action rows (See https://github.com/discord/discord-api-docs/pull/7115)