mirror of https://github.com/arthur-pbty/flint.git synced 2026-08-01 20:29:03 +02:00

Files

T

Puechberty Arthur be8288ab5e feat: implement utility commands and command framework

- Add advanced command for complex argument handling.
- Introduce ping command for latency checking.
- Create argument parser for prefix and slash commands.
- Define command structure and registry for command management.
- Implement command deployment for Discord application commands.
- Add internationalization support for commands.
- Create handlers for prefix and slash command execution.
- Establish command execution context and permissions handling.
- Set up environment configuration with dotenv and zod.
- Add TypeScript configuration for strict type checking.

2026-04-12 02:34:53 +02:00

1.8 KiB

Raw Blame History

Discord.js v14 Framework Template

Professional command framework template for Discord.js 14.26.2 with:

Single command object schema
Minimal command authoring (name, category, execute)
Shared execution logic for prefix and slash
External JSON i18n
Automatic prefix and slash localizations from locale files
One localized name per language drives both prefix and slash triggers
Typed argument schema
User permission checks
Auto-generated help from command metadata

Setup

Install dependencies: npm install
Create environment file: cp .env.example .env
Fill required values in .env:
- DISCORD_TOKEN
- DISCORD_CLIENT_ID
Deploy slash commands: npm run deploy:commands
Start in development: npm run dev

Architecture

src/framework/types/command.ts: strict command schema
src/framework/commands/defineCommand.ts: default command completion
src/framework/commands/registry.ts: trigger/name mapping generated from locales
src/framework/commands/argParser.ts: prefix/slash args parsing from schema
src/framework/execution/CommandExecutor.ts: unified pipeline (permissions/execute)
src/framework/handlers/prefixHandler.ts: prefix entrypoint
src/framework/handlers/slashHandler.ts: slash entrypoint
locales/*.json: external i18n dictionaries
src/commands/*: business commands only (execute)

Included Commands

kiss (fun) with required user arg
ping (utility)
advanced (utility) with full argument/permission example
help (core) with auto category and usage generation

Adding A Command

Create a command object in src/commands/...
Follow the schema in src/framework/types/command.ts
Add command to src/commands/index.ts
Deploy slash commands again (npm run deploy:commands)

1.8 KiB Raw Blame History

Discord.js v14 Framework Template

Setup

Architecture

Included Commands

Adding A Command

1.8 KiB

Raw Blame History