EarthMC Stats: Difference between revisions

>57gorky
No edit summary
No edit summary
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''EarthMC Stats''' is a discord plugin for EarthMC that allows you to see nation, town, /res, /n online, /n list, and /baltop stats whilst not being online EarthMC, it is under thousands of users and hundreds of discord servers.
{{Corporation_template|area_server=Worldwide|image1=[[File:EMCStats.png|300px]]
|caption1=EarthMC Stats Logo|founded=December 16th, 2019|owner=Owen3H|discord_server=[https://discord.gg/DhKhvgxsKd Link to EMC Stats Discord]|status=Active|type=Public|industry=Misc.|founder=Owen3H, Warriorrr|services=Alliances, News, General Info/Stats|number_of_staff=11}}


It is largely used in #bot-spam channels and first known usage was under some England and Spain based servers.
'''EarthMC Stats''' is an [https://github.com/EarthMC-Toolkit/EMCS-Rewritten open-source Discord bot] for EarthMC that allows you to see info about nations, towns, residents, alliances and much more (use /help) even when EarthMC is offline. The bot's most popular command is /townless, which gives a list of townless people which you can invite to your town. The bot also includes many useful features and utilities like <code>/alliance</code> <code>/voteparty</code> <code>/ruined</code> <code>/falling</code> and more. It also features an associated API that is open for anyone to use and is already used in projects like 3meraldK's '''earthmc-dynmap+''' extension so that alliances and their colours can be shown on the map.<blockquote>ℹ️'''All commands are completely free and there are no plans to charge real or in-game currency for special access to any commands.'''</blockquote><blockquote>'''⚠️Forks and distributions must stay source-available and adhere to the License and Terms of Service.'''</blockquote>


To use it, just do /t (example), /n (example), or /res (example) and Earth MC stats will give you the stats of that town / user / nation without even needing to be on the server.
==Usage==
The stats bot is used by thousands of users, is in '''1,745''' servers as of 18 Aug 2025 and is largely used in bot command channels with the first known usage being in the [[Nova:Britain|Britain]] and [[Nova:Spain|Spain]] servers during Terra Nova.


It was made by Wariorrr and Owen77Stubs, who are commonly associated with the in-game nation of [[Britain]].
'''EMCS''' has a unique ability to continue working when the server is offline as most of its source data is both cached and stored in a database. It relies on official [https://earthmc.net/docs/api EarthMC API] primarily and also data from the [https://map.earthmc.net EarthMC Map] for redundancy when the server is down or when the official API is experiencing issues.
[[Category:Unique Page]]
 
To use it, just run a command such as <code>/res <name></code> <code>/town query <name></code> <code>/nation query <name></code> or <code>/alliance query <name></code> and the bot will respond with the stats of that player/town/nation/alliance without needing to even log on to EarthMC. '''EarthMC Stats''' also has other usage like showing the activity of nations and towns in addition to misc commands like<code>/news</code> <code>/route</code> <code>/usage</code> and more.
==Founding and History==
It was originally created by '''Owen3H''' and '''Warriorrr''' (who were commonly associated with the in-game nation of [[Nova:Britain|Britain]] on Terra Nova) as an alternative and fork of the '''EarthMC Info''' bot ran by '''LuciferianThomas''' who seemingly quit around 2019~2020 after an incident where player '''Aceshooter''' implemented a backdoor into the original '''EMC Info''' bot, gathering messages from many private discords. The backdoor which was swiftly removed upon forking, and ever since then, '''EMCS''' has been committed to staying open-source and after many rewrites and refactors, you can be sure it is safe to use. You can even fork the [https://github.com/EarthMC-Toolkit/EMCS-Rewritten repo] , edit code and host it yourself if you are still unsure! 
 
In 2025, '''EMCS''' suffered hosting limitations and maintenance troubles due to limited resources, making it unsustainable alongside the 5 years of technical debt. At which point, the decision was made to completely rewrite the bot from the ground up using the Golang programming language, which is a much faster compiled language and is easy to pick up just like JS or TS, making it suitable for what is now a self-hostable, configurable and performant Discord bot made specifically to help EarthMC players with many aspects of the server by providing useful information. 
 
Today, Owen3H is still maintaining the main instance of the EMCS in 2026 alongside alliance editors and updates the bot and its API in his free time where possible.
 
==Alliance Editors==
There are a total of '''9''' editors currently, with four of them being "senior" editors, who have the ability to disband alliances and possibly more permissions in future.
 
Editor application forms are occasionally posted in the [https://github.com/EarthMC-Toolkit EarthMC Toolkit] Discord, allowing players to apply to become an Editor, whos role is to keep alliances up-to-date according to news and making edits or new alliances at the request of the leaders and/or representative of the alliance.
 
====='''Senior'''=====
- [[3meraldK]]
 
- MrToirol
 
- spacewonder6
 
- [[36hoi]]
 
====='''Regular'''=====
- [[MasterEWild]]
 
- xultimate1
 
- thebestLung
 
- [[SlipperySalmon14]]
 
==Toolkit==
'''EarthMC Stats''' is part of the [https://github.com/EarthMC-Toolkit EarthMC Toolkit] and in addition to it, also provides EMC information in various formats, including a mod for direct in-game use or libraries to help other developers.
 
==Conclusion ==
EMCS is essential to many player's experiences, helping them stay in touch and learn about the stats of EMC all in one easy to use and knowledgeable package. The fact that the stats bot is still running in 2026 and has been since 2019 really shows how important it really is and the impact the toolkit has had on the development and hobbyist side of EarthMC ever since the map JSON endpoints were originally discovered, which inspired many other projects. <p>[[Category:Unique Page]]
[[Category:Tools]]
[[Category:Miscellaneous]]
{{DEFAULTSORT:EarthMC Stats}}