𝗖 𝗥 𝗢 𝗦 𝗦 - 𝗛 𝗢 𝗦 𝗧 𝗜 𝗡 𝗚

Ovencord Cross Hosting

The ultimate cross-hosting library for Bun, optimized for ultra-low latency (<2ms) and native performance. Built to work seamlessly with @ovencord/hybrid-sharding.

Features:

• Native Bun Networking: Uses Bun.listen and Bun.connect for maximum performance and minimum overhead.
• Ultra Low Latency: Designed for inter-VPS communication with <2ms latency targets.
• broadcastEval(): Execute code across all machines and clusters with ease.
• Dependency-Free: Zero Node.js networking dependencies (net-ipc, etc. removed).
• Rolling Restarts: Seamlessly update shard counts and machine configurations without downtime.
• Hybrid-Sharding Integration: Specifically tailored for @ovencord/hybrid-sharding.

📦 Comparison: discord-cross-hosting vs @ovencord/cross-hosting

Feature	discord-cross-hosting	@ovencord/cross-hosting	Result / Advantage
Runtime	Node.js (Legacy)	Bun (Native)	Native execution without emulation
Unpacked Size	153 kB	59 kB	~61% lighter
Total Files	48	16	Streamlined, modern architecture
TCP Engine	node:net (Emulated)	Bun.listen / Bun.connect	Bypasses Node.js overhead
Event System	node:events (Sync)	AsyncEventEmitter	Non-blocking asynchronous handling
Dependencies	net-ipc, lodash, etc.	ZERO (Native)	Instant install, 0 vulnerabilities
Data Handling	node:buffer	Uint8Array (Zero-copy)	RAM-speed data transfers
Build Step	dist/ (Transpiled)	Source-Only (.ts)	0ms Build Time - Executes TS directly
Node.js Imports	Present in source	ZERO (Grep Zero)	Complete independence from legacy Node

Result: ~89% savings on total installation weight and zero external networking dependencies!

📦 Installation

bun add @ovencord/cross-hosting
bun add @ovencord/hybrid-sharding

Quick Start Guide:

1. Bridge (Coordinator)

The Bridge handles the coordination of shards across all machines.

import { Bridge } from '@ovencord/cross-hosting';

const bridge = new Bridge({
    port: 4444,
    authToken: 'YOUR_SECURE_TOKEN',
    totalShards: 'auto',
    totalMachines: 2,
    shardsPerCluster: 10,
    token: 'YOUR_BOT_TOKEN',
});

bridge.on('debug', console.log);
bridge.listen();

bridge.on('ready', (addr) => {
    console.log(`Bridge listening on ${addr}`);
});

2. Client (Machine)

The Client runs on each VPS/Machine and connects to the Bridge.

import { Client } from '@ovencord/cross-hosting';
import { Manager } from '@ovencord/hybrid-sharding';

const client = new Client({
    agent: 'bot',
    host: 'bridge-vps-ip',
    port: 4444,
    authToken: 'YOUR_SECURE_TOKEN',
    rollingRestarts: true,
});

const manager = new Manager('./bot.ts', { totalShards: 'auto' });

client.on('debug', console.log);
client.connect();

client.listen(manager);

client.requestShardData().then(data => {
    manager.totalShards = data.totalShards;
    manager.spawn();
});

3. Shard (Bot)

Access cross-hosting features directly from your bot instance.

import { Shard } from '@ovencord/cross-hosting';
import { Client } from '@ovencord/hybrid-sharding';
import { Client as DiscordClient } from 'discord.js';

const client = new DiscordClient({ intents: [1] });
client.cluster = new Client(client);
client.crosshost = new Shard(client.cluster);

client.on('ready', async () => {
    const totalGuilds = await client.crosshost.broadcastEval('this.guilds.cache.size');
    console.log(`Total Guilds across all machines: ${totalGuilds.reduce((a, b) => a + b, 0)}`);
});

client.login('TOKEN');

API References

Refer to the source code for detailed type definitions. The library is written in pure TypeScript and leverages Bun's native types for networking.

---

Maintained by Luigi Colantuono