<div><img src="https://cdn.steemitimages.com/DQmePxGUBmYoqo8tV4WK3wiSF9hQZ4BKAxqVPrSBnPmQ9TN/thumb.png)"/>
<div class="text-justify"><blockquote>This is the new store addon for SKYBLOCK.SK, it allows server operators to buy and sell items very easy. It also has support for already existing SKYBLOCK.SK addons for being sold in this shop.</blockquote></div></div>

---

Hello everyone,

Today, I have two new exciting changes for SKYBLOCK.SK to show you guys. One of them is a store, where players can sell their stuff, the other one is a new toplist of the islands. Another new feature is the `openbook` function, which opens a book to the player, which is currently in the hand of the player.


### 1. Repository
https://github.com/Abwasserrohr/SKYBLOCK.SK

### 2. Index
1. Repository
2. Index
3. New Features and changes
3.1. New addon: ```store.sk```
3.2. Added `openbook` function
3.3. Changed island toplist: ```/island top```
4. Pull requests
5. GitHub Account
6. How to contribute

### 3. New Features

#### 3.1. New addon: ```store.sk```
This new addon finally allows server operators to sell their stuff with SKYBLOCK.SK, the advantage of this addon is that it can sell not only regular items but also any defined `ItemStack`. That means the server operator can create completely custom `ItemStack`s and sell them. This is very useful, since SKYBLOCK.SK addons use custom items, which could also be sold within the new store. These add-on items could be robots, parkour sets, storage units, JetBoots, loot boxes or custom decoration heads.

<div class="pull-right">
<a href="https://cdn.steemitimages.com/DQmZKaD4AQo1DuM1x6cQWg6C3Hz2FXoGbFVhFpHd7Uyx1YU/storeexplain.jpg">
<img src="https://cdn.steemitimages.com/DQmZKaD4AQo1DuM1x6cQWg6C3Hz2FXoGbFVhFpHd7Uyx1YU/storeexplain.jpg"><blockquote>This is a quick explanation of how the store addon is built and how it works for the user, who wants to either buy or sell items.</blockquote></a></div>

But that's not all, what this addon does. For me as a server operator, it was always annoying to make the menu look good by manually set all the items to their slots. When I created the new `store.sk` addon, I focused on creating an admin shop where the server operator doesn't have to determine all the slots and rather than that only select which categories there should be and which items should be sold and bought in these categories. While I kept that in my mind, I also tried to make it easy to navigate through the store.


To make this easy setup complete, the `store.sk` addon supports unlimited categories and unlimited items to be added to every category. This doesn't fix the server operator to only one site per category and makes it way more efficient to add new items and blocks to the store because the server operator doesn't have to mind how it looks like at the end.

Another thing that bothered me was the lack of language support for multiple players at once. `store.sk` does support the SKYBLOCK.SK languages and is capable of serving different languages to all the players at once. There isn't any other language available besides German though. But soon, more languages will be added to SKYBLOCK.SK.

Here is a video that shows off the `store.sk` shop with its default configuration. This default config may change in the future and is there to make SKYBLOCK.SK working well without any changes and also makes it easy to understand how it works.

https://www.youtube.com/watch?v=4tnSgydBp4w

Here is a little part of the new store I want to explain:

<a href="https://cdn.steemitimages.com/DQmaZsntqzBWY4MHnZCFa6TiEZtBqoJGkb49Ya6iUfnASEq/1.png">
<img src="https://cdn.steemitimages.com/DQmaZsntqzBWY4MHnZCFa6TiEZtBqoJGkb49Ya6iUfnASEq/1.png"></a>

This part of the `store.sk` addon detects if the island level threshold is reached and the item can be sold to the player. That way, the server operator can set an island level threshold to specific items, like animal eggs to prevent new players from buying them directly. This can be very important to keep the late game interesting for players since there are always new things to be discovered and it doesn't get boring as fast as it would get without it.

Now here is how a server operator can create a new category, which sells 1 of beacon for 500 money and buys it again for 100. Pretty cheap, but an example of how it works.

First, the category has to be defined. This is only one line:

<a href="https://cdn.steemitimages.com/DQmSiE1Dkydmhs7RgzSCosKPeP5V4AeV86kTesKfEg3icXi/3.png">
<img src="https://cdn.steemitimages.com/DQmSiE1Dkydmhs7RgzSCosKPeP5V4AeV86kTesKfEg3icXi/3.png"></a>


