🏠 Housekeeper Discord Bot

Housekeeper is a practical Discord management bot for communities that want cleaner onboarding, clearer invite tracking, smoother staff workflows, and organized gaming-event coordination without turning the server into a pile of manual chores.

It is built for server owners, admins, moderators, gaming groups, and private communities that need more than a basic welcome bot. Housekeeper helps you understand how members arrive, welcome them with a polished private message, configure server behavior from Discord, and manage Rust wipe events with polls, private channels, reminders, rosters, and cleanup tools.

Housekeeper focuses on server operations: the quiet, useful work that keeps a Discord community easy to run.

Housekeeper combines several server-management tools into one bot:

• Tracks member joins and leaves.
• Detects which invite was used when Discord exposes enough invite data.
• Shows invite analytics, inviter totals, recent activity, and unknown invite outcomes.
• Sends private welcome DMs to new members.
• Lets admins preview and update welcome-message Markdown.
• Provides an interactive /setup panel for server configuration.
• Supports optional automatic default-role assignment.
• Helps trusted organizers plan Rust wipe events with Discord polls.
• Creates and syncs private wipe-planning channels.
• Sends reminders before poll close and wipe time.
• Maintains rosters for joined, invited, waitlisted, and removed players.
• Archives or schedules deletion for finished wipe channels.
• Includes a web admin panel for connected-server management.
• Keeps longer bot messages editable through Markdown templates.
• Exposes saved logs, error logs, and live operational visibility for bot owners.

The goal is simple: make the server easier to manage while keeping the important decisions in the hands of the people running it.

Housekeeper watches for member joins and leaves, then posts useful context to the configured log channel. When possible, it identifies the invite used, the inviter, the invite code, the invite channel, and the current invite use count.

This gives staff a better picture of how the community is growing. Instead of seeing only that someone joined, admins can see whether the member arrived through a known invite, whether Discord could not identify the source, and how invite activity is trending over time.

Housekeeper also includes /invite-stats, which summarizes invite totals and recent activity for the server. This is useful for communities that care about trusted growth, event recruitment, private-server invites, or simply knowing which members are bringing people in.

Invite tracking depends on Discord’s available invite data, so some joins may still show as unknown. For example, vanity URLs, expired invites, deleted invites, or joins that happened while the bot was offline can limit attribution. Housekeeper still records the outcome clearly so staff can tell the difference between known and unknown activity.

Housekeeper can send a private welcome message when a new member joins. The welcome message supports Discord Markdown and server-specific placeholders such as the server name and member mention.

This gives communities a cleaner first impression than a short public auto-message. A private welcome DM can explain the server vibe, remind members about expectations, point them toward the right place to start, and make the community feel more intentional.

Admins can preview the current welcome message with:

/welcome

Admins with the right permission can view or update the welcome message with:

/welcome-message view
/welcome-message update

For longer edits, Housekeeper also supports Markdown-based message templates, making it easier to keep user-facing copy organized and editable.

Housekeeper is configured through /setup, so server admins do not need to edit files or restart the bot just to change normal server settings.

The setup flow can configure:

• The join and leave log channel.
• Whether private welcome DMs are enabled.
• An optional default role for new members.
• An optional Wipe Planner role for trusted Rust wipe organizers.

Run:

/setup

The interactive panel guides the admin through the available choices. Admins can also pass options directly when they already know what they want to change.

Housekeeper validates common problems when possible, such as missing channel access, role hierarchy issues, or permissions needed for role assignment.

Housekeeper includes a full Rust wipe planning workflow for gaming communities that coordinate wipe days, team limits, private channels, reminders, and last-minute server details.

The Rust wipe system is designed for communities that need more structure than a normal event post. It can start a guided setup, create a Discord poll, track who voted to join, enforce a join limit, waitlist extra players, prepare a private channel, send participant DMs, post final server details, and clean up the channel after the event.

Start with:

/rust-wipe create

Housekeeper walks the organizer through the required information, including server name, poll channel, close time, wipe time, join limit, and ping mode. The bot supports saved presets for repeated servers or event formats, so organizers can reuse common settings instead of entering everything from scratch each time.

Rust wipe commands include:

/rust-wipe create
/rust-wipe status
/rust-wipe preset-save
/rust-wipe preset-list
/rust-wipe preset-delete
/rust-wipe roster
/rust-wipe prepare
/rust-wipe details
/rust-wipe close
/rust-wipe invite
/rust-wipe refresh-permissions
/rust-wipe remove
/rust-wipe cleanup

