Engagement Setup and Shop

Engagement and Shop System Guide

Table of Contents

  1. Introduction

  2. Setting Up the Engagement System

  3. Managing the Engagement System

  4. Setting Up the Shop

  5. Managing Shop Items

  6. User Interactions with the Shop

  7. Admin Shop Management

  8. Best Practices and Tips

Introduction

This guide will walk you through setting up and managing the engagement system and shop functionality for your Discord server. These features allow you to reward active users with points and provide a shop where users can spend their earned points on various items or perks.

Setting Up the Engagement System

To start the engagement system for your server, use the following command:

This command has several options:

  • message-channel: Select a channel to track for engagement (required)

  • message-bonus: Set a percentage bonus for messages in this channel

  • notification-channel: Choose a channel for level-up notifications

  • base-required-xp: Set the base XP required for leveling up (default is 60)

  • points-name: Choose a name for your points currency (e.g., coins, gems)

  • points-per-xp: Set how many points users earn per XP

  • shop-enabled: Enable or disable the shop feature

Example usage:

Managing the Engagement System

Use the following commands to manage the engagement system:

  1. Give XP to a user:

  2. Remove XP from a user:

  3. View the server leaderboard:

  4. View users at a specific level:

  5. View a user's points:

Setting Up the Shop

The shop is enabled during the engagement setup. If you need to modify shop settings, you can run the /engagement-setup command again with updated parameters.

Managing Shop Items

Use the /shop-manage command to add, remove, or view shop items:

  1. Add a new item:

    For custom rewards:

  2. Remove an item:

  3. View all shop items:

User Interactions with the Shop

Users can interact with the shop using the /shop command. This will display available items, allow them to view item details, make purchases, and check their purchase history.

Admin Shop Management

As an admin, you have access to additional shop management features:

  1. View recent purchases:

  2. View purchases with custom rewards that need handling:

  3. Generate a report for a specific item:

Best Practices and Tips

  1. Start with a lower points-per-xp ratio and adjust as needed to balance your economy.

  2. Regularly review the leaderboard and user engagement to ensure the system is working as intended.

  3. Create a mix of role-based and custom rewards in your shop to cater to different user preferences.

  4. Use the custom rewards feature for special, manually-fulfilled items to add unique value to your shop.

  5. Periodically review shop items and their prices to maintain balance and user interest.

  6. Communicate clearly with your community about how the engagement system and shop work.

  7. Consider creating special events or promotions to boost engagement and shop activity.

Remember, you can always adjust settings by running the setup commands again with new parameters. Experiment to find what works best for your community!

Last updated