Plugins

First time here? View plugins

channelType

This plugin checks if a channel is the specified type

View

channelType by Benzo-Fury

This plugin checks if a channel is the specified type

src/commands/ping.ts

 import { channelType } from "../plugins/channelType";
 import { ChannelType } from "discord.js"
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ channelType([ChannelType.GuildText], 'This cannot be used here') ],
  execute: (ctx) => {
 		//your code here
  }
 })

requirePermission

This is perm check, it allows users to parse the permission you want and let the plugin do the rest. (check bot or user for that perm).

View

requirePermission by Benzo-Fury and needhamgary

This is perm check, it allows users to parse the permission you want and let the plugin do the rest. (check bot or user for that perm).

src/commands/ping.ts

 import { requirePermission } from "../plugins/myPermCheck";
 import { commandModule, CommandType } from "@sern/handler";
 export default commandModule({
  plugins: [ requirePermission<CommandType>('target', 'permission', 'No response (optional)') ],
  execute: (ctx) => {
 		//your code here
  }
 })

publish

[DEPRECATED]

It allows you to publish your application commands using the discord.js library with ease.

View

publish by EvolutionX-10

This plugin is deprecated and should not be used in new projects.

It allows you to publish your application commands using the discord.js library with ease.

src/commands/ping.ts

 import { publish } from "../plugins/publish";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ publish() ], // put an object containing permissions, ids for guild commands, boolean for dmPermission
  // plugins: [ publish({ guildIds: ['guildId'], defaultMemberPermissions: 'Administrator'})]
  execute: (ctx) => {
 		//your code here
  }
 })

disable

Disables a command entirely, for whatever reasons you may need.

View

disable by jacoobes and Peter-MJ-Parker

Disables a command entirely, for whatever reasons you may need.

src/commands/ping.ts

 import { disable } from "../plugins/disable";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ disable() ],
  execute: (ctx) => {
 		//your code here
  }
 })

ownerOnly

This is OwnerOnly plugin, it allows only bot owners to run the command, like eval.

View

ownerOnly by EvolutionX-10

This is OwnerOnly plugin, it allows only bot owners to run the command, like eval.

src/commands/ping.ts

 import { ownerOnly } from "../plugins/ownerOnly";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ ownerOnly() ], // can also pass array of IDs to override default owner IDs
  execute: (ctx) => {
 		//your code here
  }
 })

subcommandPermCheck

Inspired by the plugin “requirePermission” created by Benzo-Fury & needhamgary, this plugin will set permissions for specific subcommands without manually writing it into the code.

View

subcommandPermCheck by Peter-MJ-Parker and MaxiIsSlayy

Inspired by the plugin “requirePermission” created by Benzo-Fury & needhamgary, this plugin will set permissions for specific subcommands without manually writing it into the code.

src/commands/ping.ts

 import { subcommandPermCheck } from "../plugins/subcommandPerms.js";
 import { commandModule, CommandType } from "@sern/handler";
 import { PermissionFlagBits } from "discord.js";
 export default commandModule({
  type: CommandType.Slash,
  plugins: [
   subcommandPermCheck({
    list: [
      { name: "string", perms: [PermissionFlagBits.Administrator] },
      { name: "number", perms: [PermissionFlagBits.SendMessages, PermissionFlagBits.UseVAD] }
    ],
   needAllPerms: true, //all = Require the member to have all perms stated or at least one?
   //response: "OPTIONAL - respond to user with this message or default."
   })
  ],
  execute: ({ interaction }) => {
 		//your code here
  }
 })

dmOnly

This is dmOnly plugin, it allows commands to be run only in DMs.

View

dmOnly by EvolutionX-10

This is dmOnly plugin, it allows commands to be run only in DMs.

src/commands/ping.ts

 import { dmOnly } from "../plugins/dmOnly";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [dmOnly()],
  execute: (ctx) => {
 		//your code here
  }
 })

buttonConfirmation

This is buttonConfirmation plugin, it runs confirmation prompt in the form of buttons. Note that you need to use edit/editReply in the command itself because we are already replying in the plugin!…

View

buttonConfirmation by EvolutionX-10

This is buttonConfirmation plugin, it runs confirmation prompt in the form of buttons. Note that you need to use edit/editReply in the command itself because we are already replying in the plugin! Credits to original plugin of confirmation using reactions and its author!

src/commands/ping.ts

 import { buttonConfirmation } from "../plugins/buttonConfirmation";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ buttonConfirmation() ],
  execute: (ctx) => {
 		//your code here
  }
 })

confirmation

Asks the user for a confirmation msg before executing the command

View

confirmation by trueharuu

Asks the user for a confirmation msg before executing the command

src/commands/ping.ts

 import { confirmation } from "../plugins/confirmation";
 import { CommandType, commandModule } from "@sern/handler";
 // YOU MUST HAVE GUILD MESSAGE REACTION INTENTS ON YOUR CLIENT!!!!
 export default commandModule({
  type : CommandType.Both
  plugins: [confirmation()],
 	execute: (ctx, args) => {
 		ctx.interaction.followUp('Hello welcome to the secret club')
 	}
 })

