About Simple Presence
SimplePresence
SimplePresence is a lightweight, production-ready plugin built and tested for Carbon Rust servers that updates your Discord bot’s presence in real time using direct in-server data.
No root access required. No third-party hosting. No Python / Node.js. No Oxide.Ext.Discord.dll
Ideal for hosted environments (e.g., Pine Hosting, Shockbyte, Nitrado) where running external bots or services isn’t possible.
Key Features
- Real-time Discord presence powered by live server events
- Accurate Online, Joining, and Sleeping player counts
- Fast updates on connect, spawn, sleep, wake, and disconnect
- Automatically displays "Server is restarting" during shutdown/restart
- Self-healing recovery logic for temporary Discord connectivity stalls
- Zero external plugin dependencies (no Placeholder plugins required)
Platform Support
Built and tested on Carbon.
This plugin may function on Oxide, but Oxide compatibility is not guaranteed and is not actively tested. For best results and full support, Carbon is recommended.
Discord Bot Setup (Required)
SimplePresence requires a Discord bot token. If you do not already have a Discord bot, follow these steps first:
- Open the Discord Developer Portal: https://discord.com/developers/applications
- Create a new application
- Go to the Bot section and click Add Bot
- Copy the Bot Token (you will paste this into the plugin config)
- Enable these Privileged Gateway Intents:
- Presence Intent
- Server Members Intent
- Message Content Intent is not required.
- Save changes
Visual walkthrough (official guide): https://umod.org/extensions/discord#getting-your-api-key
Security Note: Never share your Discord bot token. Anyone with this token can control your bot.
Plugin Installation
- Upload SimplePresence.cs to your server’s plugins folder
- Open the generated config and paste your Discord bot token
- Reload the plugin
Configuration
The config allows you to customize the presence message format. Tokens are replaced with live values:
- Online: currently active players
- Sleep: sleeping players
- Joining: players currently connecting/loading
Scope
SimplePresence focuses exclusively on Discord presence updates.
It does not send messages, embeds, or logs. This keeps the plugin clean, reliable, and low maintenance.
License
This plugin is distributed under a proprietary license. Redistribution is not permitted.
Support
Support is provided for Carbon servers running the latest version. Use the Get Support button here on Codefling. Please allow 24 hours for a response.
Author: Rome