Looking for new donator perks?
Or, need some special rewards for events/quests/achievements?
How about this one: Holograms above players' heads!


Features

Collectable Medals:
You can create 'medals' with custom display text and icon to give players as a gift.
Players collect the medals that you created and choose a medal to attach its hologram to themselves, and the holograms are shown above their heads.
(It's like 'title' feature from other RPG games)

GUI for list of collected medals:
It's easy to manage your medals as using GUI.
Just one click for choosing a medal for display. No need to type commands!

MySQL Supported:
It supports not only saving data with file, but also MySQL database.
(Notice: it's only for users' data, not medals' data.)
Now supports medal data as well (v2.1.0)

Permission Medal [New in 1.1]:
'holomedals.medal.<MedalName>' permission gives you its medal automatically.
Now you don't need to send medals to your moderaters manually!

PlaceholderAPI Supported [New in 1.1]:
'%holomedals_display_medal%' and hologram text support.

Multiple Lines for Holograms [New in 1.2]:
You can split lines by using '|' character!
(Example: "Hello|My name is %player_name%")

Now Holograms Move Very Smoothly [New in 2.0]:
Yeah! I did it!
And now don't worry about lags, holograms would move not with specific period (like on old version), but through listening packets.

Support for Displaying Multiple Medals [New in 2.1]
You can make specific players be able to display multiple medals!
Permission: 'holomedals.display.<maxAmount>'





Screenshots


▲ Type #1: Moving hologram (Default)


▲ As it's impossible to show hologram to its owner smoothly, I made a feature that owners can see their hologram when they don't move.
("general.show-self-on-staying: true")



▲ Type #2: Stationary hologram ('general.display-on-staying: true' in config.yml)


▲ Displaying multiple medals (permission: 'holomedals.display.<maxDisplayableAmount>')




▲ Admin GUI



▲ Player GUI




▲ Examples of medals



▲ Example of multiple-line holograms




▲ Icons on GUI (Admin / User)



▲'general.below-name: true' on config.yml



Dependencies

This plugin requires HolographicDisplays by filoghost
and ProtocolLib by dmulloy2

(Optional: PlaceholderAPI)


How to create medals

Step #1:



Bring your item to use as the icon of medal.


Step #2:



Type the command: /hm create <medalName> <displayName>

Not allowed characters in the name of medals:

• " ; "
• " % " (except for placeholders)

Step #3:



You got it!
Use this command to see the medal you've created: /hm list

Then free to give the medal to players. /hm give <playerName> <medalName>


Don't forget if you wanna equip your medal, must use '/medals'.


Commands



Type /holomedals or /hm for help.



Configuration

Spoiler: config.yml

general.locale
Suffix of the language file. (default: lang_en.yml)

general.show-self-on-staying
Show holograms to their owners when they don't move.

general.display-on-staying
Display holograms on only not moving.

general.below-name
Display hologram below the name tag of player.

general.op-gets-all
If false, OP gets no permission medals.

mysql.enable
Use MySQL database rather than 'userdata.yml' file.


Permissions

holomedals.admin
Gives ability to use /holomedals.

holomedals.medal.<medalName>
Gain the specific medal.

holomedals.give.<medalName>
Player can give the specific medal to anyone.

holomedals.take.<medalName>
Player can take the specific medal from anyone.



Supported Language

• English [en] (by me)
• Korean [kr] (by me)
• Japanese [jp] (by kotarobo)

Developer API

(Comming Soon!)