Welcome!

Here you’ll find everything you need to get started with hope, from setup guides and command lists to feature explanations and troubleshooting tips.

Here you'll find...


  • A full overview of hope’s commands

  • In-depth explanations and usage examples

  • Setup and permission guides

  • Feature details and customization options


Command Overview

giveaways – manage giveaways with options to start, edit, reroll, end, and more.
auto pfps – set up channels that automatically post pfps from selected sources.
ping on join – configure automatic pings when users join the server.
welcome dm – send personalized welcome messages to new members.
confessions – create anonymous confession channels for your community.
stats joins – view and track join and stay statistics for your promos.
photo tracking – track image or media uploads in selected channels.
purge – bulk delete messages with filters for users, bots, media, and more.
pruning – remove inactive members based on join date, age, or role.
mod logs – log server activity such as joins, leaves, and message changes.
promo tracking - track the quality of a promo you've bought.
sticky messages - stick and unstick messages to your channels.
nuke – clone and reset a channel while keeping the same permissions.
snipe – retrieve recently deleted or edited messages.
Something you'd like to add? Leave a suggestion in our support server !

Giveaways

/giveaway start – start a new giveaway with custom settings.
/giveaway quick – create a simple giveaway with default options.
/giveaway edit – modify an existing giveaway’s details.
/giveaway end – end a running giveaway early.
/giveaway reroll – reroll winners for a completed giveaway.
/giveaway show-wins – view a user’s previous giveaway wins.
/giveaway entries-roles add – give a role bonus entries in a giveaway.
/giveaway entries-roles list – view all roles with bonus entries.
/giveaway entries-roles remove – remove a role’s bonus entries.
/giveaway preset create – make a reusable preset for faster giveaway setups.
/giveaway preset start – start a giveaway using one of your saved presets.
back to commands

Auto PFPs

/posts create – set up an auto-pfp channel that posts images from a chosen theme.
/posts list – view all channels currently configured for auto-pfp posting.
/posts delete – remove an existing auto-pfp setup from a channel.
back to commands

Ping on Join

/poj set-token – connect your own Discord bot token to Hope (required).
/poj add – add a channel where new joins will be pinged.
/poj delete – remove a POJ channel.
/poj list – view all configured POJ channels.
/poj test – send a test ping to confirm setup works.


POJ Setup (step-by-step)1) Create a Discord bot at the Developer Portal and copy its token.
2) In your server, run /poj set-token and paste the token.
3) Invite your bot to the server (give it the permissions it needs to ping and post).
4) Run /poj add and choose the channel you want pings to appear in.
5) Run /poj test to make sure everything is working.
6) If needed, /poj list to review, and /poj delete to remove a channel.
Free vs Premium:
• Free: up to 3 POJ channels, clustering required (joins are grouped and pinged every ~5 minutes).
• Premium: up to 15 POJ channels; clustering optional until 5 channels, required after 5.
Important:
• POJ will NOT work unless you set your own bot token with /poj set-token.
back to commands

Welcome Dm

/welcome set-token – connect your own Discord bot token to Hope (required).
/welcome set – create or edit the message that gets sent to new members.
/welcome test – send a test message to make sure everything is working.
/welcome remove – disable the welcome DM feature for your server.


Welcome DM Setup (step-by-step)1) Create a Discord bot in the Developer Portal and copy its token.
2) In your server, run /welcome set-token and paste the token.
3) Run /welcome set to write the message new members will receive.
4) You can test it anytime using /welcome test.
5) To stop sending DMs, run /welcome remove.
Important:
• The Welcome DM feature is Premium only.
• All DMs are moderated to prevent abuse or ToS violations.
• Staff review messages daily. Access will be revoked if misused.
back to commands

Confessions

/confession-channel – set the channel where confessions will be sent.
/confess – send an anonymous confession message.
Staff Moderation (via Discord menu)
Banning/unbanning isn’t a slash command. Use Discord’s interactive menu:
1) Find the confession (the embed)
2) Right-click the embed (or tap/hold on mobile)
3) Go to Apps → Hope → Confessions
4) Choose Ban from Confessing or Unban from Confessing
5) You’ll get a confirmation in Discord after the action


