diff --git a/docs/wiki/site/index.html b/docs/wiki/site/index.html
index 880a3b699..dcc3ea43c 100644
--- a/docs/wiki/site/index.html
+++ b/docs/wiki/site/index.html
@@ -599,6 +599,10 @@
 
 <h1 id="introduction">Introduction</h1>
 <p>PetBlocks is a Minecraft Bukkit plugin to use blocks as pets in minecraft.</p>
+<div class="admonition note">
+<p class="admonition-title">PetBlocks v8 Docs</p>
+<p>Are you looking for the old wiki? You can download it <a href="https://shynixn.github.io/PetBlocks/8.0.0/wiki.zip">here.</a></p>
+</div>
 <h2 id="features">Features</h2>
 <ul>
 <li>Adds a new pet to every player</li>
diff --git a/docs/wiki/site/search/search_index.json b/docs/wiki/site/search/search_index.json
index b52756d8e..dd5780540 100644
--- a/docs/wiki/site/search/search_index.json
+++ b/docs/wiki/site/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Introduction","text":"<p>PetBlocks is a Minecraft Bukkit plugin to use blocks as pets in minecraft.</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Adds a new pet to every player</li> <li>Use blocks or custom heads as skins for your pet</li> <li>Pets are fully programmable using embedded JavaScript + Pet Config files</li> <li>PetBlocks are fully controlable by commands</li> <li>Command can be called by the console, other plugins, command blocks and players</li> <li>Extensive Permission system</li> <li>Support for custom models</li> <li>Easy integration into your server. </li> <li>Easy integration into existing GUI plugins (e.g. DeluxeMenu)</li> <li>PlaceHolderApi Support</li> <li>Multiple pets per player (Premium)</li> </ul>"},{"location":"#installation","title":"Installation","text":""},{"location":"#petblocks-latest","title":"PetBlocks-Latest","text":"<ul> <li>Java 17 </li> <li>Spigot 1.20.2</li> </ul>"},{"location":"#petblocks-premium","title":"PetBlocks-Premium","text":"<ul> <li>Java 17</li> <li>Spigot 1.17-1.20.2</li> </ul>"},{"location":"commands/","title":"Commands","text":"<p>PetBlocks is a command line based pet plugin. This means, you can fully control the pets using commands, which may be executed by players, console,  other plugins, command blocks.</p> <p>e.g. Letting the pet named <code>pet</code> of player <code>Steve98</code> move to a certain location from the console. (The pet has to be in a nearby location)</p> <pre><code>/petblocks moveto pet &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;speed&gt; [player]\n</code></pre> <pre><code>petblocks moveto pet 250 5 300 0.2 Steve98\n</code></pre> <p>Removing the pet under certain conditions</p> <p>You can always take a way the <code>petblocks.pet.spawn</code> permission to remove the pet from players, if they enter certain areas (e.g. joining minigames, entering regions, etc.)</p>"},{"location":"commands/#command-petblocks","title":"Command /petblocks","text":"<p>PetBlocks does only have 1 command, which is restricted using permissions.</p> <p>Required Permission: <code>petblocks.command</code></p>"},{"location":"commands/#petblocks-create","title":"/petblocks create","text":"<pre><code>/petblocks create &lt;name&gt; &lt;template&gt; [player]\n</code></pre> <p>Creates a new pet for the player with the given pet template.</p> <ul> <li>Name: Identifier of a pet</li> <li>Template: Identifier of a template </li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-delete","title":"/petblocks delete","text":"<pre><code>/petblocks delete &lt;name&gt; [player]\n</code></pre> <p>Deletes the pet for the player.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-list","title":"/petblocks list","text":"<pre><code>/petblocks list [player]\n</code></pre> <p>Lists all pets of a player.</p> <ul> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-call","title":"/petblocks call","text":"<pre><code>/petblocks call &lt;name&gt; [player]\n</code></pre> <p>Spawns and teleports the pet in front of the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-lookat","title":"/petblocks lookat","text":"<pre><code>/petblocks lookat &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; [player]\n</code></pre> <p>Makes the pet look at the given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-lookatowner","title":"/petblocks lookatowner","text":"<pre><code>/petblocks lookatowner [player]\n</code></pre> <p>Makes the pet look at the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-moveto","title":"/petblocks moveto","text":"<pre><code>/petblocks moveto &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;speed&gt; [player]\n</code></pre> <p>Makes the pet walk to a given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Speed: Walking speed of the pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-movetoowner","title":"/petblocks movetoowner","text":"<pre><code>/petblocks movetoowner &lt;name&gt; &lt;speed&gt; [player]\n</code></pre> <p>Makes the pet walk to the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Speed: Walking speed of the pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-hat","title":"/petblocks hat","text":"<pre><code>/petblocks hat &lt;name&gt; [player]\n</code></pre> <p>Makes the owner wear the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-ride","title":"/petblocks ride","text":"<pre><code>/petblocks ride &lt;name&gt; [player]\n</code></pre> <p>Makes the owner ride the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-unmount","title":"/petblocks unmount","text":"<pre><code>/petblocks unmount &lt;name&gt; [player]\n</code></pre> <p>Makes the owner unmount (stop riding/hat) the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-teleport","title":"/petblocks teleport","text":"<pre><code>/petblocks teleport &lt;name&gt; &lt;world&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;yaw&gt; &lt;pitch&gt; [player]\n</code></pre> <p>Teleports the pet to the given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>World: Target world</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Yaw: Horizontal Axe</li> <li>Pitch: Vertical Axe</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-velocity","title":"/petblocks velocity","text":"<pre><code>/petblocks velocity &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; [player]\n</code></pre> <p>Launches the pet into the given direction.</p> <ul> <li>Name: Identifier of a pet</li> <li>World: Target world</li> <li>X: X Vector</li> <li>Y: Y Vector</li> <li>Z: Z Vector</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skintype","title":"/petblocks skintype","text":"<pre><code>/petblocks skintype &lt;name&gt; &lt;material&gt; [player]\"\n</code></pre> <p>Changes the material used as a head. </p> <ul> <li>Name: Identifier of a pet</li> <li>Material: Minecraft material name e.g. STONE</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinnbt","title":"/petblocks skinnbt","text":"<pre><code>/petblocks skinnbt &lt;name&gt; &lt;nbt&gt; [player]\n</code></pre> <p>Changes the NBT tags of the head item.</p> <ul> <li>Name: Identifier of a pet</li> <li>NBT: Standard Minecraft NBT format. e.g. {Unbreakable:1}</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinbase64","title":"/petblocks skinbase64","text":"<pre><code>/petblocks skinbase64 &lt;name&gt; &lt;skin&gt; [player]\n</code></pre> <p>Changes the head material to player_head and sets the base64 encoded texture url. </p> <ul> <li>Name: Identifier of a pet</li> <li>Skin: Bas64 Encoded Texture value e.g. <code>eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYThhZDZmYzEyNzA4NDQ2ZWI2NmM3NTY5ZTI4ZDVlMjUyMWQyMTQ2MzQ4YjQ4YmY2YzQ3ZjU0OGQ5ZWVjNDYwYSJ9fX0=</code> on https://minecraft-heads.com/custom-heads/humanoid/67436-beegsmol-mumei </li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinheaddatabase","title":"/petblocks skinheaddatabase","text":"<pre><code>/petblocks skinheaddatabase &lt;name&gt; &lt;hdbId&gt; [player]\n</code></pre> <p>Changes the head material to player_head and sets the texture url from a skin loaded by the HeadDatabase plugin.</p> <ul> <li>Name: Identifier of a pet</li> <li>HdbId: Internal id the HeadDatabase plugin uses.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-rename","title":"/petblocks rename","text":"<pre><code>/petblocks rename &lt;name&gt; &lt;displayname&gt; [player]\n</code></pre> <p>Changes the display name of the pet. Does not accept spaces. Underlines '_' are automatically replaced by spaces. Allows values should be set in the <code>config.yml</code>.</p> <ul> <li>Name: Identifier of a pet</li> <li>DisplayName: Name hovering above the pet, which supports ChatColors.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-visibility","title":"/petblocks visibility","text":"<pre><code>/petblocks visibility &lt;name&gt; &lt;type&gt; [player]\n</code></pre> <p>Changes who can see the pet. </p> <ul> <li>Name: Identifier of a pet</li> <li>Types: Possibles values: <code>ALL</code>, <code>OWNER</code></li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-loop","title":"/petblocks loop","text":"<pre><code>/petblocks loop &lt;name&gt; &lt;loop&gt; [player]\n</code></pre> <p>Changes which loop from the template is being executed by the pet. Example loops are <code>idle</code>.</p> <ul> <li>Name: Identifier of a pet</li> <li>Loop: Identifier of a loop in the template of the pet.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-template","title":"/petblocks template","text":"<pre><code>/petblocks template &lt;name&gt; &lt;template&gt; [player]\n</code></pre> <p>Changes the template of a pet without recreating the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Template: Template identifier e.g. classic</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-spawn","title":"/petblocks spawn","text":"<pre><code>/petblocks spawn &lt;name&gt; [player]\n</code></pre> <p>Spawns the pet if it has not already spawned.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-despawn","title":"/petblocks despawn","text":"<pre><code>/petblocks despawn &lt;name&gt; [player]\n</code></pre> <p>Despawns the pet if it has not already despawned.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-toggle","title":"/petblocks toggle","text":"<pre><code>/petblocks toggle &lt;name&gt; [player]\n</code></pre> <p>Toggles the pet spawn state.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-select","title":"/petblocks select","text":"<pre><code>/petblocks select &lt;name&gt; [player]\n</code></pre> <p>Makes the owner select one of his pets as primary pet. This is only helpful if a single player has got multiple pets in PetBlocks-Premium.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#can-i-use-petblocks-to-attack-enemies-eg-zombies-or-other-players","title":"Can I use PetBlocks to attack enemies (e.g. Zombies) or other players?","text":"<p>Pets in PetBlocks can be programmed in the pet.yml file to perform such behaviors. You would need a PlaceHolderApi placeholder which contains the location of the entity you want to attack (will be added in a future update to PetBlocks, but there may already be plugins out there, which provide that). Then, create a new loop where the pet moves to to the entity using the <code>/petblocks moveTo &lt;x&gt; &lt;y&gt; &lt;z&gt;</code> command. Once the pet is near the entity, make it jump using <code>/petblocks velocity &lt;x&gt; &lt;y&gt; &lt;z&gt;</code> and execute command to damage the entity <code>/damage @e[type=zombie,limit=1,sort=nearest] 20</code></p>"},{"location":"faq/#how-can-i-use-petblocks-for-an-older-minecraft-version","title":"How can I use PetBlocks for an older Minecraft version?","text":"<p>Maintaining backwards compatibility is very hard and actively discouraged by spigot. I do my best to add more and more workarounds. However, it has become so much work, that you can only download them by becoming a Patreon https://www.patreon.com/Shynixn.</p>"},{"location":"gui/","title":"GUI","text":"<p>PetBlocks does no longer have its own GUI, because PetBlocks wants to focus on being a pet plugin instead of a GUI plugin. </p> <p>There are many very good GUI plugins outthere. One popular example is DeluxeMenu. PetBlocks distributes a pre-made DeluxeMenu GUI, to get the old PetBlocks GUI back. </p>"},{"location":"gui/#installing-the-classic-petblocks-gui","title":"Installing the classic PetBlocks GUI","text":"<ul> <li>Install DeluxeMenu</li> <li>Install PlaceHolderApi</li> <li>Copy the contents from the <code>plugins/PetBlocks/thirdparty/DeluxeMenu</code> folder to the <code>plugins/DeluxeMenu</code> folder. Restart the server. Execute <code>/petblocksmenu</code>   with the permission <code>petblocks.deluxemenu</code>.</li> </ul>"},{"location":"permission/","title":"Permission","text":"<p>The following permissions are available in PetBlocks.</p>"},{"location":"permission/#levels","title":"Levels","text":"<ul> <li>User: A permission all players can have.</li> <li>Admin: A permission only Admins should have.</li> <li>Admin/User: Depending on your server, you may give this permission to your players. If you are not sure, try to build your server around not giving this permission to your players.</li> </ul> Permission Level Description petblocks.command User Allows to use the /petblocks command. petblocks.help User Allows to see the help messages. petblocks.reload Admin Permission to use the /petblocks reload command. petblocks.pet.create Admin/User Allows to create a new pet.  This command should probably be executed by a GUI / Sign / Server Management Plugin. If you set receivePetsOnJoin in the config.yml, you do not need this permission. petblocks.pet.call User Allows to call the pet to the owner. petblocks.pet.spawn User Minimum required permission a player has to have in order to have a pet. If you remove this permission from a player, the pet automatically despawns. petblocks.pet.ride User Allows to ride a pet. petblocks.pet.hat User Allows to wear the pet like a hat petblocks.pet.unmount User Allows stop riding or stop wearing at pet petblocks.pet.list User Allows to list the pets of a player petblocks.pet.delete Admin/User Allows to delete a pet. It depends on the type of server if you want to give this permission to your players. This command should be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.displayName User Allows to rename a pet. petblocks.pet.toggle User Allows to toggle a pet. petblocks.pet.despawn User Allows to despawn at pet. petblocks.pet.skin Admin/User Allows to change the skin via command. This command should probably be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.skin.headDataBase Admin/User Allows to change the skin via the HeadDatabase plugin. This command should probably be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.lookat Admin/User Allows to force the pet to look at a given location petblocks.pet.lookatOwner Admin/User Allows to force the pet to look at the owner petblocks.pet.moveto Admin/User Allows to force the pet to move to a given location petblocks.pet.movetoOwner Admin/User Allows to force the pet to move to the owner petblocks.pet.teleport Admin/User Allows to force the pet to teleport to a given location petblocks.pet.velocity Admin/User Allows to force the pet to fly to a given direction petblocks.pet.visibility Admin/User Allows to change the pet visibility. petblocks.pet.loop Admin/User Allows to change the pet loop. A loop is discussed further in the pet customization section. petblocks.pet.loop Admin/User Allows to change the pet loop. A loop is discussed further in the pet customization section. petblocks.pet.setTemplate Admin/User Allows to change the template of a pet. petblocks.pet.manipulateOther Admin Allows to manipulate the pets of other players. e.g. Changing skins, etc. petblocks.pet.select Admin/User Allows to mark a pet as selected. This is helpful for placeholders. petblocks.pet.headDatabaseInventoryHook Admin/User Should the skin of a pet change to the last head you have clicked on in the HeadDatabase plugin GUI? petblocks.pet.template. Admin/User If you give your players access to <code>petblocks.pet.create</code>, each individual template is still locked by this permission. petblocks.pet.amount. Admin/User If you give your players access to <code>petblocks.pet.create</code>, the access to the slot where the pet is stored. e.g.  petblocks.pet.amount.1 (slot 1) and petblocks.pet.amount.2 (slot 2)"},{"location":"placeholders/","title":"PlaceHolders","text":"<p>The following placeholders are available in PetBlocks and can also be used via PlaceHolderApi.</p> <p>PlaceHolder Api</p> <p>As PetBlocks supports multiple pets per player, you need to select the pet in your placeholders. You can do this by appending the pet slot <code>_1</code> <code>_2</code> etc. or use the <code>/petblocks select &lt;name&gt;</code> command to set a pet as selected which can be retrieved using <code>_selected</code>. This results into placeholders such as e.g. <code>%petblocks_pet_displayName_1%</code> or <code>%petblocks_pet_displayName_selected%</code>. This is only relevant in external plugins. For actions in PetBlocks, you can directly use the placeholders below.</p> Player PlaceHolders Description %petblocks_owner_name% Player name of the owner of a pet. %petblocks_owner_displayName% Player displayName of the owner of a pet. %petblocks_owner_locationWorld% Name of the world the owner of a pet is inside. %petblocks_owner_locationX% X coordinate of the owner of a pet. %petblocks_owner_locationY% Y coordinate of the owner of a pet. %petblocks_owner_locationZ% Z coordinate of the owner of a pet. %petblocks_owner_locationYaw% Yaw rotation of the owner of a pet. %petblocks_owner_locationPitch% Yaw rotation of the owner of a pet. Pet PlaceHolders Description %petblocks_pet_name% Id of a pet %petblocks_pet_displayName% Displayname of a pet %petblocks_pet_distanceToOwner% Distance from the pet to the owner.  If the owner is in another world, this value becomes very high. %petblocks_pet_exists% True if the pet exists, false if not. %petblocks_pet_isSpawned% True if the pet is spawned, false if not. %petblocks_pet_template% Name of the template a pet uses. %petblocks_pet_visibility% Visibility Type a pet uses. %petblocks_pet_isMounted% True if the owner rides the pet or uses it as a hat. %petblocks_pet_loop% Name of the loop a pet currently executes. %petblocks_pet_locationWorld% Name of the world the pet is inside. %petblocks_pet_locationX% X coordinate of the pet. %petblocks_pet_locationY% Y coordinate of the pet. %petblocks_pet_locationZ% Z coordinate of the pet. %petblocks_pet_locationYaw% Yaw rotation of the pet. %petblocks_pet_locationPitch% Yaw rotation of the pet. %petblocks_pet_itemType% The head item type of the pet. %petblocks_pet_itemNbt% The head item NBT of the pet. %petblocks_pet_itemHeadBase64% The head item Base64 Skin Url of the pet. Event Player PlaceHolders Description %petblocks_eventPlayer_name% Player name of the owner of a pet. %petblocks_eventPlayer_displayName% Player displayName of the owner of a pet. %petblocks_eventPlayer_locationWorld% Name of the world the owner of a pet is inside. %petblocks_eventPlayer_locationX% X coordinate of the owner of a pet. %petblocks_eventPlayer_locationY% Y coordinate of the owner of a pet. %petblocks_eventPlayer_locationZ% Z coordinate of the owner of a pet. %petblocks_eventPlayer_locationYaw% Yaw rotation of the owner of a pet. %petblocks_eventPlayer_locationPitch% Yaw rotation of the owner of a pet."},{"location":"receivingpets/","title":"Giving Pets to Players","text":"<p>Once you have setup the permission, join your server. The PetBlocks default configuration creates a pet with template <code>classic</code> for you and makes it spawn in front of you. If you cannot see the pet, try executing <code>/petblocks call pet</code> or review your permissions again.</p> <p>Make sure your players have this permission to see their pet: <pre><code>petblocks.pet.spawn\n</code></pre></p> <p>The next step is to decide, how you want your players to receive a pet. There are multiple options below.</p>"},{"location":"receivingpets/#receiving-a-pet-on-first-join","title":"Receiving a pet on first join","text":"<p>This is enabled per default and can be changed in the <code>config.yml</code> under <code>pet/receivePetsOnJoin</code>. This creates a new database entry for each joining player, regardless if he has the spawn permission or not. The player requires the minimum <code>petblocks.pet.spawn</code> to see their pet.</p> <p>If you want to receive no pets on join and unlock pets later own (e.g. for shops or VIP perks), change this to: </p> <pre><code>pet:\n  receivePetsOnJoin: []\n</code></pre> <p>If you want to receive multiple pets (PetBlocks-Premium only) on first join. Append other pets below it. They have to have different names.</p> <pre><code>pet:\n  receivePetsOnJoin:\n    - name: \"pet1\"\n      template: \"classic\"\n    - name: \"pet2\"\n      template: \"classic\"      \n</code></pre> <p>In order to configure, if the pet should automatically spawn in front of the player on creation, open the template  <code>plugins/PetBlocks/pets/pet_classic.yml</code>. Set <code>pet/spawned</code> to <code>true</code> or <code>false</code>.</p>"},{"location":"receivingpets/#receiving-pets-using-a-shop","title":"Receiving pets using a shop","text":"<p>There are many ways how you can handle it. These are just examples below:</p> <p>Building GUIS with DeluxeMenu</p> <p>PetBlocks distributes premade DeluxeMenu based inventories, which may help you design your own inventories. See the GUI page for more details.</p>"},{"location":"receivingpets/#option-1-just-selling-skins-for-your-pet-easy","title":"Option 1 - Just selling skins for your pet (easy)","text":"<ol> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Keep the receive pet on join settings, the player should receive a pet everytime. </li> <li>Invent a new permission for each pet you would like to sell like <code>petblocks.pettype.&lt;yourpettype&gt;</code> e.g. <code>petblocks.pettype.pikachu</code>.</li> <li>Once a player buys the item in your shop, give them your newly invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Show an item in your GUI to change the skin to pikachu only, if the player has got the newly invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Execute the command with server level permission:</li> </ol> <pre><code>/petblocks skinbase64 pet eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdlYmNlZjQ2ODNjZGI3MTYzZTk2OWU0ZTIyNjlmMzY3M2E1ZDVlNmI3OGUwNmZhZWU0NWJjZjdjNDljMzk3In19fQ== %petblocks_owner_name%\n</code></pre> <p>DeluxeMenu e.g.: <pre><code>[console] petblocks skinbase64 %petblocks_pet_name_selected% eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdlYmNlZjQ2ODNjZGI3MTYzZTk2OWU0ZTIyNjlmMzY3M2E1ZDVlNmI3OGUwNmZhZWU0NWJjZjdjNDljMzk3In19fQ== %petblocks_owner_name%\n</code></pre></p>"},{"location":"receivingpets/#option-2-state-handling-of-pets-hard","title":"Option 2 - State handling of pets (hard)","text":"<ol> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Disable receive pet on join like shown above</li> <li>Invent a new permission for each pet you would like to sell like <code>petblocks.pettype.&lt;yourpettype&gt;</code> e.g. <code>petblocks.pettype.pikachu</code>. </li> <li>Once a player buys the item in your shop, give them your new invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Build a pet management GUI using an external GUI plugin (e.g. DeluxeMenu).</li> <li>Create a new item which is only visible if the player has obtained the e.g. <code>petblocks.pettype.pikachu</code> permission.</li> <li>When the player clicks on that item, execute the following command with server level permission:</li> </ol> <pre><code>/petblocks create &lt;petName&gt; &lt;templateName&gt; %petblocks_owner_name%\n</code></pre> <p>DeluxeMenu e.g.:</p> <pre><code>[console] petblocks create pet classic %petblocks_owner_name%\n</code></pre> <p>Executing the create command multiple times is fine, it does not do anything if the pet already exists.</p>"},{"location":"receivingpets/#option-3-free-creationdeletion-of-pets-for-players-easy","title":"Option 3 - Free creation/deletion of pets for players (easy)","text":"<ol> <li>Give your players the permission to the following</li> </ol> <pre><code>petblocks.pet.create\npetblocks.pet.delete\npetblocks.pet.amount.1\n</code></pre> <ol> <li>Disable receive pet on join like shown above</li> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Once a player buys the item in your shop, give them the permission to the petblocks template e.g. <code>petblocks.pet.template.classic</code>.</li> <li>Let the player freely execute <code>/petblocks create &lt;petName&gt; classic</code> and  <code>/petblocks delete &lt;petName&gt;</code> . You can also setup this in a GUI.</li> </ol>"},{"location":"template/","title":"Template","text":"<p>PetBlocks allows you to create templates, how a pet is going to look like and how it is going to behave. You can fully customize the behaviour and program the pets to perform certain actions.</p> <p>PetBlocks provides you with a starting pet template called <code>classic</code>, which can be found in the <code>plugins/PetBlocks/pets/</code> folder. You can copy this template and start desigining your own pets. Make sure to give it a new unique template identifier.</p> <p>Modify a template and execute <code>/petblocks reload</code> to apply the changes to your pet.</p>"},{"location":"template/#static-values","title":"Static Values","text":"<p>Most of the static values are explained in the config file itself. Set them according to your needs.</p> <p>Example for static values are <code>name</code>, <code>version</code> and all initial pet settings under <code>pet:</code>.</p>"},{"location":"template/#events","title":"Events","text":"<p>Events define what happens on certain events. Currently only leftClick and rightClick on the pet is supported. These actions get executed when a player left clicks on the pet. However, it may not be the owner, who clicks on a pet, therefore it needs to be checked if you only want to allow certain actions for the owner of the pet.</p> <p>Example:</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"Open the DeluxeMenu based pet inventory\" #  You need to install the plugin DeluxeMenu for this to work and copy the premade PetBlocks inventory from the thirdparty folder.\n        condition:\n          type: STRING_EQUALS\n          left: \"%petblocks_eventPlayer_name%\"\n          right: \"%petblocks_owner_name%\"\n        type: \"COMMAND\"\n        level: \"PLAYER\"\n        run:\n          - \"/petblocks select %petblocks_pet_name%\"\n          - \"/dm open petblocks_menu %petblocks_eventPlayer_name%\"\n</code></pre> <p>If you want to execute nothing when the player rightClicks on the pet, remove all actions.</p> <pre><code>events:\n  rightClick:\n    actions: []\n</code></pre>"},{"location":"template/#building-a-new-action","title":"Building a new action","text":"<p>PlaceHolders</p> <p>You can use placeholders almost anywhere when building actions. You can even use PlaceHolderApi based placeholders.</p> <p>Create a new action and give it an arbitrary name.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n</code></pre> <p>Select the action type. Support actions are <code>COMMAND</code>, <code>DELAY</code>, <code>JAVASCRIPT</code>.</p>"},{"location":"template/#command","title":"COMMAND","text":"<p>Executes one or multiple commands as Console or Player.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n</code></pre> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#delay","title":"DELAY","text":"<p>Delays the next action for a certain amount of ticks.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"Delay Action\" # Required arbitrary name.\n        type: \"DELAY\" # Required action type.\n        ticks: 60 # Required for type DELAY. 60 Ticks delay.\n</code></pre>"},{"location":"template/#javascript","title":"JAVASCRIPT","text":"<p>Executes JavaScript based Code for value calculation</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"JavaScript action\" # Required arbitrary name.\n        type: \"JAVASCRIPT\" # Required action type.\n        initial: \"Cool\" # Required for type JAVASCRIPT. The initial value of the result variable.\n        variable: \"myVariable\" # Required for type JAVASCRIPT. The name of the result variable, which can be read using PlaceHolders.\n        js: |                  # Required for type JAVASCRIPT. Actual multi line JavaScript code.\n          function createText() {\n             var text = \"%petblocks_js_myVariable%\" + \" Plugin\"\n             return text\n          }\n          createText();\n</code></pre>"},{"location":"template/#restricting-actions","title":"Restricting Actions","text":""},{"location":"template/#permission","title":"Permission","text":"<p>Actions can optionally have the permission tag:</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        permission: \"mycustom.permission\"\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#conditions","title":"Conditions","text":"<p>Actions can optionally have conditions, which support 2 types: <code>STRING_EQUALS</code> and <code>JAVASCRIPT</code>.  Prefer using <code>STRING_EQUALS</code> over <code>JAVASCRIPT</code>. <code>STRING_EQUALS</code> checks if the 2 values in <code>left</code> and <code>right</code> are the same. <code>JAVASCRIPT</code> evaluates a boolean expression.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        condition: # Optional condition tag.\n          type: STRING_EQUALS # Required condition type.\n          left: \"%petblocks_eventPlayer_name%\" \n          right: \"%petblocks_owner_name%\"\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        condition: # Optional condition tag.\n          type: JAVASCRIPT # Required condition type.\n          js: \"Math.floor(Math.random() * 100) &lt;= 50\" # 50% chance to execute this command.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#loops","title":"Loops","text":"<p>Loops define, what the pet should repeatedly do. You can customize and define your own loops using actions.</p> <p>Programmable Pets</p> <p>You can freely build new loops, delete loops and customize the behavior of pets. The actions allow full freedom to  design your pets. </p>"},{"location":"template/#idle-loop","title":"Idle Loop","text":"<p>The idle loop explained:</p> <ol> <li>Delay Action<ol> <li>We wait for 20 ticks.</li> </ol> </li> <li>Look at owner with a 90% change.<ol> <li>The JavaScript condition is evaluated, which returns true 90% of the time</li> <li>The console executes the command <code>/petblocks lookatowner %petblocks_pet_name% %petblocks_owner_name%</code></li> </ol> </li> <li>Switch to moveToOwner if pet is too far away<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is bigger than 7 blocks.</li> <li>If true, the console executes the command <code>/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%</code> , which switches the loop <code>idle</code> to the loop called <code>moveToOwner</code>.</li> <li>If false, this loop continous and starts again from the top with <code>Delay Action</code></li> </ol> </li> </ol> <pre><code>loops:\n  idle: \n    actions:\n      - name: \"Delay Action\"\n        type: \"DELAY\"\n        ticks: 20\n      - name: \"Look at owner with a 90% change.\"\n        condition:\n          type: JAVASCRIPT\n          js: \"Math.floor(Math.random() * 100) &lt;= 90\" # Calculate chance in JavaScript.\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks lookatowner %petblocks_pet_name% %petblocks_owner_name%\"\n      - name: \"Switch to moveToOwner if pet is too far away\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &gt; 7\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%\"\n</code></pre>"},{"location":"template/#movetoowner-loop","title":"MoveToOwner Loop","text":"<p>As we noticed that the loop changes to the loop <code>moveToOwner</code>, we take a look at this loop too.</p> <ol> <li>Recalculate path and start moving to owner.<ol> <li>The console executes the command <code>/petblocks moveToOwner %petblocks_pet_name% 0.2 %petblocks_owner_name%</code></li> </ol> </li> <li>Switch to idle if the pet is beside the player<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is smaller than 4 blocks.</li> <li>If true, the console executes the command <code>/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%</code> , which switches the loop <code>moveToOwner</code> to the loop called <code>idle</code>.</li> <li>If false, the next action is executed.</li> </ol> </li> <li>Teleport pet to player if the pet is too far away for the pathfinder.<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is bigger than 20 blocks.</li> <li>If true, the command is executed to teleport the pet to the owner location.</li> <li>If false, the next action is executed.</li> </ol> </li> <li>Delay Action<ol> <li>We wait for 20 ticks.</li> <li>The loop continous and starts again from the top with <code>Recalculate path and start moving to owner</code></li> </ol> </li> </ol> <pre><code>loops:\n  moveToOwner:\n    actions:\n      - name: \"Recalculate path and start moving to owner.\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks moveToOwner %petblocks_pet_name% 0.2 %petblocks_owner_name%\"\n      - name: \"Switch to idle if the pet is beside the player\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &lt; 4\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks loop %petblocks_pet_name% idle %petblocks_owner_name%\"\n      - name: \"Teleport pet to player if the pet is too far away for the pathfinder.\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &gt; 20\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks teleport %petblocks_pet_name% %petblocks_owner_locationWorld% %petblocks_owner_locationX% %petblocks_owner_locationY% %petblocks_owner_locationZ% %petblocks_owner_locationYaw% %petblocks_owner_locationPitch% %petblocks_owner_name%\"\n      - name: \"Delay Action\"\n        type: \"DELAY\"\n        ticks: 20\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Introduction","text":"<p>PetBlocks is a Minecraft Bukkit plugin to use blocks as pets in minecraft.</p> <p>PetBlocks v8 Docs</p> <p>Are you looking for the old wiki? You can download it here.</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Adds a new pet to every player</li> <li>Use blocks or custom heads as skins for your pet</li> <li>Pets are fully programmable using embedded JavaScript + Pet Config files</li> <li>PetBlocks are fully controlable by commands</li> <li>Command can be called by the console, other plugins, command blocks and players</li> <li>Extensive Permission system</li> <li>Support for custom models</li> <li>Easy integration into your server. </li> <li>Easy integration into existing GUI plugins (e.g. DeluxeMenu)</li> <li>PlaceHolderApi Support</li> <li>Multiple pets per player (Premium)</li> </ul>"},{"location":"#installation","title":"Installation","text":""},{"location":"#petblocks-latest","title":"PetBlocks-Latest","text":"<ul> <li>Java 17 </li> <li>Spigot 1.20.2</li> </ul>"},{"location":"#petblocks-premium","title":"PetBlocks-Premium","text":"<ul> <li>Java 17</li> <li>Spigot 1.17-1.20.2</li> </ul>"},{"location":"commands/","title":"Commands","text":"<p>PetBlocks is a command line based pet plugin. This means, you can fully control the pets using commands, which may be executed by players, console,  other plugins, command blocks.</p> <p>e.g. Letting the pet named <code>pet</code> of player <code>Steve98</code> move to a certain location from the console. (The pet has to be in a nearby location)</p> <pre><code>/petblocks moveto pet &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;speed&gt; [player]\n</code></pre> <pre><code>petblocks moveto pet 250 5 300 0.2 Steve98\n</code></pre> <p>Removing the pet under certain conditions</p> <p>You can always take a way the <code>petblocks.pet.spawn</code> permission to remove the pet from players, if they enter certain areas (e.g. joining minigames, entering regions, etc.)</p>"},{"location":"commands/#command-petblocks","title":"Command /petblocks","text":"<p>PetBlocks does only have 1 command, which is restricted using permissions.</p> <p>Required Permission: <code>petblocks.command</code></p>"},{"location":"commands/#petblocks-create","title":"/petblocks create","text":"<pre><code>/petblocks create &lt;name&gt; &lt;template&gt; [player]\n</code></pre> <p>Creates a new pet for the player with the given pet template.</p> <ul> <li>Name: Identifier of a pet</li> <li>Template: Identifier of a template </li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-delete","title":"/petblocks delete","text":"<pre><code>/petblocks delete &lt;name&gt; [player]\n</code></pre> <p>Deletes the pet for the player.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-list","title":"/petblocks list","text":"<pre><code>/petblocks list [player]\n</code></pre> <p>Lists all pets of a player.</p> <ul> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-call","title":"/petblocks call","text":"<pre><code>/petblocks call &lt;name&gt; [player]\n</code></pre> <p>Spawns and teleports the pet in front of the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-lookat","title":"/petblocks lookat","text":"<pre><code>/petblocks lookat &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; [player]\n</code></pre> <p>Makes the pet look at the given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-lookatowner","title":"/petblocks lookatowner","text":"<pre><code>/petblocks lookatowner [player]\n</code></pre> <p>Makes the pet look at the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-moveto","title":"/petblocks moveto","text":"<pre><code>/petblocks moveto &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;speed&gt; [player]\n</code></pre> <p>Makes the pet walk to a given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Speed: Walking speed of the pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-movetoowner","title":"/petblocks movetoowner","text":"<pre><code>/petblocks movetoowner &lt;name&gt; &lt;speed&gt; [player]\n</code></pre> <p>Makes the pet walk to the owner.</p> <ul> <li>Name: Identifier of a pet</li> <li>Speed: Walking speed of the pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-hat","title":"/petblocks hat","text":"<pre><code>/petblocks hat &lt;name&gt; [player]\n</code></pre> <p>Makes the owner wear the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-ride","title":"/petblocks ride","text":"<pre><code>/petblocks ride &lt;name&gt; [player]\n</code></pre> <p>Makes the owner ride the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-unmount","title":"/petblocks unmount","text":"<pre><code>/petblocks unmount &lt;name&gt; [player]\n</code></pre> <p>Makes the owner unmount (stop riding/hat) the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-teleport","title":"/petblocks teleport","text":"<pre><code>/petblocks teleport &lt;name&gt; &lt;world&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; &lt;yaw&gt; &lt;pitch&gt; [player]\n</code></pre> <p>Teleports the pet to the given location.</p> <ul> <li>Name: Identifier of a pet</li> <li>World: Target world</li> <li>X: X Coordinate</li> <li>Y: Y Coordinate</li> <li>Z: Z Coordinate</li> <li>Yaw: Horizontal Axe</li> <li>Pitch: Vertical Axe</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-velocity","title":"/petblocks velocity","text":"<pre><code>/petblocks velocity &lt;name&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; [player]\n</code></pre> <p>Launches the pet into the given direction.</p> <ul> <li>Name: Identifier of a pet</li> <li>World: Target world</li> <li>X: X Vector</li> <li>Y: Y Vector</li> <li>Z: Z Vector</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skintype","title":"/petblocks skintype","text":"<pre><code>/petblocks skintype &lt;name&gt; &lt;material&gt; [player]\"\n</code></pre> <p>Changes the material used as a head. </p> <ul> <li>Name: Identifier of a pet</li> <li>Material: Minecraft material name e.g. STONE</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinnbt","title":"/petblocks skinnbt","text":"<pre><code>/petblocks skinnbt &lt;name&gt; &lt;nbt&gt; [player]\n</code></pre> <p>Changes the NBT tags of the head item.</p> <ul> <li>Name: Identifier of a pet</li> <li>NBT: Standard Minecraft NBT format. e.g. {Unbreakable:1}</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinbase64","title":"/petblocks skinbase64","text":"<pre><code>/petblocks skinbase64 &lt;name&gt; &lt;skin&gt; [player]\n</code></pre> <p>Changes the head material to player_head and sets the base64 encoded texture url. </p> <ul> <li>Name: Identifier of a pet</li> <li>Skin: Bas64 Encoded Texture value e.g. <code>eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYThhZDZmYzEyNzA4NDQ2ZWI2NmM3NTY5ZTI4ZDVlMjUyMWQyMTQ2MzQ4YjQ4YmY2YzQ3ZjU0OGQ5ZWVjNDYwYSJ9fX0=</code> on https://minecraft-heads.com/custom-heads/humanoid/67436-beegsmol-mumei </li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-skinheaddatabase","title":"/petblocks skinheaddatabase","text":"<pre><code>/petblocks skinheaddatabase &lt;name&gt; &lt;hdbId&gt; [player]\n</code></pre> <p>Changes the head material to player_head and sets the texture url from a skin loaded by the HeadDatabase plugin.</p> <ul> <li>Name: Identifier of a pet</li> <li>HdbId: Internal id the HeadDatabase plugin uses.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-rename","title":"/petblocks rename","text":"<pre><code>/petblocks rename &lt;name&gt; &lt;displayname&gt; [player]\n</code></pre> <p>Changes the display name of the pet. Does not accept spaces. Underlines '_' are automatically replaced by spaces. Allows values should be set in the <code>config.yml</code>.</p> <ul> <li>Name: Identifier of a pet</li> <li>DisplayName: Name hovering above the pet, which supports ChatColors.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-visibility","title":"/petblocks visibility","text":"<pre><code>/petblocks visibility &lt;name&gt; &lt;type&gt; [player]\n</code></pre> <p>Changes who can see the pet. </p> <ul> <li>Name: Identifier of a pet</li> <li>Types: Possibles values: <code>ALL</code>, <code>OWNER</code></li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-loop","title":"/petblocks loop","text":"<pre><code>/petblocks loop &lt;name&gt; &lt;loop&gt; [player]\n</code></pre> <p>Changes which loop from the template is being executed by the pet. Example loops are <code>idle</code>.</p> <ul> <li>Name: Identifier of a pet</li> <li>Loop: Identifier of a loop in the template of the pet.</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-template","title":"/petblocks template","text":"<pre><code>/petblocks template &lt;name&gt; &lt;template&gt; [player]\n</code></pre> <p>Changes the template of a pet without recreating the pet.</p> <ul> <li>Name: Identifier of a pet</li> <li>Template: Template identifier e.g. classic</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-spawn","title":"/petblocks spawn","text":"<pre><code>/petblocks spawn &lt;name&gt; [player]\n</code></pre> <p>Spawns the pet if it has not already spawned.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-despawn","title":"/petblocks despawn","text":"<pre><code>/petblocks despawn &lt;name&gt; [player]\n</code></pre> <p>Despawns the pet if it has not already despawned.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-toggle","title":"/petblocks toggle","text":"<pre><code>/petblocks toggle &lt;name&gt; [player]\n</code></pre> <p>Toggles the pet spawn state.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"commands/#petblocks-select","title":"/petblocks select","text":"<pre><code>/petblocks select &lt;name&gt; [player]\n</code></pre> <p>Makes the owner select one of his pets as primary pet. This is only helpful if a single player has got multiple pets in PetBlocks-Premium.</p> <ul> <li>Name: Identifier of a pet</li> <li>Player: Optional player_name/player_UUID parameter targeting a player from the console or command block.</li> </ul>"},{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#can-i-use-petblocks-to-attack-enemies-eg-zombies-or-other-players","title":"Can I use PetBlocks to attack enemies (e.g. Zombies) or other players?","text":"<p>Pets in PetBlocks can be programmed in the pet.yml file to perform such behaviors. You would need a PlaceHolderApi placeholder which contains the location of the entity you want to attack (will be added in a future update to PetBlocks, but there may already be plugins out there, which provide that). Then, create a new loop where the pet moves to to the entity using the <code>/petblocks moveTo &lt;x&gt; &lt;y&gt; &lt;z&gt;</code> command. Once the pet is near the entity, make it jump using <code>/petblocks velocity &lt;x&gt; &lt;y&gt; &lt;z&gt;</code> and execute command to damage the entity <code>/damage @e[type=zombie,limit=1,sort=nearest] 20</code></p>"},{"location":"faq/#how-can-i-use-petblocks-for-an-older-minecraft-version","title":"How can I use PetBlocks for an older Minecraft version?","text":"<p>Maintaining backwards compatibility is very hard and actively discouraged by spigot. I do my best to add more and more workarounds. However, it has become so much work, that you can only download them by becoming a Patreon https://www.patreon.com/Shynixn.</p>"},{"location":"gui/","title":"GUI","text":"<p>PetBlocks does no longer have its own GUI, because PetBlocks wants to focus on being a pet plugin instead of a GUI plugin. </p> <p>There are many very good GUI plugins outthere. One popular example is DeluxeMenu. PetBlocks distributes a pre-made DeluxeMenu GUI, to get the old PetBlocks GUI back. </p>"},{"location":"gui/#installing-the-classic-petblocks-gui","title":"Installing the classic PetBlocks GUI","text":"<ul> <li>Install DeluxeMenu</li> <li>Install PlaceHolderApi</li> <li>Copy the contents from the <code>plugins/PetBlocks/thirdparty/DeluxeMenu</code> folder to the <code>plugins/DeluxeMenu</code> folder. Restart the server. Execute <code>/petblocksmenu</code>   with the permission <code>petblocks.deluxemenu</code>.</li> </ul>"},{"location":"permission/","title":"Permission","text":"<p>The following permissions are available in PetBlocks.</p>"},{"location":"permission/#levels","title":"Levels","text":"<ul> <li>User: A permission all players can have.</li> <li>Admin: A permission only Admins should have.</li> <li>Admin/User: Depending on your server, you may give this permission to your players. If you are not sure, try to build your server around not giving this permission to your players.</li> </ul> Permission Level Description petblocks.command User Allows to use the /petblocks command. petblocks.help User Allows to see the help messages. petblocks.reload Admin Permission to use the /petblocks reload command. petblocks.pet.create Admin/User Allows to create a new pet.  This command should probably be executed by a GUI / Sign / Server Management Plugin. If you set receivePetsOnJoin in the config.yml, you do not need this permission. petblocks.pet.call User Allows to call the pet to the owner. petblocks.pet.spawn User Minimum required permission a player has to have in order to have a pet. If you remove this permission from a player, the pet automatically despawns. petblocks.pet.ride User Allows to ride a pet. petblocks.pet.hat User Allows to wear the pet like a hat petblocks.pet.unmount User Allows stop riding or stop wearing at pet petblocks.pet.list User Allows to list the pets of a player petblocks.pet.delete Admin/User Allows to delete a pet. It depends on the type of server if you want to give this permission to your players. This command should be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.displayName User Allows to rename a pet. petblocks.pet.toggle User Allows to toggle a pet. petblocks.pet.despawn User Allows to despawn at pet. petblocks.pet.skin Admin/User Allows to change the skin via command. This command should probably be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.skin.headDataBase Admin/User Allows to change the skin via the HeadDatabase plugin. This command should probably be executed by a GUI / Sign / Server Management Plugin. petblocks.pet.lookat Admin/User Allows to force the pet to look at a given location petblocks.pet.lookatOwner Admin/User Allows to force the pet to look at the owner petblocks.pet.moveto Admin/User Allows to force the pet to move to a given location petblocks.pet.movetoOwner Admin/User Allows to force the pet to move to the owner petblocks.pet.teleport Admin/User Allows to force the pet to teleport to a given location petblocks.pet.velocity Admin/User Allows to force the pet to fly to a given direction petblocks.pet.visibility Admin/User Allows to change the pet visibility. petblocks.pet.loop Admin/User Allows to change the pet loop. A loop is discussed further in the pet customization section. petblocks.pet.loop Admin/User Allows to change the pet loop. A loop is discussed further in the pet customization section. petblocks.pet.setTemplate Admin/User Allows to change the template of a pet. petblocks.pet.manipulateOther Admin Allows to manipulate the pets of other players. e.g. Changing skins, etc. petblocks.pet.select Admin/User Allows to mark a pet as selected. This is helpful for placeholders. petblocks.pet.headDatabaseInventoryHook Admin/User Should the skin of a pet change to the last head you have clicked on in the HeadDatabase plugin GUI? petblocks.pet.template. Admin/User If you give your players access to <code>petblocks.pet.create</code>, each individual template is still locked by this permission. petblocks.pet.amount. Admin/User If you give your players access to <code>petblocks.pet.create</code>, the access to the slot where the pet is stored. e.g.  petblocks.pet.amount.1 (slot 1) and petblocks.pet.amount.2 (slot 2)"},{"location":"placeholders/","title":"PlaceHolders","text":"<p>The following placeholders are available in PetBlocks and can also be used via PlaceHolderApi.</p> <p>PlaceHolder Api</p> <p>As PetBlocks supports multiple pets per player, you need to select the pet in your placeholders. You can do this by appending the pet slot <code>_1</code> <code>_2</code> etc. or use the <code>/petblocks select &lt;name&gt;</code> command to set a pet as selected which can be retrieved using <code>_selected</code>. This results into placeholders such as e.g. <code>%petblocks_pet_displayName_1%</code> or <code>%petblocks_pet_displayName_selected%</code>. This is only relevant in external plugins. For actions in PetBlocks, you can directly use the placeholders below.</p> Player PlaceHolders Description %petblocks_owner_name% Player name of the owner of a pet. %petblocks_owner_displayName% Player displayName of the owner of a pet. %petblocks_owner_locationWorld% Name of the world the owner of a pet is inside. %petblocks_owner_locationX% X coordinate of the owner of a pet. %petblocks_owner_locationY% Y coordinate of the owner of a pet. %petblocks_owner_locationZ% Z coordinate of the owner of a pet. %petblocks_owner_locationYaw% Yaw rotation of the owner of a pet. %petblocks_owner_locationPitch% Yaw rotation of the owner of a pet. Pet PlaceHolders Description %petblocks_pet_name% Id of a pet %petblocks_pet_displayName% Displayname of a pet %petblocks_pet_distanceToOwner% Distance from the pet to the owner.  If the owner is in another world, this value becomes very high. %petblocks_pet_exists% True if the pet exists, false if not. %petblocks_pet_isSpawned% True if the pet is spawned, false if not. %petblocks_pet_template% Name of the template a pet uses. %petblocks_pet_visibility% Visibility Type a pet uses. %petblocks_pet_isMounted% True if the owner rides the pet or uses it as a hat. %petblocks_pet_loop% Name of the loop a pet currently executes. %petblocks_pet_locationWorld% Name of the world the pet is inside. %petblocks_pet_locationX% X coordinate of the pet. %petblocks_pet_locationY% Y coordinate of the pet. %petblocks_pet_locationZ% Z coordinate of the pet. %petblocks_pet_locationYaw% Yaw rotation of the pet. %petblocks_pet_locationPitch% Yaw rotation of the pet. %petblocks_pet_itemType% The head item type of the pet. %petblocks_pet_itemNbt% The head item NBT of the pet. %petblocks_pet_itemHeadBase64% The head item Base64 Skin Url of the pet. Event Player PlaceHolders Description %petblocks_eventPlayer_name% Player name of the owner of a pet. %petblocks_eventPlayer_displayName% Player displayName of the owner of a pet. %petblocks_eventPlayer_locationWorld% Name of the world the owner of a pet is inside. %petblocks_eventPlayer_locationX% X coordinate of the owner of a pet. %petblocks_eventPlayer_locationY% Y coordinate of the owner of a pet. %petblocks_eventPlayer_locationZ% Z coordinate of the owner of a pet. %petblocks_eventPlayer_locationYaw% Yaw rotation of the owner of a pet. %petblocks_eventPlayer_locationPitch% Yaw rotation of the owner of a pet."},{"location":"receivingpets/","title":"Giving Pets to Players","text":"<p>Once you have setup the permission, join your server. The PetBlocks default configuration creates a pet with template <code>classic</code> for you and makes it spawn in front of you. If you cannot see the pet, try executing <code>/petblocks call pet</code> or review your permissions again.</p> <p>Make sure your players have this permission to see their pet: <pre><code>petblocks.pet.spawn\n</code></pre></p> <p>The next step is to decide, how you want your players to receive a pet. There are multiple options below.</p>"},{"location":"receivingpets/#receiving-a-pet-on-first-join","title":"Receiving a pet on first join","text":"<p>This is enabled per default and can be changed in the <code>config.yml</code> under <code>pet/receivePetsOnJoin</code>. This creates a new database entry for each joining player, regardless if he has the spawn permission or not. The player requires the minimum <code>petblocks.pet.spawn</code> to see their pet.</p> <p>If you want to receive no pets on join and unlock pets later own (e.g. for shops or VIP perks), change this to: </p> <pre><code>pet:\n  receivePetsOnJoin: []\n</code></pre> <p>If you want to receive multiple pets (PetBlocks-Premium only) on first join. Append other pets below it. They have to have different names.</p> <pre><code>pet:\n  receivePetsOnJoin:\n    - name: \"pet1\"\n      template: \"classic\"\n    - name: \"pet2\"\n      template: \"classic\"      \n</code></pre> <p>In order to configure, if the pet should automatically spawn in front of the player on creation, open the template  <code>plugins/PetBlocks/pets/pet_classic.yml</code>. Set <code>pet/spawned</code> to <code>true</code> or <code>false</code>.</p>"},{"location":"receivingpets/#receiving-pets-using-a-shop","title":"Receiving pets using a shop","text":"<p>There are many ways how you can handle it. These are just examples below:</p> <p>Building GUIS with DeluxeMenu</p> <p>PetBlocks distributes premade DeluxeMenu based inventories, which may help you design your own inventories. See the GUI page for more details.</p>"},{"location":"receivingpets/#option-1-just-selling-skins-for-your-pet-easy","title":"Option 1 - Just selling skins for your pet (easy)","text":"<ol> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Keep the receive pet on join settings, the player should receive a pet everytime. </li> <li>Invent a new permission for each pet you would like to sell like <code>petblocks.pettype.&lt;yourpettype&gt;</code> e.g. <code>petblocks.pettype.pikachu</code>.</li> <li>Once a player buys the item in your shop, give them your newly invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Show an item in your GUI to change the skin to pikachu only, if the player has got the newly invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Execute the command with server level permission:</li> </ol> <pre><code>/petblocks skinbase64 pet eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdlYmNlZjQ2ODNjZGI3MTYzZTk2OWU0ZTIyNjlmMzY3M2E1ZDVlNmI3OGUwNmZhZWU0NWJjZjdjNDljMzk3In19fQ== %petblocks_owner_name%\n</code></pre> <p>DeluxeMenu e.g.: <pre><code>[console] petblocks skinbase64 %petblocks_pet_name_selected% eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdlYmNlZjQ2ODNjZGI3MTYzZTk2OWU0ZTIyNjlmMzY3M2E1ZDVlNmI3OGUwNmZhZWU0NWJjZjdjNDljMzk3In19fQ== %petblocks_owner_name%\n</code></pre></p>"},{"location":"receivingpets/#option-2-state-handling-of-pets-hard","title":"Option 2 - State handling of pets (hard)","text":"<ol> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Disable receive pet on join like shown above</li> <li>Invent a new permission for each pet you would like to sell like <code>petblocks.pettype.&lt;yourpettype&gt;</code> e.g. <code>petblocks.pettype.pikachu</code>. </li> <li>Once a player buys the item in your shop, give them your new invented permission e.g. <code>petblocks.pettype.pikachu</code></li> <li>Build a pet management GUI using an external GUI plugin (e.g. DeluxeMenu).</li> <li>Create a new item which is only visible if the player has obtained the e.g. <code>petblocks.pettype.pikachu</code> permission.</li> <li>When the player clicks on that item, execute the following command with server level permission:</li> </ol> <pre><code>/petblocks create &lt;petName&gt; &lt;templateName&gt; %petblocks_owner_name%\n</code></pre> <p>DeluxeMenu e.g.:</p> <pre><code>[console] petblocks create pet classic %petblocks_owner_name%\n</code></pre> <p>Executing the create command multiple times is fine, it does not do anything if the pet already exists.</p>"},{"location":"receivingpets/#option-3-free-creationdeletion-of-pets-for-players-easy","title":"Option 3 - Free creation/deletion of pets for players (easy)","text":"<ol> <li>Give your players the permission to the following</li> </ol> <pre><code>petblocks.pet.create\npetblocks.pet.delete\npetblocks.pet.amount.1\n</code></pre> <ol> <li>Disable receive pet on join like shown above</li> <li>Build a shop GUI using an external GUI plugin. (e.g. DeluxeMenu).</li> <li>Once a player buys the item in your shop, give them the permission to the petblocks template e.g. <code>petblocks.pet.template.classic</code>.</li> <li>Let the player freely execute <code>/petblocks create &lt;petName&gt; classic</code> and  <code>/petblocks delete &lt;petName&gt;</code> . You can also setup this in a GUI.</li> </ol>"},{"location":"template/","title":"Template","text":"<p>PetBlocks allows you to create templates, how a pet is going to look like and how it is going to behave. You can fully customize the behaviour and program the pets to perform certain actions.</p> <p>PetBlocks provides you with a starting pet template called <code>classic</code>, which can be found in the <code>plugins/PetBlocks/pets/</code> folder. You can copy this template and start desigining your own pets. Make sure to give it a new unique template identifier.</p> <p>Modify a template and execute <code>/petblocks reload</code> to apply the changes to your pet.</p>"},{"location":"template/#static-values","title":"Static Values","text":"<p>Most of the static values are explained in the config file itself. Set them according to your needs.</p> <p>Example for static values are <code>name</code>, <code>version</code> and all initial pet settings under <code>pet:</code>.</p>"},{"location":"template/#events","title":"Events","text":"<p>Events define what happens on certain events. Currently only leftClick and rightClick on the pet is supported. These actions get executed when a player left clicks on the pet. However, it may not be the owner, who clicks on a pet, therefore it needs to be checked if you only want to allow certain actions for the owner of the pet.</p> <p>Example:</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"Open the DeluxeMenu based pet inventory\" #  You need to install the plugin DeluxeMenu for this to work and copy the premade PetBlocks inventory from the thirdparty folder.\n        condition:\n          type: STRING_EQUALS\n          left: \"%petblocks_eventPlayer_name%\"\n          right: \"%petblocks_owner_name%\"\n        type: \"COMMAND\"\n        level: \"PLAYER\"\n        run:\n          - \"/petblocks select %petblocks_pet_name%\"\n          - \"/dm open petblocks_menu %petblocks_eventPlayer_name%\"\n</code></pre> <p>If you want to execute nothing when the player rightClicks on the pet, remove all actions.</p> <pre><code>events:\n  rightClick:\n    actions: []\n</code></pre>"},{"location":"template/#building-a-new-action","title":"Building a new action","text":"<p>PlaceHolders</p> <p>You can use placeholders almost anywhere when building actions. You can even use PlaceHolderApi based placeholders.</p> <p>Create a new action and give it an arbitrary name.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n</code></pre> <p>Select the action type. Support actions are <code>COMMAND</code>, <code>DELAY</code>, <code>JAVASCRIPT</code>.</p>"},{"location":"template/#command","title":"COMMAND","text":"<p>Executes one or multiple commands as Console or Player.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n</code></pre> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#delay","title":"DELAY","text":"<p>Delays the next action for a certain amount of ticks.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"Delay Action\" # Required arbitrary name.\n        type: \"DELAY\" # Required action type.\n        ticks: 60 # Required for type DELAY. 60 Ticks delay.\n</code></pre>"},{"location":"template/#javascript","title":"JAVASCRIPT","text":"<p>Executes JavaScript based Code for value calculation</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"JavaScript action\" # Required arbitrary name.\n        type: \"JAVASCRIPT\" # Required action type.\n        initial: \"Cool\" # Required for type JAVASCRIPT. The initial value of the result variable.\n        variable: \"myVariable\" # Required for type JAVASCRIPT. The name of the result variable, which can be read using PlaceHolders.\n        js: |                  # Required for type JAVASCRIPT. Actual multi line JavaScript code.\n          function createText() {\n             var text = \"%petblocks_js_myVariable%\" + \" Plugin\"\n             return text\n          }\n          createText();\n</code></pre>"},{"location":"template/#restricting-actions","title":"Restricting Actions","text":""},{"location":"template/#permission","title":"Permission","text":"<p>Actions can optionally have the permission tag:</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        permission: \"mycustom.permission\"\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#conditions","title":"Conditions","text":"<p>Actions can optionally have conditions, which support 2 types: <code>STRING_EQUALS</code> and <code>JAVASCRIPT</code>.  Prefer using <code>STRING_EQUALS</code> over <code>JAVASCRIPT</code>. <code>STRING_EQUALS</code> checks if the 2 values in <code>left</code> and <code>right</code> are the same. <code>JAVASCRIPT</code> evaluates a boolean expression.</p> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        condition: # Optional condition tag.\n          type: STRING_EQUALS # Required condition type.\n          left: \"%petblocks_eventPlayer_name%\" \n          right: \"%petblocks_owner_name%\"\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre> <pre><code>events:\n  rightClick:\n    actions:  # You can add/remove actions as you want here.\n      - name: \"My new action\" # Required arbitrary name.\n        condition: # Optional condition tag.\n          type: JAVASCRIPT # Required condition type.\n          js: \"Math.floor(Math.random() * 100) &lt;= 50\" # 50% chance to execute this command.\n        type: \"COMMAND\" # Required action type.\n        level: \"SERVER\" # Required for type COMMAND. Possible values are PLAYER (player level permission), SERVER (console level permission)\n        run: \n          - \"/say Hello %petblocks_owner_name%\" # Required for type COMMAND. One or more commands are allowed.\n</code></pre>"},{"location":"template/#loops","title":"Loops","text":"<p>Loops define, what the pet should repeatedly do. You can customize and define your own loops using actions.</p> <p>Programmable Pets</p> <p>You can freely build new loops, delete loops and customize the behavior of pets. The actions allow full freedom to  design your pets. </p>"},{"location":"template/#idle-loop","title":"Idle Loop","text":"<p>The idle loop explained:</p> <ol> <li>Delay Action<ol> <li>We wait for 20 ticks.</li> </ol> </li> <li>Look at owner with a 90% change.<ol> <li>The JavaScript condition is evaluated, which returns true 90% of the time</li> <li>The console executes the command <code>/petblocks lookatowner %petblocks_pet_name% %petblocks_owner_name%</code></li> </ol> </li> <li>Switch to moveToOwner if pet is too far away<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is bigger than 7 blocks.</li> <li>If true, the console executes the command <code>/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%</code> , which switches the loop <code>idle</code> to the loop called <code>moveToOwner</code>.</li> <li>If false, this loop continous and starts again from the top with <code>Delay Action</code></li> </ol> </li> </ol> <pre><code>loops:\n  idle: \n    actions:\n      - name: \"Delay Action\"\n        type: \"DELAY\"\n        ticks: 20\n      - name: \"Look at owner with a 90% change.\"\n        condition:\n          type: JAVASCRIPT\n          js: \"Math.floor(Math.random() * 100) &lt;= 90\" # Calculate chance in JavaScript.\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks lookatowner %petblocks_pet_name% %petblocks_owner_name%\"\n      - name: \"Switch to moveToOwner if pet is too far away\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &gt; 7\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%\"\n</code></pre>"},{"location":"template/#movetoowner-loop","title":"MoveToOwner Loop","text":"<p>As we noticed that the loop changes to the loop <code>moveToOwner</code>, we take a look at this loop too.</p> <ol> <li>Recalculate path and start moving to owner.<ol> <li>The console executes the command <code>/petblocks moveToOwner %petblocks_pet_name% 0.2 %petblocks_owner_name%</code></li> </ol> </li> <li>Switch to idle if the pet is beside the player<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is smaller than 4 blocks.</li> <li>If true, the console executes the command <code>/petblocks loop %petblocks_pet_name% moveToOwner %petblocks_owner_name%</code> , which switches the loop <code>moveToOwner</code> to the loop called <code>idle</code>.</li> <li>If false, the next action is executed.</li> </ol> </li> <li>Teleport pet to player if the pet is too far away for the pathfinder.<ol> <li>The JavaScript condition is evaluated, if the distance of the pet to the owner is bigger than 20 blocks.</li> <li>If true, the command is executed to teleport the pet to the owner location.</li> <li>If false, the next action is executed.</li> </ol> </li> <li>Delay Action<ol> <li>We wait for 20 ticks.</li> <li>The loop continous and starts again from the top with <code>Recalculate path and start moving to owner</code></li> </ol> </li> </ol> <pre><code>loops:\n  moveToOwner:\n    actions:\n      - name: \"Recalculate path and start moving to owner.\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks moveToOwner %petblocks_pet_name% 0.2 %petblocks_owner_name%\"\n      - name: \"Switch to idle if the pet is beside the player\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &lt; 4\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks loop %petblocks_pet_name% idle %petblocks_owner_name%\"\n      - name: \"Teleport pet to player if the pet is too far away for the pathfinder.\"\n        condition:\n          type: JAVASCRIPT\n          js: \"%petblocks_pet_distanceToOwner% &gt; 20\"\n        type: \"COMMAND\"\n        level: \"SERVER\"\n        run:\n          - \"/petblocks teleport %petblocks_pet_name% %petblocks_owner_locationWorld% %petblocks_owner_locationX% %petblocks_owner_locationY% %petblocks_owner_locationZ% %petblocks_owner_locationYaw% %petblocks_owner_locationPitch% %petblocks_owner_name%\"\n      - name: \"Delay Action\"\n        type: \"DELAY\"\n        ticks: 20\n</code></pre>"}]}
\ No newline at end of file
diff --git a/docs/wiki/site/sitemap.xml.gz b/docs/wiki/site/sitemap.xml.gz
index 525dcd3d1..923446137 100644
Binary files a/docs/wiki/site/sitemap.xml.gz and b/docs/wiki/site/sitemap.xml.gz differ