About

Type-aware ESLint rules for discord.js. Aside from the two prefer-* style rules, each rule flags a payload or command definition that fails at runtime, either in discord.js validation or at the Discord API. Rules check only values known at lint time and skip dynamic ones.

This plugin stands alone and works in any discord.js project, seedcord or otherwise.

Install

pnpm add -D eslint-plugin-discordjs

Requires ESLint 9.22.0+ flat config with typed linting (projectService), since most rules read types.

Use

// eslint.config.js
import { defineConfig } from 'eslint/config';
import discordjs from 'eslint-plugin-discordjs';
import tseslint from 'typescript-eslint';

export default defineConfig(
    // ...your existing config
    {
        files: ['**/*.ts'],
        extends: [discordjs.configs.recommended],
        languageOptions: {
            parser: tseslint.parser,
            parserOptions: {
                projectService: true,
                tsconfigRootDir: import.meta.dirname
            }
        }
    }
);

If your config already sets up typed linting, drop the languageOptions block and keep the scoped extends entry.

Rules

All rules run at error except the two prefer-* style rules, which warn.

seedcord

These rules are the discord.js half of the seedcord lint setup. seedcord bots add @seedcord/eslint-plugin, whose seedcord preset layers the framework rules over this plugin's recommended.