Confessions Setup (step-by-step)
1) Run /confession-channel and select the channel where confessions should appear.
2) Make sure the bot has permission to send messages and embeds in that channel.
3) Users can now submit confessions using /confess.
Important:
• Staff do not see who sends confessions.
• Misuse or harassment through the system may result in the feature being disabled for your server.
back to commands

Stats Join

/stats joins – view detailed join and engagement statistics for your server.


How It WorksJoins – counts all new members joining your server.
Leaves – tracks users who have left.
Engaged – users who have spoken since joining.
Net – shows the number of members who stayed after joining.
Retention rate – calculates how many users remain active after a promo or invite.
Use this to measure the effectiveness of invites, promos, or events.


How To Use1) Run /stats joins in any channel where Hope has permission to reply.
2) Choose a time frame (day, week, month, or all-time).
3) Review the breakdown for joins, leaves, engaged, and net.
You can use this data to see your peak join time and invites throughout the time frame.back to commands

Upload Tracking

/uploads – view your upload statistics in servers where Hope is active.


Upload Tracking OverviewThis feature tracks how many times you’ve uploaded images or media in specific channels, especially icon or pfp-related ones.
It’s useful for uploaders who want to monitor their activity and consistency over time.


How To Use1) Run /uploads in any channel where Hope has permission to respond.
2) Hope will show your total uploads and the number of deleted uploads (if any).
3) Results are private - only visible to the user who runs the command.
Important:
• This feature is meant for uploaders, not staff moderation.
• Data resets if Hope is removed from the server.
back to commands

Purge

/purge all – delete every message in the channel.
/purge between – delete messages between two specific message IDs.
/purge user – delete messages from a specific user.
/purge text – delete only text messages.
/purge images – delete messages containing images.
/purge videos – delete messages containing videos.
/purge files – delete messages with file attachments.
/purge stickers – delete messages with stickers.
/purge audio – delete messages with audio files.
/purge bots – delete messages from bots.
/purge humans – delete messages from users (not bots).
/purge embeds – delete messages containing embeds.
/purge invites – delete messages containing invite links.
/purge links – delete messages containing URLs.
/purge includes – delete messages containing a certain word or phrase.
/purge ends-with – delete messages ending with a certain word or phrase.
/purge match – delete messages that exactly match a given phrase.
/purge not-match – delete messages that do not match a given phrase.
/purge mentions – delete messages containing user mentions.


How It WorksThe purge command is used to clean up channels by removing unwanted messages.
You can target specific message types (like media or bot messages), certain users, or words.
Hope performs all deletions safely within Discord’s rate limits to prevent API errors.


How To Use1) Run the purge command of your choice in the desired channel.
2) Confirm Hope has permission to manage messages.
3) Use filters or specific subcommands to narrow your deletion.
Warnings:
• This action is irreversible — deleted messages cannot be recovered.
• Hope must be whitelisted in any automods or anti-spam systems for purge to work properly.
back to commands

Prune

/prune age – remove users with accounts younger than a set number of days.
/prune days – remove users who joined within a certain number of days.
/prune role – remove users with a specific role.


How It WorksThe prune feature is used to clean up servers by kicking inactive or unwanted members.
You can target users by how long they’ve been in the server, when their account was created, or by specific roles.
Pruning helps keep member lists accurate and maintain server quality.


How To Use1) Run the appropriate prune command for your situation.
- Use /prune age to remove new accounts (often used to combat raids).
- Use /prune days to remove users who joined recently.
- Use /prune role to remove users with a certain role.
2) Confirm Hope has permission to kick members.
3) Double-check your filters before confirming - pruning cannot be undone.
Important:
• Hope must be whitelisted in any automod or verification bots.
• This command permanently removes members; there’s no recovery once confirmed.
back to commands

Logs

/logs member join – log whenever a user joins your server.
/logs member leave – log whenever a user leaves your server.
/logs message delete – log deleted messages.
/logs message update – log edited messages.