I have named my new category "valuable" and can also add a translation for it.

<a href="https://cdn.steemitimages.com/DQmdhi2oPrahJ6VEuUopWSxU9xnAj66vzdeLc3Y2uDFRs3Q/4.png">
<img src="https://cdn.steemitimages.com/DQmdhi2oPrahJ6VEuUopWSxU9xnAj66vzdeLc3Y2uDFRs3Q/4.png"></a>


Then, we can go forward and define new items which should be placed within this new "valuable" category.

<a href="https://cdn.steemitimages.com/DQmWCT9Y6ibGuWsfgci3qjJFHJjzXkQDDLNLDapS4oJA9s5/5.png">
<img src="https://cdn.steemitimages.com/DQmWCT9Y6ibGuWsfgci3qjJFHJjzXkQDDLNLDapS4oJA9s5/5.png"></a>


Here, lists are used. These lists can then be later used and looped to display everything to the user. I also want to note that the prices and threshold are entered as a string (text) because otherwise Skript would not add it to the list of objects but rather add it as a number and then increase the number every time and not add it to the list.

There are still some new ideas which I might add in the future to the `store.sk` addon, but for now, I first need some feedback from the players to improve already existing parts of it before extending it furthermore.

I'm sorry that I used tabs instead of spaces. It is still new for me to use spaces and sometimes it just happens and I do tabs again. I have added a commit which changed this mistake below the pull request. :3

Pull request: https://github.com/Abwasserrohr/SKYBLOCK.SK/pull/170
Fixed spacers: https://github.com/Abwasserrohr/SKYBLOCK.SK/blob/39a1ea0f63e41ec8d2090aa30b389098ba922e6a/SkyBlock/addons/store.sk

---

#### 3.2. Added `openbook` function
The now added `openbook` function allows SKYBLOCK.SK to send the Minecraft client a packet which opens a book for the player. This can be very useful if there should be books opened to the player, which have been generated before. Like a toplist, a server guide or something else. 

<a href="https://cdn.steemitimages.com/DQmbYG8Sum2VuTxAkUrGSHzi1zAuKgHNXAQkYrtYbTn6uGJ/6.png">
<img src="https://cdn.steemitimages.com/DQmbYG8Sum2VuTxAkUrGSHzi1zAuKgHNXAQkYrtYbTn6uGJ/6.png"></a>

The new function makes use of the `net.minecraft.server.%version%.PacketPlayOutCustomPayload` class to send the player a specific packet. Thanks to some changes in Minecraft Version 1.13, the Client now accepts actual human readable `MinecraftKey`, like `minecraft:book_open` which is amazing, in my opinion. =)

To get `PacketPlayOutCustomPayload` to work, a buffer is needed, which then is serialized. It can then be sent to the player.

This new function allows working with books for top lists or island information in the future. Again, I had some type of bad day and used tabs instead of spaces, it has been fixed in the pull request below.

Commit: https://github.com/Abwasserrohr/SKYBLOCK.SK/commit/fa67dd40f94db9f2ac423c25cbee85ac0f3adabb

---

#### 3.3. Changed island toplist: ```/island top```
While the chat is pretty nice to display information, it is not great user experience, because there might be important stuff to read in the chat, which then gets spammed way by the `/island top`. This has now been fixed, thanks to the new `openbook` function, the toplist is now created within a book and then directly opened to the player. 

Here is a side by side difference:

<div class="pull-left">
<a href="https://cdn.steemitimages.com/DQmXvDPVZcBNgiMEF5RdzvRGEFg6yXkjPQ8cRMTzkKHWPn9/oldlist.png">
<img src="https://cdn.steemitimages.com/DQmXvDPVZcBNgiMEF5RdzvRGEFg6yXkjPQ8cRMTzkKHWPn9/oldlist.png"><blockquote>Old</blockquote></a></div>


<div class="pull-right">
<a href="https://cdn.steemitimages.com/DQmXvr4XHj42ivNg5ZpUdNstpAYNerxmmXzjcdv68WrHCzr/newlists.png">
<img src="https://cdn.steemitimages.com/DQmXvr4XHj42ivNg5ZpUdNstpAYNerxmmXzjcdv68WrHCzr/newlists.png"><blockquote>New</blockquote></a></div>

