Discord Integration
PixelEast and Discord work together in two ways. Any member can link their Discord account to pick up roles and perks automatically, and creators can connect the PixelEast bot to their own server to announce sales, hand out customer roles and post product updates. This page covers both.
There's something here for everyone. The first half is for anyone with a PixelEast account. The second half is for creators who want to run the bot in their own Discord server.
Link your Discord account
Linking ties your Discord account to your PixelEast account so the bot can recognise you and manage your roles for you. It takes a few seconds and you can disconnect again at any time from the same page.
-
1
Open the Discord Link page in your profile.
-
2
Tick the consent box. We only read your Discord ID, username, avatar and email, and we never post messages on your behalf.
-
3
Click Connect with Discord and approve it on Discord. You are sent straight back, now linked.
Stay in the server. Roles and direct messages only reach you while you are a member of the server the bot lives in. If you leave, the bot can no longer give you roles or message you there.
What linking unlocks
Once your account is linked, everything below happens on its own. There is nothing else to set up.
Customer roles, automatically
Buy a product from a creator who runs the bot, and you get their customer role in their server without having to ask.
Your PixelEast roles
You get your member role on the official PixelEast server, plus a creator role if you sell here.
Update alerts
When a creator you bought from ships a new version, their announcement can ping the customer role you hold.
Community perks
Be eligible for giveaways and exclusive member perks across the community.
Open a profile straight from Discord
Once your account is linked, anyone can pull up your PixelEast profile straight from Discord. Right-click a member (or open the Apps menu on one of their messages), choose PixelEast and then Profile, and the bot replies with a tidy card showing their avatar, their creator stats (products, sales and downloads), the date they joined, and a button that opens their full PixelEast page. The reply is only visible to the person who asked.
It works in every server the PixelEast bot is in, and only for members who have linked their account, which is one more good reason to link yours. A member who has not published anything just shows their join date, and if someone has not linked at all, the bot simply says so.
The PixelEast bot for creators
If you sell on PixelEast you can run our bot in your own Discord server. It announces your sales, gives buyers a customer role the moment they purchase, and posts your product updates to a channel of your choice. You manage all of it from the PixelEast Bot page in your creator dashboard.
Need channel and role IDs? Turn on Developer Mode in Discord (Settings › Developer), then right-click any channel or role and choose Copy ID. That is the long number the bot settings ask for.
Connect the bot to your server
-
1
Open the PixelEast Bot page in your dashboard and start the setup. You will be sent to Discord to pick the server you want to add the bot to.
-
2
Approve the invite. The bot needs the Manage Roles permission, and its own role has to sit above any role you want it to hand out (see Keeping the bot healthy).
-
3
Back in the dashboard you will see Bot Connected with your server name. From here you can set up everything below.
Sale notifications
Get told the moment one of your products sells. Open Sales notifications on the bot page, turn the feature on, and choose how you want to hear about it. You can use either option or both.
Direct message
The bot DMs you on every sale. This needs your own Discord account linked, and you have to be a member of the server the bot is in so it can reach you.
Post to a channel
The bot posts each sale in a channel in your server. Give it a Channel ID, and optionally a Ping Role ID to alert when a sale lands.
Detailed or compact
Turn Detailed message on for a full card with the product image, buyer avatar and fields, or off for a single tidy line.
Automatic roles on purchase
Under Product Role Assignments you can tie each paid product to a Discord role. When someone buys it, the bot gives them that role in your server, so a customer list and access to buyer-only channels build themselves.
Pick the role from the dropdown, which lists the roles the bot is allowed to assign. For the buyer to actually receive it they need their Discord account linked and to be a member of your server.
Paid products only. A role can only be mapped to a product with a price. Free products do not assign a role.
Product update announcements
Each product has its own Notify settings. Turn notifications on, give it a Channel ID to post in, and optionally a Ping Role ID so the right buyers get a heads-up. When you publish a new version, the bot announces it for you.
Write your own message template and drop in any of these placeholders. The bot fills them in for each release:
| Placeholder | Replaced with |
|---|---|
{version}
|
The version number you just published, for example 2.4.0. |
{product}
|
The name of the product that was updated. |
{date}
|
The date the version went live. |
{changelog}
|
The changelog you wrote for the new version. |
You can also set a custom image for the announcement. If you do not, your profile picture is used. The dashboard shows a live preview of exactly what gets sent to Discord before you save.
Keeping the bot healthy
Almost every problem comes down to permissions or the role order. Three things to keep right:
- The bot's role sits above every role it assigns. Discord will not let a bot manage a role placed higher than its own.
- The bot keeps the Manage Roles permission, and can see and post in the channels you gave it.
- Buyers have linked their Discord account and are members of your server, otherwise there is no one for the bot to give a role to.
The bot page has a Bot Errors panel that logs anything that went wrong, such as a missing role, a permission problem or a member it could not find, so you can spot and fix issues quickly.
Need a hand?
If the bot will not assign a role or a notification does not arrive, our team is happy to help. Open a ticket or ask in our Discord and we will take a look.