Announcement New stats page and changes to the Wynncraft API

Hello everyone!

It has been a long time since we dedicated an announcement about the API and the web network generally, but we have made big changes in the last year on the web network and have a lot more planned.

Updated Stats Page

We have updated the stats page with various changes and improvements! Check it out here. We will continue to improve it based on your feedback in the coming weeks.


Last year changes

We have done quite a few changes, first on the "visible" side of the network, we completely rewritten the main website, we did it with one thing in mind, maintainability (and everything else that we have done since then is the same). With this we were able to implement new features such as the ability tree page and the new item guide, and recently the new leaderboards and stat page changes. Another rework we did was the store, we completely redesigned it with new features such as a live basket, better prices and guest mode. Lastly we updated the webmap, adding new features as well, waypoints, player trail and spawn locations for the item guide.

All those changes were possible because while doing all of that we also worked on a new API, some of you already know about it. This V3 API is slowly growing since last year and gets more and more feature each update. Our objective with this API is to implement any feature V1 and V2 APIs has with more consistency and in a single place. We are soon reaching this objective and this is why we decided to talk about what we have planned next.


User system

Right now, all our web related stuff is handled by the forums, if you want to link your Minecraft account, you need to do it on the forums, if you want to have your rank on discord, you have to do it on the forums. While all of that "works" in its current state it is clearly not the best option, and it lacks a lot of feature, account deletion, unlink... to quote a few.

Our plan with the user system is to create a global Wynncraft account that will take care of everything, including access management to the V3 API and logging into the forums. This account will also allow us to implement various new features that aren't only available on the game servers.


V3 Access

Currently all of our APIs are public and can be requested by anyone, anywhere. The issue with that is that we cannot properly moderate the API usage to prevent abuses (example was the chest found abuse). For now V3 is still public, but we will make it private after the user system is implemented.

That means that access to V3 API will require authentication with a token, this token will only be delivered to valid users having a valid Minecraft account linked to their Wynncraft account. Users meeting these conditions will be able to generate a token automatically.


Privacy

We have added a way to disable some of your stats from being visible to the public (this works only on V3), such as your ability trees or skill points. To enable this feature do '/toggle publicProfile' in-game


Legacy APIs

Now let's talk about our legacy APIs. We will be making sure V3 is able to do everything previous APIs used to do, and plan to sunset all legacy APIs afterwards. Having 2 or 3 different APIs to maintain is a significant amount of work, especially with the way they were made.

We will announce a precise date for the shutdown so you can migrate to V3 before it happens. V3's endpoints will be moved to api.wynncraft.com before the shutdown as well. You can officially consider V1 and V2 as depreciated from now on, they should both be referred as Legacy APIs.


Migration to V3

With V1 and V2 APIs being considered legacy, you may want to move over to V3 API.

From now on, we will announce upcoming changes about V3 on the developer discord alongside an updated documentation. We made a quick documentation page with everything you need to get started with V3, it is available at: https://documentation.wynncraft.com


Those changes are pretty big and will require some time. We are unable to give a precise date for when those features will be available, but know that we are working on them.

 

Thanks Nepper, great stuff