Skip to content

Active Development

Jump to bottom
James T. Boylan edited this page Mar 25, 2026 · 5 revisions

This page outlines features/tools actively being developed for VSVanillaPlus. These features have been moved from the Roadmap, to actively having someone work on them.

Important Note: Features listed here are in development, but not currently available in the mod.

Discord Integration

Status: 💻 In Development
Issue: #16 Discord Integration
Category: Server Administration & Communication

Description

A Discord bot integration that bridges Vintage Story server activity with a Discord guild. Provides bidirectional chat relay, rich event notifications, player account linking, and Discord slash commands for server management — all configurable from an in-game admin panel.

Implemented Features

  • Bidirectional Chat Relay:
    • VS global chat messages are relayed to a designated Discord channel
    • Discord channel messages appear in VS global chat
    • Identity-preserving relay — linked players' VS messages appear in Discord under their own Discord display name and avatar via webhooks
  • Player Group Channel Integration:
    • Link any VS player group to a dedicated private Discord channel with /dcchannel connect
    • Automatically provisions a General role, a Manager role, and a private text channel
    • Group chat is relayed bidirectionally between the VS group and its Discord channel
    • Custom message color per group; optional auto-deletion of Discord resources on disconnect
  • System Event Notifications:
    • Server start, server ready, server shutdown
    • New player first-join, player join, player leave, gamemode change
    • Each event type independently toggled in the Events sub-dialog
  • Game Event Notifications:
    • Player deaths with damage source and creature name
    • Player respawns
    • Temporal storm warnings (approaching, imminent, waning) across all storm severity levels
  • Discord Slash Commands:
    • /players — list online players with optional ping
    • /date — show the current in-game calendar date
    • /serverinfo — show VS version and loaded mods
    • /announce — broadcast a colored message to all in-game players (moderation required)
    • /shutdown — shut down the server with a confirmation button (moderation required)
    • /setchannel — change the chat relay channel (admin only)
    • /auth connect|disconnect — link or unlink a Discord account to a VS player account
    • /dcmanage — manage group roles and promote players to group manager
  • Account Linking:
    • /dclink <token> in-game and /auth connect in Discord to link accounts
    • /dcunlink to remove the link
    • Linked accounts enable identity-preserving relay and group manager role assignment
  • Admin Settings Panel:
    • In-game multi-panel dialog (requires controlserver privilege)
    • Main panel: chat relay toggle, chat color, bot connect/disconnect, command registration
    • Server Settings sub-dialog: bot token, channel IDs, guild ID, webhook settings, server address
    • Events sub-dialog: per-event toggle switches for system and game notifications
    • Roles sub-dialog: admin role ID and bot role ID configuration
  • Single-Player Support:
    • All admin panel actions work in single-player by bypassing the suspended server loop

← Back to Main Page

Clone this wiki locally