A bot that helps out owners of Minecraft: Bedrock Edition Realms by showing various statistics related to player join/leaves. It's: - 🚀 **Fast:** Under the right (and typical) circumstances, it can send a list of ~300 players in under 2 seconds, most of which (~1.5 seconds) is spent just sending messages to Discord. - 📊 **Informative:** The main feature of the bot, the playerlist, can give a detailed log of players on a Realm at a moment's notice. You can also get a breakdown for an individual player to analyze as you wish. - 👌 **Easy to Use**: Simply add the bot, link your Realm, and you already have join/leave tracking enabled - no need to use your Xbox account for the bot's features. Take a look at the [Server Setup Guide](https://playerlist.astrea.cc/wiki/server_setup) for more information. - 🔓 **Open Source**: The code is available to the public and able to be audited and learned from. Dedicated users can even self-host the bot, if they wish. ## Features ### The Playerlist Of course, this is the main feature of the bot. It's also one of those features that is easier to show than tell: Picture of how the playerlist looks like.

Picture of how the playerlist looks like.

The censored space are gamertags of users on the Realm.

The command version allows you to get who was on the Realm up to the last 24 hours (though it defaults to 12 hours). There is also an automatic version that runs every hour in a specified channel (as seen in the picture) - it displays a list going back an hour, every hour. The command can normally only be run by people with Manage Server permissions (can be adjusted the same way you adjust other slash command permissions) and is not meant to be seen by normal people. However, normal users, by default, can run `/online`, which shows everyone who is on the Realm at that moment: Picture of how /online looks like.

### Specific Player Information You can also request for a breakdown of join/leaves (otherwise known as sessions) via `/get-player-log`: Picture of how /get-player-log looks like.

Picture of how /get-player-log looks like.

Using this command allows you to scroll through each session in an intuitive format. For fun, the command also displays their total playtime. By default, the command only goes back a day, but it can go till 7, as seen here. ### Realm Offline Notifications Realms go offline a lot if they're big, most likely because they can't handle the load. Sometimes, it can be useful to get pinged when that happens: Picture of how Realm offline notifications looks like.

Picture of how Realm offline notifications looks like.

Note: despite the role name used, this does not exclusively trigger when the Realm crashes.

This simply hooks onto your autorunning playerlist. The Realm offline detection is mostly accurate - it may not work as well for smaller Realms, but for larger ones, it should work fine. ### Playtime Leaderboard By using `/leaderboard` and either voting or purchasing Premium, you can get a ranked list of players by playtime for your Realm: Picture of how /leaderboard looks like.

Note: the playtimes are rounded for convenience, and so may be slightly off.

The period of time can be adjusted as needed - it can go all the way back to 30 days. ### Graphs You can make cool graphs about your Realm and its users: Picture on how graphs can looks like.

There are a variety of options to chose from, from the graph up above to a day-to-day breakdown. The data isn't 100% accurate, but you can use it to observe patterns... or just show it off for fun. ### Premium **Realms Playerlist Premium** allows for extra features that otherwise could not be provided by the bot without funding. [Take a closer look at Premium here.](https://playerlist.astrea.cc/wiki/premium) #### Live Playerlist Instead of making the bot send a summary of people on every hour, a **live playerlist** shows who joined and left a Realm every minute, basically making it a live join/leave logger. It looks something like this: Picture on how live playerlist looks like.

Picture on how live playerlist looks like.

This has a variety of uses, from statistical to moderation - it's really up to you what you do with this information. Some Realms use it both to narrow down subjects to a precise degree while also tracking active Realm times. Using Discord's search functionality, the possibilities are near endless. #### Live Online List Taking the live playerlist to its logical conclusion, a **live online list** is a message that constantly updates with the players currently on the Realm, as seen below: Animated picture on how the live online list looks like.

Animated picture on how the live online list looks like.

As of right now, this feature requires the live playerlist to also be enabled. #### Device Information Through an extra toggle, the bot can fetch and display device information whenever a user is online. This affects `/online`, the normal playerlist, and the live playerlist. For example, `/online` becomes this: Picture on how `/online` looks when the toggle is enabled.

Picture on how `/online` looks when the toggle is enabled.

This does slow the bot down a bit when fetching the device, and privacy settings may make some users not have information regardless, but can used as an extra moderation/statistical tool. This is also available as a toggle to non-Premium users of `/online` (and only `/online`) if they vote for the bot. #### Realm Session Export You can export your Realm's session data (a session being a period of time where the player was on a Realm, including when they joined and were last seen) for around the last 30 days to a CSV file, which can be opened in a spreadsheet program like Excel or Google Sheets. This can be used to make your own graphs (though some fiddling around will be needed), or just to have the data for yourself. Picture on how that data is sent.

## Adding The Bot If you wish to add this bot, just [use the Server Setup Guide on how to do so](https://playerlist.astrea.cc/wiki/server_setup). It'll give a basic rundown on how to set up the bot, as well as showing how to set basic options. ## FAQ There's a whole section in the wiki about this! [Check it out here](https://playerlist.astrea.cc/wiki/faq). *The Realms Playerlist Bot is not an official Minecraft product, and is not approved by or associated with Mojang or Microsoft.*

Voting for Realms Playerlist Bot