nsfwOnly

This plugin checks if the channel is nsfw and responds to user with a specified response if not nsfw

View

nsfwOnly by Benzo-Fury and SrIzan10

This plugin checks if the channel is nsfw and responds to user with a specified response if not nsfw

src/commands/ping.ts

 import { nsfwOnly } from "../plugins/nsfwOnly";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ nsfwOnly('response', true) ],
  execute: (ctx) => {
 		//your code here
  }
 })

filter

Generalized filter plugin. all credit to trueharuu. Perform declarative conditionals as plugins.

View

filter by trueharuu

Generalized filter plugin. all credit to trueharuu. Perform declarative conditionals as plugins.

src/commands/ping.ts

 import { filter, not, isGuildOwner, canMentionEveryone } from '../plugins/filter';
 import { commandModule } from '@sern/handler';
 export default commandModule({
     plugins: [filter({ condition: [not(isGuildOwner()), canMentionEveryone()] })],
     async execute(context) {
       // your code here
     }
 });

assertFields

This plugin checks the fields of a ModalSubmitInteraction with regex or a custom callback

View

assertFields by jacoobes

This plugin checks the fields of a ModalSubmitInteraction with regex or a custom callback

src/commands/ping.ts

 export default commandModule({
     type: CommandType.Modal,
     plugins: [
         assertFields({
             fields: {
             // check the modal field "mcUsernameInput" with the regex /a+b+c/
                 mcUsernameInput: /a+b+c+/
             },
             failure: (errors, interaction) => {
                 interaction.reply(errors.join("\n"))
             }
         }),
     ],
     execute: ctx => {
         ctx.reply("nice!")
     }
 })

permCheck

This is perm check, it allows users to parse the permission you want and let the plugin do the rest. (check user for that perm). Each function (other than “command”) allows multiple options! [ { …

View

permCheck by Benzo-Fury, Peter-MJ-Parker, and MaxiIsSlayy

This is perm check, it allows users to parse the permission you want and let the plugin do the rest. (check user for that perm). Each function (other than “command”) allows multiple options! [ { … }, { … }, { … } ] See examples!

src/commands/ping.ts

 import { permCheck } from "../plugins/permCheck";
 import { commandModule } from "@sern/handler";
 export default commandModule({
  plugins: [ permCheck(["Administrator", "AddReactions"], "I am a custom response!"),
 		permCheck.options([{ name: "user", needAllPerms: true, perms: ["AttachFiles", "CreateEvents"]}]),
 		permCheck.subcommands([{ name: "list", needAllPerms: false, perms: ["Connect"]}]),
 		permCheck.subGroups([{ name: "list", needAllPerms: false, perms: ["Connect"], response: "I am also a custom response!"}])],
  execute: (ctx) => {
 		//your code here
  }
 })

fromCallback

fromCallback turns a callback into a plugin result. if the callback returns truthy value, plugin continues. This control plugin works for every command type. The arguments of the callback mirror…

View

fromCallback by jacoobes

fromCallback turns a callback into a plugin result. if the callback returns truthy value, plugin continues. This control plugin works for every command type. The arguments of the callback mirror the execute method on the current module.

src/commands/ping.ts

 const myServer = "941002690211766332";
 export default commandModule({
     type: CommandType.Both,
     plugins: [
         //This plugin prevents this command module from executing in other servers except myServer
         fromCallback((ctx, args) => ctx.guildId == myServer)
     ],
     execute: ctx => {
         ctx.reply("I only respond in myServer!");
     }
 })

serverOnly

Checks if a command is available in a specific server.

View

serverOnly by Peter-MJ-Parker

Checks if a command is available in a specific server.

src/commands/ping.ts

 import { commandModule, CommandType } from "@sern/handler";
 import { serverOnly } from "../plugins/serverOnly";
 export default commandModule({
   type: CommandType.Both,
   plugins: [serverOnly(["guildId"], failMessage)], // fail message is the message you will see when the command is ran in the wrong server.
   description: "command description",
   execute: async (ctx, args) => {
     // your code here
   },
 });

cooldown

Allows you to set cooldowns (or “ratelimits”) for commands, limits user/channel/guild actions. An extra function cooldown2 is exported if you want your cooldown to be local to the command.

View

cooldown by trueharuu

Allows you to set cooldowns (or “ratelimits”) for commands, limits user/channel/guild actions. An extra function cooldown2 is exported if you want your cooldown to be local to the command.

src/commands/ping.ts

 import { cooldown, cooldown2 } from "../plugins/cooldown";
 import { commandModule } from "@sern/handler";
 //IF you want this cooldown to be local to this command:
 const localCooldown = cooldown2()
 export default commandModule({
  plugins: [cooldown.add([['channel', '1/4']]), // limit to 1 action every 4 seconds per channel
            localCooldown.add([["user", "1/10"]])], // limit to 1 action every 10 seconds, local to command
  execute: (ctx) => { //your code here }
 })