The Minecraft Update

After we published The Microsoft Update, we received a lot of feedback from the community. The major concern was the authentication system, and rightfully so. We should've never used Microsoft to authenticate your Minecraft account due to major security concerns.

We've listened to your feedback and have decided to change the authentication system to use mc-auth instead.

Table of Contents

• Login System
• Redesigned Elements
• Raw Craft Cost
• RCC API
  • Additional Information
    • Credits
• Notes

Login System

We tried hard to find a solution for the authentication system that would be easy to use and secure. We couldn't just use email and password, since we need to know your Minecraft info like your username. That's why we decided to use Microsoft to authenticate your Minecraft account in the first place.

So we found a solution that would be easy to use and secure, and that is mc-auth.

Here is how it works:

1. You join the Minecraft server mc-auth.com with your Minecraft account.
2. Then you will get a code.
3. Enter that code on the website.
4. You're now logged in mc-auth!

Once you're logged in mc-auth, you can authenticate third-party applications, like MinionAH, with mc-auth. This will allow MinionAH to get your public Minecraft info like your username and UUID provided by mc-auth.
No sensitive information is gathered by MinionAH or mc-auth.

Once you authenticate MinionAH with mc-auth, you will be redirected back to MinionAH and you will be asked to set a password for your account.
This password will be used to log in to MinionAH in the future, so you don't have to go through the whole process again.

Redesigned Elements

We have redesigned a lot of elements on the website to be easier to use in development, more accessible, and more consistent with the rest of the website.

For example, we have redesigned the minion creation form on the profile page:

Before

After

We have also redesigned the alerts you get when creating/deleting a minion and added more information to them when needed.

Raw Craft Cost

We have saved the best for last. We added a new feature that will calculate the raw craft cost of the minion. This feature has been heavily inspired by the NotEnoughUpdates (NEU) mod.

Unfortunately, since the project is hosted on Vercel's Hobby plan, we can only have cron jobs that run every 24 hours. This means that the craft cost will be updated every 24 hours as the minions' costs that we use to display are stored in our database and not directly retrieved from the API.

RCC API

Unfortunately, NEU does not provide a public API for this feature, so we had to create our own. We have created a public API that will calculate the raw craft cost of (almost) any Hypixel SkyBlock item. This API is available for everyone to use in their own projects.

To use the API, simply send a GET request to https://minionah.com/api/craftcost.
The API will return a JSON object with the raw craft cost of every item in the game:

		{
	"AATROX_BADPHONE": 6870.401506624104,
	"AATROX_BATPHONE": 5344
	// ...etc
}
	

If you need a specific item, you can send a GET request to https://minionah.com/api/craftcost/{item}.

Replace {item} with the internal item name, you can find a list of all the internal item names at kr45732/skyblock-plus-data/InternalNameMappings.json.

The API will return a JSON object with the raw craft cost of the specified item:

		{
	"WOOD_AXE": 126.02217354265548
}
	

With a status code of 200, and a status message of OK.

If you provide an invalid item name, the API will return the following JSON object:

		{
	"error": "Item not found",
	"message": "The item 'anInvalidItemName' was not found. Please check 'InternalNameMappings.json' for a list of all Hypixel Skyblock items.",
	"item": "anInvalidItemName",
	"url": "https://raw.githubusercontent.com/kr45732/skyblock-plus-data/main/InternalNameMappings.json"
}
	

With a status code of 404, and a status message of Item not found.

In addition, if you want to get a list of the raw craft cost of every minion, you can provide minions as the {item} value.

The API will return the following JSON object:

		{
	"ACACIA_GENERATOR_1": 2126.0221735426553,
	"ACACIA_GENERATOR_2": 6126.022173542655
	// ...etc
}
	

If an internal error occurs, the API will return the following JSON object:

		{
	"error": "Something went wrong"
}
	

With a status code of 500, and a status message of Internal Server Error.

• All responses have the Content-Type header set to application/json.
• The API is rate-limited to 60 requests per minute.

Additional Information

• The API tries to take as many items into calculation as possible, the prices are retrieved from either the bazaar or the NPC sell price if it is not available on the bazaar. If the item is not available on the bazaar or the NPC sell price, the API will return 0 as the price.

  • Even though the API tries to take as many items into calculation as possible, it is not possible to take every item into calculation due to different factors (like some not having a price, not obtainable, etc). So the prices might not be 100% accurate.

• The API used for the Bazaar prices is Slothpixel. Every time a request is made to the API, the API will request Slothpixel to get the latest Bazaar prices. This means that the API will always have the latest Bazaar prices.

• Not all items have a recipe to craft or are sold by an NPC. For example, the Snow and Flower Minions can't be obtained by crafting or by an NPC. Some items are only purchasable with Bits. In cases like these where calculating the price is not possible, the API will return 0 as the price.

• As always, the code is open-source and available at github.com/DarthGigi/MinionAH.

Credits

We'd like to massively thank BigOofinator for helping us with the calculation code

Notes

• The full list of changes can be found in the CHANGELOG.md file.