EvalEngine

A powerful owner-only evaluation engine for Discord bots built on discord.js.

EvalEngine is a multi-purpose runtime tool designed for live debugging, command execution, and cluster-aware inspection in production bots. It goes far beyond a basic eval command.

---

✨ Features

🧠 Multi-Engine Evaluation

Run multiple execution engines through a single command:

• JavaScript: eval your js code
• Shell: PowerShell / Bash / Zsh execution
• Network: Curl requests & RTT checks
• Utility: File inspection (cat) and Shard/Cluster inspection

📄 Dynamic Pagination

• Automatically paginates long outputs
• Button-based navigation
• Clean output formatting without message spam

🔄 Live Update Pagination (Shell)

Shell commands stream output in real time:

• Live-updating paginated output
• Handles long-running commands
• Safe process termination handling

🧩 Automatic Sharding Detection

EvalEngine automatically detects your shard environment:

• Native discord.js sharding
• Hybrid sharding (discord-hybrid-sharding)
• No sharding (single process)

---

📦 Installation

npm install @freycikkk/eval-engine

---

🚀 Basic Usage

import { Client, GatewayIntentBits } from 'discord.js';
import { EvalEngine } from '@freycikkk/eval-engine';

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.MessageContent]
});

const evalEngine = new EvalEngine(client, {
  owners: ['YOUR_DISCORD_ID'],
  prefix: '!',
  secrets: ['SENSITIVE_VALUE'],
  aliases: ['e', 'debug']
});

client.on('messageCreate', (message) => {
  await evalEngine.run(message);
});

client.login('BOT_TOKEN');

---

🧾 Command Format

<prefix><alias> <engine> <input>

Examples

• !eval js client.guilds.cache.size
• !eval shell ls -la
• !eval curl https://api.github.com
• !eval shard client.ws.ping

---

🛠 Supported Engines

Engine	Description
js	JavaScript evaluation
shell	Shell / PowerShell / Bash
curl	HTTP requests
cat	File inspection
rtt	Round-trip latency
shard	Shard & cluster info

---

🔒 Security Notice

Important

This tool is intended for owner-only usage. Do not expose EvalEngine to untrusted users.

• No postinstall scripts: No dynamic downloads or hidden telemetry.
• Sanitization: Configured secrets are automatically redacted from all outputs.

---

📄 License

MIT