Hyperion guide

Hyperion is a framework for building Discord bots with discord.js v15. You put commands, buttons, menus, modals, and event handlers in folders, and Hyperion loads them, deploys your commands, and routes every interaction to the right place. You write the parts that make your bot yours.

Hyperion is in beta until discord.js v15 has a stable release, so expect breaking changes between versions until 1.0.

New here? Start with getting started, then pick whatever your bot needs next.

BasicsCopy Anchor Link

• Getting started: create a client and your first command.
• Commands: slash commands, subcommands, and context menus.
• Responding: replying, deferring, and what happens on errors.

InteractionsCopy Anchor Link

• Buttons
• Select menus
• Modals
• Data in custom IDs: one handler for many buttons, each with its own data.
• Autocomplete

ValidationCopy Anchor Link

• Guards: checks that run before your handler.
• Typed input: validate command options and form fields with a schema.

Everything elseCopy Anchor Link

• Events: react to Discord events like messageCreate.
• Logging

PackagesCopy Anchor Link

Optional packages that work with any discord.js bot, and fit Hyperion well.

• JSX: embeds, buttons, layout messages, and forms as JSX. JSX with Hyperion keeps them as handler templates.
• SQLite: keep data in SQLite with validated tables and key-value namespaces.

How-toCopy Anchor Link

• Asking before deleting something: a confirm button only the right person can press.
• Keeping cooldowns across restarts: a cooldown guard backed by SQLite.

When something breaksCopy Anchor Link

• Troubleshooting: startup errors and what they mean.

Looking for exact contracts, edge cases, or how something is implemented? The reference docs one folder up (docs/*.md) cover every detail.