Files
meshcore-bot/docs/service-plugins.md
T
agessaman b59fa9cec9 feat(config, docs): enhance rain command and stats collection configuration
- Updated the `[Rain_Command]` section in `config.ini.example` to include support for snow alongside rain, improving the command's functionality.
- Enhanced documentation for the rain command to reflect the new snow alias and clarify response behavior based on the selected keyword.
- Added a new `collect_stats` option in the `[Stats_Command]` section, allowing stats collection to be enabled independently of the user-facing command, with updated documentation to explain its behavior.
- Improved the web viewer documentation to clarify how stats are collected and displayed, ensuring users understand the configuration options.
2026-06-28 13:28:23 -07:00

1.7 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
World Cup Live Service Proactive FIFA World Cup match announcements (auto-detects the active tournament)

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.