While it the ```opentoplist``` function is pretty big, here is an example of how I created the book instead of making it in the chat.

<a href="https://cdn.steemitimages.com/DQmYPsMWdtrhYm9DZyxBYMaaxNmwo7Fi4z5Jihk826uCpJ2/7.png">
<img src="https://cdn.steemitimages.com/DQmYPsMWdtrhYm9DZyxBYMaaxNmwo7Fi4z5Jihk826uCpJ2/7.png"></a>

I'm using `BaseComponent`, which is very good explained [here](https://www.spigotmc.org/wiki/the-chat-component-api/) to create the book with `click` and `hover` events. This is great because it is possible to add additional data, like island levels, island members of the island to the text as a `hover` effect. Once we have created our `BaseComponent`, we can go forward and make a newly written book and get the metadata out of it.

<a href="https://cdn.steemitimages.com/DQmZZgDnuD54poJBkMUBrBh6SMJ4SiSrXvEi47oqpANYbaY/8.png">
<img src="https://cdn.steemitimages.com/DQmZZgDnuD54poJBkMUBrBh6SMJ4SiSrXvEi47oqpANYbaY/8.png"></a>

Then, some important `metadata` has to be set, nobody will see this ever, besides us. But it is required to be accepted by the client of the player.

<a href="https://cdn.steemitimages.com/DQmcXLZ4tiKjdfzq2ydnhsPqqTA5RobgR6zutR8AKsrUWEr/10.png">
<img src="https://cdn.steemitimages.com/DQmcXLZ4tiKjdfzq2ydnhsPqqTA5RobgR6zutR8AKsrUWEr/10.png"></a>

Then, we can add the previously generated sites above with the `BaseComponent` to the book meta.

<a href="https://cdn.steemitimages.com/DQmTRTawv4UepMFR8wuYLShKyytMTHRbBCxdtAL4sxbkYgt/11.png">
<img src="https://cdn.steemitimages.com/DQmTRTawv4UepMFR8wuYLShKyytMTHRbBCxdtAL4sxbkYgt/11.png"></a>

Now, we just have to:

- Set the book `metadata` back to the written book item
- Save the current tool of the player with the new book
- Replace the current tool of the player with the written book item
- run the openbook function with the player as a parameter
- replace the current tool of the player with the saved one
- the player is now looking at our new book. =)

<a href="https://cdn.steemitimages.com/DQmfPkR6qxBfmghFvrUShFuAgq2yDEckjrW1h7XEEzN2T6y/12.png">
<img src="https://cdn.steemitimages.com/DQmfPkR6qxBfmghFvrUShFuAgq2yDEckjrW1h7XEEzN2T6y/12.png"></a>

Pull request: https://github.com/Abwasserrohr/SKYBLOCK.SK/pull/173

---

### 4. Pull requests
https://github.com/Abwasserrohr/SKYBLOCK.SK/pull/170
https://github.com/Abwasserrohr/SKYBLOCK.SK/pull/173

---

### 5. GitHub Account
https://github.com/Abwasserrohr

---

### 6. How to contribute
You want to contribute to SKYBLOCK.SK? Get in touch with me on Discord, I'm the sewage pipe there. I also look forward to meeting beginners, who are still new to Skript but are interested to help on SKYBLOCK.SK.

Discord: https://discord.gg/FRuK5BC

---

<div class="pull-right">
<img src="https://files.steempeak.com/file/steempeak/immanuel94/ixckCiqM-2019-03-08_14.57.32.png"><blockquote>Did you know? It is also possible to swim faster in Minecraft now. I really didn't tried it out until now. :3</blockquote></div>

Thank you for reading my contribution post. With the new store, server operators can easily set up a store which is directly accessible through the `/island` main menu and automatically fit the corporate design of SKYBLOCK.SK.

The ```openbook``` function opens new ways to make menus. Not only a toplist of the best islands is a great way of using books, but also other things, where much information has to be displayed is quite handy. `/island info` and `/island help` will also get this upgrade to a book in the future.

Do you have feedback about this contribution post, SKYBLOCK.SK or the new features? Share them with me in the comments. =)


Have a great weekend

@immanuel94