Dave's Discord Utilities

Dave’s Discord Utilities is a Vintage Story mod for servers using Th3Essentials. Players can ask for whitelist access from Discord, and staff get buttons for reviewing those requests.

I built it because I wanted to create a streamlined way to whitelist people using only discord.

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.

Discord slash commands for requesting access and repairing whitelist review cards. — Slash commands run right in Discord.

Discord bot status showing current server player count and in-game date. — The bot can show the player count and in-game date.

Overview

Players use /request in Discord. Staff get a private card with buttons to approve or deny it.

The mod does automatically whitelist players, it just assists in managing a server and allows for whitelist controls throguh discord.

Main Features

Discord commands:

/request: Ask for whitelist access.
/ddu check-mod-updates: Checks for updates and links to ModDB. It never installs anything itself since you should always double check the mod updates to make sure there isn’t a new dependency or a new bug/consideration.
/ddu lockdown: Stops new requests during a raid.
/ddu repair: Rebuilds player cards after an update or if something breaks.
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.
The Discord bot status can show the player count and world date.
Rebuilds review cards with /ddu repair.

Technical Notes

The mod is written in C# and uses the Discord bot created using Th3Essentials.

There are a lot of config options because every server handles permissions and whitelists differently. Channels, staff roles, approved roles, account checks, messages, and bot status can all be changed in the generated config.

It also has a few safeguards:

Review cards are posted only when the configured review channel is private.
Repair waits between edits so Discord does not rate-limit a big rebuild.
Strict identity verification is optional and can be configured to remove the Vintage Story whitelist entry, the Discord role, or both.
Saved request history stays separate from the config, so changing a setting does not mean editing old requests by hand.

Why I Built It

I run a small Vintage Story server and wanted to make whitelisting less annoying.

Due to the influx of bots and griefers on Discord, it is a bit tricky to have an open server that is truly open without it turning into chaos. So in my case I just needed to set up the server in a gated way that required approval from mods/helpers or admin. The additional features came as I ran into things that I wanted to streamline.

I’ll keep updating it as long as my server needs it. The source is there if anyone wants to fork it or add their own stuff.