Jinx is a Discord bot that grants roles to users in your server when they register Jinxxy license keys. Note that Jinx is not affiliated with Jinxxy: this is an independent project.
Important
Click here to add the bot to your server
(and then go follow the installation instructions)
Features include:
- Licenses can only be activated by a single Discord user.
- The server owner can deactivate a license. This may be useful if a buyer needs to change Discord accounts and wants to move the license over.
- Jinx can log license activations and suspicious activity to a Discord channel.
- Ability to lock a license, preventing it from being used to grant roles in the future.
- Flexible role configuration
- Products can grant more than one role at a time. For example, you might have a shared role that all buyers get and then additional per-product roles.
- No limit on number of linked products or roles. (Some similar bots support a maximum of 25 products due to a certain Discord limitation).
If you have suggestions, feedback, or bug reports please let us know here on GitHub or in our Discord.
A user clicks the "Register" button:
Next, the user is presented with a prompt to enter a license key:
Finally, if a valid license was provided then the user is granted any roles associated to their product. A confirmation message is shown:
Important
Click here to add the bot to your server
(if you haven't already done so)
When installing the bot, a "jinx" role will be automatically created in your server. You must ensure sure the "jinx" role is listed above any roles you want Jinx to manage. For example, in the screenshot below Jinx can only manage "test-secret-role" and "test-secret-role-2".
Next, go to Jinxxy's API Keys page and create a new API key with products_read, licenses_read, and licenses_write (see explanation of permissions to learn why we need these). Uncheck the expiration checkbox. Make note of the API key when you create it: we'll need it shortly. The form should look like this:
Finally, back in your Discord server run the following slash commands:
- Run the
/init <api_key>command in your Sever and provide your API key. This is one-time setup. - Optionally, run
/set_log_channel [channel]to tell the bot which channel to log events (such as license activations) to. (You can re-run this command without a channel if you wish to unset your log channel later). - Run the
/link_productcommand for each Jinxxy product you want to link to a role. Products can grant multiple role: run the command more than once to create more links as needed. If you make a mistake, use/unlink_productto fix it. - Check your work using
/list_links - When you're ready, run
/create_postin the channel of your choosing to have Jinx create a button users can click to register license keys. You may create multiple posts this way. If you update your Jinxxy username or profile picture you may want to delete and recreate the post, as it will not automatically update.
I recommend testing everything with a test license. You can create a 100% discount code or create an unlisted free product to create test license keys.
You may also wish to self-host this bot. Self-hosting instructions are provided, but the process is moderately technical.
Jinx comes with several slash commands for server administrators and moderators.
| Command | Required Permission | Description |
|---|---|---|
/init [api_key] |
Manage Server | Set up Jinx for this Discord server. |
/set_log_channel [channel] |
Manage Server | Set (or unset) channel for bot to log to. |
/link_product <product> <role> |
Manage Roles | Link a product to a role. Activating a license for the product will grant all linked roles. |
/unlink_product <product> <role> |
Manage Roles | Unlink product from roles. |
/list_links |
Manage Roles | List all product→role links. |
/create_post |
Manage Roles | Create post with buttons to register product keys. |
/user_info <user> |
Manage Server | Query license information for a Discord user. |
/license_info <license> |
Manage Roles | Query activation information for a license. |
/lock_license <license> |
Manage Roles | Lock a license, preventing it from being used to grant roles. |
/unlock_license <license> |
Manage Roles | Unlock a license, allowing it to be used to grant roles. |
/deactivate_license <user> <license> |
Manage Roles | Remove a user's activation of a license. This does not remove roles! |
/stats |
Manage Server | Display aggregate statistics on license activations |
/version |
None | Shows version information about Jinx. |
/help |
None | Shows help information about Jinx. |
Tip
- The required permission/role for a command can be customized in the server's Integration settings.
/user_infocan also be used from the context menu: look for "Apps"/"List Jinxxy licenses" when you right-click a user in your server.
jinx is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
jinx is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
A full list of dependencies is available in Cargo.toml, or a breakdown of dependencies by license can be
generated with cargo deny list.
The publicly installable bot provided by us is available under our Terms of Service and Privacy Policy.