nBot

nBot is a Discord bot framework built on top of discord.js v14 with a focus on:

• Deterministic behavior
• Explicit contracts
• Plugin isolation
• Long-lived maintainable codebases

This is not a starter template. It is a framework intended for serious applications.

Core Principles

• Explicit over implicit
• Fail fast on invalid state
• Stable public API boundaries
• Framework-owned lifecycle and client
• No magic defaults

What nBot Provides

• Strict Discord client ownership
• Deterministic lifecycle hooks
• Typed command and event systems
• Guard-based command execution pipeline
• Plugin system with dependency resolution
• Capability enforcement
• Feature flag registry
• Scoped dependency injection
• Immutable runtime configuration

What nBot Does NOT Do

• No auto-discovery by convention
• No hidden globals
• No silent fallback behavior
• No opinionated persistence layer
• No CLI scaffolding (by design)

Intended Audience

nBot is designed for developers who:

• Build large or long-lived Discord bots
• Need predictable startup and shutdown
• Want plugin ecosystems without fragility
• Value architectural clarity over shortcuts

Usage Philosophy

nBot assumes:

• You understand Discord.js
• You want control over architecture
• You prefer explicit configuration
• You care about upgrade stability

If you want quick scripts, this is not the right tool.

Status

This project is under active design and iteration. Public APIs are documented and versioned. Internal structure may evolve between minor releases.

License

nBot is licensed under the MIT License.