Fancy Greeter
by SetZero
An annotated, self-contained example plugin. Greets users on connect, responds to Ping messages, serves an HTTP status page, and demos the full Tier-1 slash-command / component / modal / toast flow.
4.7
12,384 downloads
README
fancy-greeter
An annotated, self-contained example of a Fancy Mumble server plugin.
Drop the compiled .so (or .dll / .dylib) into your server's plugin directory, flip a single INI switch, restart the server, and the plugin runs. No server recompile, no rebuild, no link edit.
What it does
| Feature | Description |
|---|---|
| Greeting | Sends a configurable welcome message to every user immediately after they connect. |
| Ping / Pong | Responds to Ping plugin-messages with a Pong that carries the current session count. |
| HTTP status page | Serves GET /status (default port 64741) so operators can confirm the plugin is running and view live stats. |
| Tier-1 client extensions | Declares the /greet <name> [loud?] slash command; demos message card, button, modal, and toast - no client-side JavaScript needed. |
Configuration
All keys live under the plugin.fancy-greeter.* namespace.
plugin.fancy-greeter.enabled=true
plugin.fancy-greeter.greeting_template=Welcome to the server, {username}!
plugin.fancy-greeter.farewell_template=Goodbye, {username}.
plugin.fancy-greeter.http_port=64741
Prerequisites
| Rust | 1.77 or newer (build from source) |
| Fancy Mumble server | PLUGIN_ABI_VERSION 2 |
Architecture
Plugins are dynamically-loaded shared libraries with an ABI-stable boundary defined by the mumble-plugin-api crate. The host dlopens the library, verifies abi_version, and instantiates the plugin through fancy_export_plugin!.
See the upstream docs at server/plugins/overview and server/plugins/developing for the full plugin model.
License
MIT
Versions
| Version | Released | Min Server | Changelog |
|---|---|---|---|
0.2.0 | 5/24/2026 | 1.6.0 | Full Changelog: https://github.com/Fancy-Mumble/fancy-plugin-example/commits/v0.2.0 |