Navi: The High-Performance, Lua-Driven Discord Engine

Navi is a next-generation, general-purpose Discord bot built for server owners who demand absolute stability, and developers who crave flexibility.

Unlike traditional bots that require full restarts for every minor update, Navi operates as a high-performance Engine written in Rust, running a sandboxed Virtual Machine for Lua plugins. This architecture separates the heavy lifting (networking, threading, and memory management) from the active bot logic, resulting in a plug-and-play ecosystem that is blazing fast, memory-safe, and capable of zero-downtime updates.

🏗️ The Architecture

At its core, Navi utilizes a hybrid-language, multi-threaded design:

• The Hardware (Rust): Powered by Tokio for asynchronous runtime and Serenity for Discord API interfacing, the Rust backbone handles the event loop, database locks, and HTTP requests. It is completely bulletproof, ensuring the bot never crashes during runtime.
• The Brain (Lua): Bot features (like economy systems, moderation tools, and reaction roles) are written as lightweight Lua scripts. These plugins are entirely sandboxed and interact with Discord through a highly restricted, custom API (navi_api) exposed by the Rust engine.
• The Dashboard (Ratatui): A synchronous Terminal User Interface (TUI) runs on the main thread, providing a “God-Mode” control panel. It allows server admins to monitor real-time logs, intercept errors, and manage the bot without relying on Discord chat commands.

✨ Key Features

• Hot-Reloadable Plugins: Because the bot logic is completely decoupled from the network connection, plugins can be modified, added, or removed on the fly. A simple Reload command instantly wipes and recompiles the Lua environment without ever dropping the bot’s connection to Discord.
• Modern Discord UI Support: Navi fully supports modern Discord interactions, including complex Embeds, Action Rows, Buttons, and Select Menus (Dropdowns), allowing for clean, interactive menus rather than cluttered text commands.
• Built-in KV Database: The engine includes an integrated, thread-safe Key-Value database. Plugins can instantly save and retrieve persistent data (like user XP or bank balances) using a simple navi.db.get() and navi.db.set() API, abstracting away complex SQL queries.
• Modular by Design: Navi is built to be a premium, plug-and-play product. Server owners can drop a new .lua file into the plugins folder, and the bot instantly learns new commands and database schemas.

🚀 Built For the Future

Navi bridges the gap between complex systems engineering and user-friendly server management. It is designed from the ground up to be the ultimate foundation for robust, commercial-grade Discord communities, offering a growing library of default plugins that cover everything from leveling systems to interactive storefronts.

📃 Documentation

Visit the documentation page for Navibot

Navibot Plugin Development Guide