The all-in-one
EarthMC Bot
Succeed on EarthMC with EMCHub!
Has access to Player info, Town info, Nation info
Newday info, map tracker and more!
EMCHub Commands
All available commands for the bot
/alliance query nameGet information about an alliance
Alliance name or tag
/alliance requestRegister your alliance / edit your alliance
/a nameGet information about an alliance
Alliance name or tag
/api guideHow to create an API key
/api link keyLink your in game API key to the bot
The API key
/api unlinkUnlink your in game API key from the bot
/bal economy categoryGet the average & total balance of players, towns or nations
Choose the category to display
/bal top categoryGet top 100 richest players, towns or nations
Choose the category to display
/bal wealth type nameSee the total wealth for a player, town, or nation
Choose what to analyze
Exact name of the selected type
/chart online category blankCharts for currently online players
Choose the category to display
Transparent chart background
/chart players category blank dateCharts for all existing players
Choose the category to display
Transparent chart background
Format: MM/YYYY - MM/YYYY or MM/YYYY-MM/YYYY
/chart nations category blankCharts for all existing nations
How to rank or group nations
Transparent chart background
/chart towns category blankCharts for all existing towns
How to rank or group towns
Transparent chart background
/forsale all sort_by filter_byShow all towns that are for sale
Sort towns by price, balance, size, or registered date
Filter towns by status flags (capital, open, snipeable, peaceful)
/forsale near town radius sort_by filter_by[Premium] Show towns for sale near a given town
Reference town name
Search radius in blocks (default: 2500)
Sort towns by price, balance, size, or registered date
Filter towns by status flags (capital, open, snipeable, peaceful)
/list towns sort_byList all towns, can sort by balance, size, residents, or registration date
Sort towns by balance, residents, size, or registration date
/list nations sort_byList all nations, can sort by balance, towns, size, residents, or registration date
Sort nations by balance, towns, size, residents, or registration date
/list alliances sort_byList all alliances, can sort by towns, nations, residents, chunks, balance, puppets, or worth
Sort alliances by towns, nations, residents, chunks, balance, puppets, or worth
/list overclaimable sort_by nation[Premium] List towns that are overclaimed without an overclaim shield
Sort towns by balance, residents, size, or registered
Filter by nation name
/list overclaimableshield sort_by nation[Premium] List towns that are overclaimed with an overclaim shield
Sort towns by balance, residents, size, or registered
Filter by nation name
/list npcs sort_byList all NPCs, their towns, town size, and balance
Sort by chunk size or town balance
/map nation nation colour opacity outlineCreates a map of towns in a given nation
Nation name
Colour for the towns
Colour opacity (0-100)
Draw black outline around nation border (default: true)
/map blank nation colour opacity outlineCreates a map with only the towns on a transparent background
Nation name
Colour for the towns
Colour opacity (0-100)
Draw black outline around nation border (default: true)
/map range nation sizeCreates an invite range map of a given nation
Nation name
Border size multiplier (1-5, default 1)
/map multi nations colours opacity blank outline[Premium] Creates a map with multiple nations and colours
Nation names separated by commas
Colours for the nations, separated by commas
Colour opacity (0-100)
Generate nations on a transparent background
Draw black outline around nation border (default: true)
/mmShow the top 50 Mystery Masters with their ranking changes
/nation query nationGet information about a nation
Nation name (optional - uses your linked account if not provided)
/nation activity nationShows which players from a nation are online and when others were last active
Nation name
/nation invitable nationShows towns that can be invited to your nation
Nation name
/nation compare nation1 nation2Compare statistics between two nations
First nation name
Second nation name
/nation checkup nation[Premium] Check nation towns for overclaim risks, mayor activity, and neighbor threats
Nation name
/nation gdp nationNation GDP breakdown including nation balance, capital, residents, and towns
Nation name
/n nationGet information about a nation
Nation name (optional - uses your linked account if not provided)
/newday filter_by sort_by include_allGet all towns about to fall
Filter towns by their status
Sort by chunk size or town balance
Include all towns from the JSON data; includes towns that may fall within 10 days
/online leadersNation leaders currently online
/online mayorsTown mayors currently online
/online nation nationResidents online in a given nation
Nation name
/online playersAll players currently online
/online staffSee all staff currently online
/online town townResidents online in a given town
Town name
/online townlessTownless players currently online
/online wealthyTop 30 richest online players
/res playerGet information about a player
Player name; if omitted, uses your linked Minecraft account
/resident position playerPosition of the resident, if online and visible on the map
Player name
/resident trusted playerList towns that trust a given player
Player name
/resident track player[Premium] Tracks a resident if online and visible on the map, updates every 5 seconds for 5 minutes
Player name
/resident track-stop[Premium] Stops your current resident tracking session
/resident query playerGet information about a player
Player name; if omitted, uses your linked Minecraft account
/resident lookup queryLookup an account by Discord ID, Minecraft UUID, or Minecraft username
Discord ID, Minecraft UUID, or Minecraft username to lookup
/resident seen playerCheck when a resident was last online
Player name
/resident outlawed playerList towns that have outlawed a given player
Player name
/resident purge town nation multi[Premium] Show residents close to purging (10 days or less)
Town name to check for residents close to purging
Nation name to check for residents close to purging
Multiple Towns/Nations separated by commas
/settingsManage your server settings in one panel
Notifications
/settings Rain/settings New Day/settings Vote Party/settings New Player/settings Town DeletedInfo Cards
/settings Townless Online/settings Staff Online/settings Nation Activity/settings Nation Checkup/settings Nation GDP/settings-user-notificationsManage your DM notification settings
/settings-user-notifications Rain/settings-user-notifications New Day/settings-user-notifications Vote Party/settings-user-notifications New Player/settings-user-notifications Town Deleted/settings-user-setprivate enabledMake your command responses private or not
Enable or disable private command responses
/shop all sort filter rangeList every shop slot from the API
Order listings by stock status
Filter by price per stack or trade stack size (use range)
Min to max for the selected filter (eg: 1-64. 100-2000)
/shop statsAggregated stats for your shops
/staff all roleList all staff for EMC
Filter by specific role
/staff onlineSee all staff currently online
/staff activityView staff activity for the last 32 days
/stats meView your own command usage statistics
/stats top limitView top command users
Number of top users to show (1-20)
/stats user user[Premium] View command usage statistics for a specific user
The user to view statistics for
/town query townGet information about a town
Town name; if omitted, uses your linked Minecraft account and shows your town
/town threats town radiusGet recently founded towns within a certain radius of a specified town
Town name
Radius in blocks (default is 1000)
/town perms sort_by filter_by perm_type openList towns with perms enabled
Sort towns by balance, residents, size, or registered
Filter towns by perms (Resident, Nation, Ally, Outsider, All)
Show towns that have a specific perms type enabled
Only display towns that are open
/town flags sort_by filter_byList towns with specific flags enabled
Sort towns by balance, residents, size, or registered
Filter towns by flags (PVP, Explosion, Fire, Mobs)
/town activity townShows which players from a town are online and when others were last active
Town name
/town compare town1 town2Compare statistics between two towns
First town name
Second town name
/town joinable townShow nations that can be joined from a specific town
Town name
/t townGet information about a town
Town name; if omitted, uses your linked Minecraft account and shows your town
/townlessTownless players currently online
/changelogLink to the EMCHub changelog (bot and website updates)
/help sectionDisplays available commands with detailed information
Get detailed help for a specific section
/linksUseful links relating to EarthMC
/statusSee server status, vote party counter & time until new day
/supportAn invite to the EMCHub Support Server
/votepartyShows the current vote party progress
/watch add player notification channel language[Premium] Add a player to your watch list
Player name to watch
How to receive notifications
Channel to send notifications to (only if notification type is channel)
Language for notifications (en, zh, tr, ja)
/watch remove player[Premium] Remove a player from your watch list
Player name to stop watching
/watch list[Premium] Show your current watch list
/watch activity[Premium] Show activity of watched players for the past 7 days
EMCHub FAQ
Frequently asked questions for EMCHub
What is EMCHub?
EMCHub is a powerful Discord bot and website focused primarily on the EarthMC server. The bot helps you look up players, towns and nations and track lots of other useful data, like who the richest players are.
How often is the data updated?
The data EMCHub uses is updated several times a day to keep everything as accurate as possible. Some data is fetched live exactly when you run a command, while other datasets are cached and refreshed every few minutes, depending on what makes the most sense for performance and reliability.
How was the 3D map made?
The 3D map was built using Three.js for the rendering and globe visuals, combined with data provided by the EarthMC API.
Do you have any other projects?
We also work on TarkovGuide, which is a tool like EMCHub but for Escape From Tarkov. On TarkovGuide we have tools such as tarkovguide.net/ammo, tarkovguide.net/armor, tarkovguide.net/boss, tarkovguide.net/goon-tracker and much more.