Dave's Discord Utilities

Dave’s Discord Utilities is a server-side Vintage Story mod that extends Th3Essentials with Discord-based whitelist request tools, staff review controls, account-link tracking, and configurable bot status updates.

I built it to cut down the repetitive Discord and whitelist work that server staff usually have to do by hand, while keeping each request easy to review later.

Project Links

What It Looks Like

A redacted Discord staff review card showing whitelist status, identity verification, applicant details, and moderation actions. — Staff review cards keep request state, identity checks, and moderation actions in one place.

Discord slash commands for requesting access and repairing whitelist review cards. — Slash commands expose the main request flow and repair tooling without making staff edit data by hand.

Discord bot status showing current server player count and in-game date. — Configurable bot status can surface live server context such as player count and world date.

Overview

Dave’s Discord Utilities was built for Vintage Story servers that already use Th3Essentials and its Discord bot integration. It adds a /request flow where a prospective player can submit a whitelist request from Discord, while staff review the request through a private review card with action buttons.

It does not make whitelist decisions for staff. It handles the coordination around those decisions: whitelist changes, Discord role updates, nickname changes, applicant threads, and account-link checks.

Main Features

Discord /request command for whitelist applications.
Staff-only review cards with add, revoke, ban, and unban actions.
Optional private applicant threads for follow-up questions.
Discord role and nickname updates after approval or revocation.
Review-channel privacy checks before staff cards are posted.
Optional identity tracking through Th3Essentials account links.
Strict identity mode that can revoke configured access if a player does not link accounts before the deadline.
Configurable Discord bot status text with player count and world date support.
Repair tooling for refreshing or rebuilding review cards.

Technical Notes

The mod is written in C# as a server-side Vintage Story code mod. It uses Th3Essentials’ existing Discord connection instead of opening its own, so the mod can stay focused on request intake, review state, role changes, whitelist updates, and repair operations.

The configuration is heavy on purpose. Servers organize Discord permissions, helper roles, and whitelist policies differently, so request channels, review channels, approver roles, approved roles, identity-verification mode, message text, and bot-status formatting all live in generated config files.

I also added a few safeguards for live server use:

Review cards are posted only when the configured review channel is private.
Repair operations pace Discord message edits to avoid noisy rate-limit behavior during larger rebuilds.
Strict identity verification is optional and can be configured to remove the Vintage Story whitelist entry, the Discord role, or both.
State is stored separately from config so administrators can change settings without manually editing request history.

Why I Built It

I am running a small Vintage Story server and I wanted to streamline the whitelisting process.

The interesting part is the coordination. The mod has to deal with game-server state, Discord state, staff actions, and saved review history without assuming that every Discord message, role, or thread will stay exactly as the bot created it.

I’ll likely continue updating and maintaining it for as long as I need it, and the source is available for anyone who wants to study, maintain, or expand on it.