Files
meshcore-bot/docs/service-plugins.md
T
agessaman a60b35f567 docs: update README and command reference with new features and services
- Removed caution section from README to streamline information.
- Added new services to README: Earthquake Service, Repeater Prefix Collision Service, and MQTT Weather Relay.
- Expanded command reference documentation with new commands: `version`, `status`, `aurora`, `magic8`, `catfact`, `reload`, `channelpause`, `channelresume`, `greeter`, `announcements`, and `schedule`.
- Updated getting started guide to reflect changes in Python version requirement and installation instructions.
- Enhanced service plugins documentation to include new services and clarify existing ones.
2026-04-25 19:21:23 -07:00

1.5 KiB

Service Plugins

Service plugins extend the bot with background services that run alongside the main message loop. Each can be enabled or disabled in config.ini.

Plugin Description
Discord Bridge One-way webhook bridge to post mesh messages to Discord channels
Telegram Bridge One-way bridge to post mesh messages to Telegram chats/channels
Packet Capture Capture packets from the mesh and publish them to MQTT brokers
Map Uploader Upload node advertisements to map.meshcore.dev for network visualization
Weather Service Scheduled weather forecasts, weather alerts, and lightning detection
MQTT Weather Relay (MqttWeather) Relay weather data to custom MQTT topics configured under [Weather]
Webhook Service (Webhook) Accept inbound HTTP POST payloads and relay to mesh channels or DMs
Earthquake Service Earthquake alerts for a configured region (USGS API, defaults: California)
Repeater Prefix Collision Service Alerts when a newly heard repeater prefix collides with an existing repeater prefix

Enabling a plugin

  1. Add or edit the plugin's section in config.ini (see each plugin's doc for options).
  2. Set enabled = true for that plugin.
  3. Restart the bot.

Some plugins require additional configuration (API keys, webhook URLs, etc.) before they will run successfully.