Royal Code SelfBot

⚠️ EXTREME WARNING: USE AT YOUR OWN RISK!
Using self-bots violates Discord's Terms of Service and can lead to the permanent suspension of your Discord account.
This project is for educational purposes only to demonstrate API interactions.
DO NOT USE THIS FOR MALICIOUS PURPOSES OR TO VIOLATE DISCORD'S TOS.
The maintainers are not responsible for any action taken against your account.

Royal Code SelfBot is an experimental Node.js library for interacting with the Discord API using a user account (self-bot).
It provides a familiar structure to libraries like discord.js, but adapted for user tokens.
Includes support for @discordjs/voice (with limitations).

🚀 Quick Start

1. Install Dependencies

npm install royal-selfbot @discordjs/voice ws axios dotenv libsodium-wrappers
# or
yarn add royal-selfbot @discordjs/voice ws axios dotenv libsodium-wrappers

Requires Node.js v20 or newer

2. Set Up Your Token

Create a .env file in your project root:

DISCORD_USER_TOKEN=YOUR_DISCORD_USER_TOKEN_HERE

Never share your token! It grants full access to your account.

3. Basic Usage Example

// example.js
require('dotenv').config();
const { Client } = require('royal-selfbot');

const client = new Client();

client.on('ready', (readyClient) => {
    console.log(`Logged in as ${readyClient.user.tag}!`);
    console.log(`Watching ${readyClient.guilds.cache.size} guilds.`);
});

client.on('messageCreate', async (message) => {
    if (message.author?.id === client.user?.id) return;

    // Simple ping command
    if (message.content.toLowerCase() === '!selfping') {
        await message.reply('Pong!');
    }

    // Example: Get user info
    if (message.content.toLowerCase() === '!myinfo') {
        await message.channel.send(`Your Tag: ${message.author.tag}\nYour ID: ${message.author.id}`);
    }
});

client.on('error', (error) => {
    console.error('[Client Error]', error);
});

client.login(process.env.DISCORD_USER_TOKEN);

🔊 Voice Usage (Experimental)

Note: Joining voice channels with user tokens is blocked by Discord and will likely fail.

The library includes a voiceAdapterCreator for @discordjs/voice integration, but this is mostly for reference.

✨ Features

• Event Handling: Listen for Discord gateway events (Ready, Message Create, etc.)
• Messaging: Send, edit, and manage messages
• REST API: Fetch users, guilds, channels
• Voice Integration: Adapter for @discordjs/voice (limited for user tokens)
• Caching: Basic caching for guilds, channels, users

📖 API Reference

Client

• constructor(options?)
  Create a new selfbot client.

• .login(token: string): Promise
  Log in with your Discord user token.

• Events:

  • ready: Emitted when logged in and ready.
  • messageCreate: Emitted on every message received.
  • error: Emitted on error.

Message

• .reply(content: string): Promise
  Reply to a message.

• .edit(content: string): Promise
  Edit a message.

Guild

• .fetch(): Promise
  Fetch guild info.

Channel

• .send(content: string): Promise
  Send a message to a channel.

💡 Examples

Ping Command

client.on('messageCreate', async (message) => {
    if (message.content === '!ping') {
        await message.reply('Pong!');
    }
});

User Info Command

client.on('messageCreate', async (message) => {
    if (message.content === '!myinfo') {
        await message.channel.send(`Your Tag: ${message.author.tag}\nYour ID: ${message.author.id}`);
    }
});

❓ FAQ

Q: Is this safe to use?
A: No. Self-bots are against Discord's ToS and can get your account banned.

Q: Can I use this for moderation or automation?
A: No. Use a bot account for legitimate automation.

Q: Will voice features work?
A: Voice is experimental and likely blocked for user tokens.

Q: Where can I get help?
A: Join the Royal Discord for discussion and limited support.

🤝 Community & Support

Join the Royal community Discord server for discussions, help (within reasonable limits respecting ToS), and updates:

Self-botting is risky, and support is limited regarding actions that violate Discord's ToS.

⚖️ Disclaimer

This project is experimental and intended for educational purposes. Use of this library is entirely at your own risk.
The developers are not responsible for any consequences resulting from its use, including but not limited to account suspension or termination by Discord.
Always adhere to Discord's Terms of Service and Community Guidelines.