ShadowBoost
Reward your Discord Nitro boosters automatically, in game.
- Version
- 2.2.1
- Resource
- SF-Boost
Overview#
SF-Boost connects to your Discord server through a bot, checks whether the player holds the booster role, and hands out the rewards you configured. Money, items, experience or fully custom rewards, with a cooldown so the same player cannot claim twice. Inventory support is detected automatically across the main frameworks.
Automatic booster check
The bot reads the roles of the player on your Discord and confirms the boost.
Configurable rewards
Money, items, experience or a custom reward, alone or combined.
Claim cooldown
Twenty-four hours by default, so a booster claims once per day.
Modern interface
A clean panel showing the boost status and what is available to claim.
Inventory detection
Detects ox_inventory, qs-inventory and qb-inventory without any configuration.
Discord logging
Every claim is posted to a webhook with the player and the reward.
Dependencies#
| Resource | Required | Why |
|---|---|---|
OneSync | Yes | Declared as a hard dependency in the manifest. |
Discord bot | Yes | A bot token is needed to read the roles of your members. |
Installation#
- Drop the SF-Boost folder into your server resources directory.
- Create a Discord application, add a bot to it and copy its token.
- Invite the bot to your Discord server. It needs permission to read members and their roles.
- Fill in the bot token, your guild ID and the booster role ID in config.lua.
- Define your rewards, then add the ensure line to your server.cfg and restart.
ensure SF-BoostConfiguration#
| Key | Default | What it does |
|---|---|---|
Config.discordToken | — | Token of the bot that reads the roles. Keep it server-side only. |
Config.guildId | — | ID of your Discord server. |
Config.boosterRoleId | — | ID of the role given to Nitro boosters. |
Config.cooldown | 86400 | Delay in seconds between two claims, 24 hours by default. |
Config.rewards | — | The list of rewards: money, items, experience or custom. |
Config.inventorySystem | 'auto' | Force an inventory, or leave auto-detection on. |
Config.discordInvite | — | Invitation link shown to players who are not on the Discord yet. |
Config.language | — | Language of the interface and the messages. |
Config.enableLogs | — | Enables Discord logging of claims. |
Config.logWebhook | — | Webhook URL that receives the claim logs. |
Commands#
| Command | Permission | What it does |
|---|---|---|
/boost | — | Open the boost panel and see the available rewards. |
/claimboost | — | Claim the reward directly, without opening the panel. |
/discord | — | Show the invitation link to your Discord server. |
/resetcooldown [id] | Admin | Reset the cooldown of a player. |