Skip to content
TM (Holly) edited this page Jul 20, 2020 · 7 revisions

Welcome!

Here lies the guide to HeadsPlus, an advanced heads plugin of which aims to fill in the gaps that many other plugins have previously failed to manage. The documentation here on Github continues to be a work in progress, however it is starting to take final shape and I hope it can be of some sort of use to everyone visiting.

Requirements

➤ Your server version must be a minimum of 1.8 to a maximum of 1.16.1 (last updated: 20/07/2020). HeadsPlus will always be primarily tested on the latest version, which is 1.16.1, so any bugs on older versions are less likely to be caught and rely on your input.

➤ 1.7.10 is out of the question. No. Please update your server. In addition to this point, skulls were made more effective and useful in 1.8, whilst the system for them in 1.7.10 and older was awful.

➤ A Java version of 8 or later. HeadsPlus is written in Java 8 and tested on that version.

➤ If you want to enable the head selling feature, you will need the plugin Vault and a second economy plugin which utilises Vault's API. Common examples include Essentials, Ultimate Economy, eWallet and others that can be found in the following link.

➤ You will also need a permissions plugin if you want to assign players to groups when they complete challenges; if you want to host a big and public server too, permission plugins are often considered essential. I personally recommend using LuckPerms as it is frequently updated and more accessible compared to other permission plugins.

Installation

Installing the plugin is like every other plugin you'll ever install:

➤ Download the plugin off SpigotMC, or one of the snapshots on Github.

➤ Upload the jar file into the plugins folder of your server. If you do not have this folder, it is likely that you either haven't accepted the EULA (which is required before starting your server and is very important!), or you are running a Vanilla server; HeadsPlus runs on Spigot servers and is compatible with hopefully all of the Spigot forks (Paper, Tuinity and many more). It is not intended to work on Bukkit, but does have a few fail-safes for Spigot methods, however, I cannot guarantee its functionality.

➤ Restart the server, and the plugin will set itself up.

➤ If you want to allow crafting on your server, please make sure you have all creative mode worlds blacklisted (/hp blacklistwadd <World name>), then change "craft-heads" in config.yml (Perks section) to true, then reload the configuration (/hp reload). If you do not blacklist creative mode worlds, you open yourself up to a lot of exploits.

Support

Including this documentation, we do have several support services for HeadsPlus.

➤ Our primary and most active is on Discord, as it is real-time and I often have notifications enabled so I will be able to respond quickly. As of currently, we also share our server with AdvancedTeleport (Niestrat99 and Thatsmusic99), AdvancedOreGenerator and ChatPings (Niestrat99). Our Discord is also a small community not only for support but also to connect with other players and users. Come on and say hello!

➤ I also answer queries and respond to bug reports on HP's Spigot Discussion Thread, and whilst I do have email notifications enabled so I can respond quickly, this is not always the case. There has even been an instance where I was asked for support and didn't notice it at all until a week later. Regardless, this is a rare occurrence and you are 100% welcome to ask anything there.

➤ If you want to open an issue on Github for what you think could be a bug or want to request a feature, you are free to do so, but please do follow the template and avoid deleting all of it.

Currently supported languages

➤ English (Thatsmusic99)

➤ Romanian, Română (DariusTK)

➤ Hungarian, Magyar (Toldi/montlikadani)

➤ Spanish, Español (AlansS53)

➤ German, Deutsch (Niestrat99)

➤ French, Français (Alexisparis007/Cyrix)

➤ Polish, Polski (Gurbiel, Mistermychciak, YouHaveTrouble)

➤ Russian, русский (Stashenko)

➤ LOLCat (take a guess)

➤ Dutch, Nederlands (Tepoloco)