The wipe workflow can:

• Create native Discord polls.
• Close polls manually, on schedule, or when the join limit fills.
• Create or reuse a private wipe channel.
• Grant access to accepted players.
• Preserve manual invites.
• Keep removed players excluded from future poll sync.
• Track waitlisted players when a limit is reached.
• Post final server IP and wipe information in the private channel.
• DM participants with useful timing and channel details.
• Send reminders before wipe time.
• Archive or schedule deletion for finished channels.

This makes Housekeeper especially useful for Rust groups that want organized events without repeatedly rebuilding channels, permissions, rosters, and reminders by hand.

Not every Rust wipe organizer needs broad server-management permission. Housekeeper supports a dedicated Wipe Planner role so trusted members can run Rust wipe commands without needing full server admin access.

The role can be selected or created from /setup. Once configured, members with that role can use the Rust wipe planning tools while other server-management features remain protected.

This keeps responsibilities focused: server admins control setup, while trusted event organizers can run the wipe workflow.

Housekeeper also includes a web admin panel for bot owners and approved admins. The panel gives an organized view of connected servers, server settings, invite analytics, Rust wipe events, message templates, access management, logs, and operational status.

From the admin panel, approved users can manage supported settings, inspect invite activity, edit message templates with preview support, and perform Rust wipe actions from a browser instead of Discord.

The admin panel is especially helpful for larger communities or hosted deployments where the bot owner wants a clearer operational view than Discord commands alone can provide.

Housekeeper keeps many longer user-facing messages in Markdown templates. This makes the bot easier to customize without changing Python code.

Template-backed messages include welcome DMs, bot invite thank-you DMs, setup panel copy, invite stats output, Rust wipe poll messages, participant DMs, reminder messages, roster output, cleanup notices, and more.

This is useful for communities that care about tone. A gaming community, private friend server, creator community, or staff-run server can adjust the language to match its own style while keeping the bot behavior consistent.

Housekeeper asks for permissions based on the features you want to use.

Core features commonly need:

• View Channels
• Send Messages
• Embed Links
• Manage Server
• View Audit Log

Rust wipe planning can also need:

• Create Polls
• Manage Channels
• Manage Messages
• Mention Everyone, only when using @here or @everyone ping modes

Role features can also need:

• Manage Roles

Housekeeper also requires the Server Members Intent so it can detect member joins and leaves.

Some permissions are only required for specific features. For example, role management is only needed if you want default-role assignment or want Housekeeper to create the Wipe Planner role.

/setup
/welcome
/welcome-message view
/welcome-message update
/invite-stats
/rust-wipe create
/rust-wipe status
/rust-wipe preset-save
/rust-wipe preset-list
/rust-wipe preset-delete
/rust-wipe roster
/rust-wipe prepare
/rust-wipe details
/rust-wipe close
/rust-wipe invite
/rust-wipe refresh-permissions
/rust-wipe remove
/rust-wipe cleanup

Housekeeper is a good fit for:

• Discord communities that want reliable join and leave logs.
• Server owners who want better invite visibility.
• Private communities that care about trusted growth.
• Gaming groups that organize recurring events.
• Rust communities that coordinate wipe days.
• Servers that want private welcome DMs instead of cluttered public greetings.
• Admin teams that prefer guided setup over manual config editing.
• Bot owners who want a web panel, logs, and operational visibility.
• Communities that want user-facing bot messages to be editable and polished.

Housekeeper is not trying to be a massive moderation suite with every possible feature. It is built around practical server operations: onboarding, invite visibility, setup, message customization, event planning, and admin visibility.

Housekeeper helps server teams spend less time repeating the same setup and coordination tasks.

Instead of manually checking invites, posting welcome instructions, creating wipe polls, copying player lists, setting channel permissions, reminding participants, and cleaning up old event channels, Housekeeper handles the workflow in a consistent way.

It keeps the day-to-day server work calmer:

• New members are welcomed privately.
• Staff can see where joins came from.
• Admins can configure the bot from Discord.
• Rust wipe organizers can run events without full admin access.
• Participants get private channels and reminders.
• Old wipe channels can be archived or scheduled for deletion.
• Message wording stays editable.
• Bot owners can review logs and connected-server activity from the web panel.

For communities that want a cleaner, more organized Discord experience, Housekeeper is a steady operations assistant that keeps the routine work moving in the background.