How It WorksHope’s logging system records important server events in a channel you choose.
It helps staff keep track of activity such as joins, leaves, deletions, and edits for moderation or safety purposes.
Each event appears in an embed that includes timestamps and user details for clarity.


How To Use1) Create or choose a private staff channel for logs.
2) Run the log command for the event you want to track.
- Example: /logs member join to log new members joining.
3) Repeat for other events you want enabled (leaves, deletes, edits).
4) Make sure Hope has permission to send messages and embeds in the log channel.
Tips:
• Keep logs in a staff-only area to prevent clutter.
• You can disable logs anytime by re-running the same command.
back to commands

Promo Tracking

/promo create – start tracking a new promo or campaign.
/promo track – link an invite to a specific promo for tracking.
/promo list – view all active promos being tracked.
/promo stats – view performance stats for a specific promo.
/promo end – stop tracking a promo or mark it as finished.


How It WorksHope’s promo tracking system helps you monitor invite performance and engagement.
It calculates quality, retention, and cost efficiency to show which promos are truly valuable.
Each tracked promo collects data such as joins, leaves, re-joins, and cost per stay.


How To Use1) Run /promo create to start a new tracking campaign.
2) Add an invite link using /promo track so Hope knows which invite to monitor.
3) Use /promo list to see all active campaigns and their IDs.
4) Run /promo stats followed by a promo ID to view detailed performance results.
5) Once you’re done, use /promo end to stop tracking that campaign.
Tracked Data Includes:
• Joins and leaves
• Engagement rate
• Retention and re-joins
• Cost, cost per join, and cost per stay
Tip: Promo tracking is ideal for comparing sellers, events, or join sources to identify what actually benefits your server.back to commands

Sticky Messages

stick message – manage sticky messages using Discord’s built-in interaction menu.


How It WorksSticky messages are created through Discord’s interactive menu, not slash commands.
When you send a message you want to “stick,” right-click it (or tap and hold on mobile),
go to Apps → Hope → Stick Message, and Hope will handle the rest.
Hope immediately confirms that the message has been added as your sticky message.
After about a minute, your original message is deleted, and Hope resends it using the bot’s account - making it a proper sticky message.
From then on, the sticky message automatically reappears one minute after someone types in the channel.
If another person sends a message before the minute is up, the timer resets, ensuring the sticky never spams.

back to commands

Nuke

/nuke – completely reset a channel while keeping the same permissions.


How To Use
1) Run /nuke in the channel you want to reset.
2) Hope will delete the existing channel and immediately clone it with all permissions and roles intact.
Notes:
• All messages in the original channel will be permanently deleted.
• Channel permissions, slowmode, and position in the category will stay the same.
• Make sure Hope has Manage Channels permission to complete the process.
back to commands

Snipe

/snipe – view the most recent deleted or edited message in a channel.


How To Use1) Run /snipe to view the last deleted message.
2) To see an edit instead, select the “edited” option before submitting the command.
3) Hope will display the message content, author, and timestamp.
Notes:
• Hope must have Read Message History permission.
• Only the most recent deleted or edited message is stored per channel.
• Snipes automatically clear after a short time for privacy and performance reasons.
back to commands

Credits

Hope was created with care to make Discord management smoother, cleaner, and a little more fun.
This page highlights the people and resources that helped bring Hope to life.
Development
Lead Developer(s): Lars & Jae
Design & Branding
Site & Documentation Design: Jae
Brand Inspiration: Hope’s signature pink theme inspired by simplicity and usability.
Icon Designer: @asaqin_
Special Thanks
To every server owner, moderator, and tester who supported Hope through development and updates - your feedback made all the difference.
Links
Invite Hope
Support Server
Main Website
back to home

Contact

Need help, found a bug, or have a question about Hope?
We’re here to help you get the most out of your experience.


Support Server
Join the official Hope support server for help, updates, and community feedback:
Join Support Server
Report an Issue
If something isn’t working correctly, please open a support thread in the Discord server.
Include as much detail as possible - what command you used, what you expected, and what happened instead.


Suggestions
We’re always open to new ideas!
You can share suggestions or feature requests in the suggestions channel of the support server.
back to home