A lean Discord bot focused on simple community utilities: verification, greeting flow, sticky messages, reaction-role panels, and a lightweight community kudos system.
This bot is intentionally minimal and opinionated. The current active runtime is built around:
- verification and welcome flow
- sticky messages
- reaction-role panels
- member kudos tracking and profiles
- configurable bump detection and claim rewards
The goal is to keep the feature set small, predictable, and easy to maintain.
- Verification setup with a custom word and role assignment
- Follow-up DM templates after successful verification
- Auto-clean channels to remove non-bot member messages
- Welcome greetings with configurable text and channel
- Sticky messages that refresh automatically in a channel
- Reaction role panels for role selection
- Kudos rewards for:
- active server engagement / chat time
- server bumps
- manual kudos awards
- Member profile command showing total kudos, rank, yapping time, bumps, and thank-you counts
- Leaderboard ranking for top kudos totals in the server
- Persistent JSON storage for all bot state
- Copy
.env.exampleto.envand fill in your own values:BOT_TOKENCLIENT_IDDATA_DIR(optional, recommended in production; example:/var/lib/faithdb-data)
- Install dependencies:
npm install
- Start the bot:
node index.js
index.js: loads the bot state, registers commands, and wires the eventscommands/: slash command modules for the active bot featuresevents/: message, interaction, join, and delete handlersservices/kudosService.js: reward logic, ranking math, and anti-farming checksutils/storage.js: JSON disk helpersutils/tpl.js: template rendering for verification follow-ups and greeting text
setup— set verification channel, word, and rolefollowup— add a follow-up DM templateclean— enable auto-clean for a channelunclean— disable auto-clean for a channel
add text— add a plain text greeting templateadd embed— add an embed greeting templatechannel— set the channel for greetingsautodelete— set greeting auto-delete seconds (0 disables)edit— edit a greeting by number and optionally switch format (textorembed)list— list all greeting templatesremove all— remove all greetingsremove number— remove greeting entries by number
list— list saved follow-up messagesdelete— delete a saved follow-up by number
create— create a new reaction-role paneledit— edit an existing paneldelete— delete a paneldashboard— show active panels in this servergrant access— grant or revoke panel access for a user or role (leave user/role empty to list current panel grants)
add role— add a role to an existing panelremove role— remove a role from a panel
- configure the bump channel, posting user/bot, reward, and claim emoji
- clear the configured detection for a server with the
clearflag
- send a quick preview of the bump claim button in a chosen channel
create text— create a sticky text message in the current channelcreate embed— create a sticky embed in the current channeledit text— edit the sticky textedit embed— edit the sticky embeddelete— delete the sticky in the current channelgrant access— grant or revoke sticky access for a user or role (leave user/role empty to list current sticky grants)
enable <days>— kick unverified users after they remain unverified for that many dayswarn <hours-left> <text>— send a DM warning when the purge is closedisable— disable the purge for the server
user— who to thankfor— reason for the thanks- posts a temporary public confirmation panel that auto-deletes after 30 seconds
- includes a button so only the thanked member can view a private kudos confirmation
- member-accessible with a cooldown so it is not spammed
- show the top kudos totals in the server
- includes the calling member’s rank and total beneath the top 10
- view total kudos
- view server rank
- view yapping time in the server
- view kudos received from others
- view bump count
- view thank-you count
all— clear saved bot data and delete stored panel messages
The kudos system is intentionally conservative and low-abuse.
Rewards are based on:
- active engagement time in conversation
- server bumps
- limited manual member awards
- optional configured bump-claim rewards via the bump detection flow
The current logic includes anti-farming protections such as:
- limiting how often manual kudos can be given
- requiring spaced-out bump award windows
- only counting meaningful activity and reply events
Persistent bot state sits under data/:
If DATA_DIR is set, the bot uses that folder instead of the local data/ path. This is recommended for deployments where the repo directory is frequently reset.
This directory is intentionally local runtime state and is not committed to Git.
stickies.json— sticky message state per channelpanels.json— reaction-role panel configurationgreetings.json— saved greeting templates per guildfollowups.json— saved follow-ups per guildverify.json— verification settings and clean-channel configkudos.json— member kudos totals and related metricscommand-access.json— per-guild user/role allowlists for panel/sticky access