[Holograms] Simple holograms icons | ItemsAdder addon 1.01

Native Minecraft Version:

1.16

Tested Minecraft Versions:

• 1.15
• 1.16

Contributors:

_TheGust_, LoneDev

Languages Supported:

English, Russian

Donation Link:

http://paypal.me/lonedevgift

This is not a plugin!
This is an addon for ItemsAdder

Make your server-selections NPC's more interesting and unique.

Article languages:

Spoiler: For English speaking

About:
The addon is based on the mechanic of replacing fonts using the ItemsAdder texturepack and it can be displayed by any Holograms plugin with PlaceholderAPI support.
The addon, like all replaced fonts via ItemsAdder, will not work for players if they use the Force-unicode function in language options. This is caused by bad game mechanic, you can fix that by using this information.
.

How to install addon:

Spoiler: How?

step 1) Install ItemsAdder (v2.1.23 or newer) plugin himself
step 2) Install PlaceholderAPI
step 3) Install any Holographic display plugin with PlaceholderAPI support (HolographicDisplay + HolographicExtentsion or Holograms + HologramsPlaceholder)
step 4) Install any NPC's plugin or Portal commands plugin, if you want make an NPC under a hologram or make a portal with a transition to other Bungee servers
(Citizens 2 or ZNPC's as example for NPC's, OptimalBungeePortals or AdvancedPortals as example for portals).
step 5) Move "plugins" folder from zip-archive into your root server folder.
step 6) Type "/iazip" command on your spigot server and follow next option:

Spoiler: For eternal texturepack hosting

- if you use eternal host as a texturepack host - send auto-generated texturepack (ItemsAdder/data/assets/resouce_pack/pack.zip) on your eternal host and paste the link into the main itemsadder config file, after this - type "/iareload" and "/iatexture all" commands to reload and download (redownload) your texturepack.

Spoiler: For self-hosting texturepack

- if you use self-hosting - type "/iareload" and you don't need to do anything else.

step 7) Done.

How to use icons:

Spoiler: How?

Create a hologram via your holographic plugin (If you want make an NPC with transition to other Bungee servers - create holo over an NPC):

• as first holo-line paste FONT-image picture via placeholder %img_NAME% (as example %img_holo_skyblock% - you can find image name in "plugins/ItemsAdder/data/items_packs/hologram_icons/hologram_icons.yml" )
• as second holo-line paste empty space (I used colorcode with nothing else - "&n")
• as third and last holo-line paste your text (the maximum number of characters is ≈18-20 in line, If you want to insert a placeholder - count only finite value of characters that the placeholder outputs. Colorcodes, with the exception of &L, do not affect the number or size of characters), I used this: "&fNow playing: &6%bungee_skyblock%" as example (14-15 characters).
  Spoiler: %bungee% online placeholder

  To use placeholder %bungee_servername% you need the Bungee library for placeholderapi (to download it - type this following command: "/papi ecloud download Bungee")

Profit.

How to create your own icons:

Spoiler: How?

step 1) Open "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font/example_stuff" folder to get image examples, copy one of this and edit it in any graphics editor with support for transparency textures (Paint.NET, Photoshop, GIMP or similar programs) or edit my source file "icon_blank_souce.psd" in Photoshop.
step 2) Save result-image as .PNG file
step 3) Move it to "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font/example_stuff" (or create your own namespace in "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font" folder and move your PNG file there).
step 4) Open "plugins/ItemsAdder/data/items_packs/hologram_icons/hologram_icons.yml" configuration-file and add new lines at the end:

Code (Text):

  YOUR_PLACEHOLDER_NAME_HERE:                             #needed for %img% PAPI placeholder
    permission: YOUR_PERMISSION_HERE
    show_in_gui: false
    path: "PATH_TO_YOUR_PNG_FILE with .png on the end"    #"font/example_stuff/icon_skyblock.png" as example
    scale_ratio: 32
    y_position: 8  

step 5) Profit.

Screenshoots:

Spoiler: Default content of the addon

In Addon you can find 4 default example-icons of simple minigames for your server:

Also, I leave Photoshop-file with blank-icon for your easier own icons creations:

And of course I leave readme.txt file with all needed information

simple hologram server-title:



If icons won't working - check whether everything is installed correctly. You can check this with "/iaemoji" and hints game mechanic. If you can't find any icons - you make a mistake with installation.

Spoiler: Для русских комрадов

Кратко об аддоне:
Аддон базируется на механике плагина ItemsAdder заменять текстуры шрифтов и каждый символ может быть показан любым плагином на голограммы с поддержкой PlaceholderAPI.
Аддон, как и любые другие аддоны связанные с этой механикой, а так же контент самого ItemsAdder'а, перестает работать, если пользователь включит "насильное" использование символов юникода. Чтобы это пофиксить - используйте информацию из этой статьи.
.

Как установить:

Spoiler: Установка аддона

Шаг 1) Установи непосредственно сам ItemsAdder (версии 2.1.23 или новее) и не в коем случае не скачивай сливы с blackspigot'а.
Шаг 2) Установи PlaceholderAPI
Шаг 3) Установи любой плагин на голограммы с поддержкой PlaceholderAPI (советую связки HolographicDisplay + HolographicExtentsion или Holograms + HologramsPlaceholder)
Шаг 4) Установи любой плагин на NPC's или порталы с командами, если хочешь разместить NPC с интерактивом под данной иконкой или сделать портал с перемещением игрока по твоим серверам в связке банжи.
(советую Citizens 2 (платный) или ZNPC's (халявный), если хочешь использовать NPC, OptimalBungeePortals (платный) или AdvancedPortals (халявный), если хочешь использовать порталы).
Шаг 5) Перемести папку "plugins" из zip-архива в корневую папку сервера рядом с ядром.
Шаг 6) Используй команду "/iazip" на твоем спигот-сервере и следуй следующему указанию:

Spoiler: Для тех, кто использует внешние сервисы, по типу Dropbox'а

- если ты используешь внешку в качестве хоста для текстур - залей автоматически-сгенерированный пакет текстур (он находится тут: ItemsAdder/data/assets/resouce_pack/pack.zip) на твой внешний ресурс и запиши ссылку на него в основной itemsadder конфиг, если ты этого еще не делал. После - используй команды "/iareload" и "/iatexture all" чтобы перезагрузить конфигурации плагина и насильно залить (перезалить) всем игрокам набор текстур.

Spoiler: Для тех, кто держит текстуры прямо на сервере локально

- если ты в адеквате и используешь этот способ - просто пропиши "/iareload" и больше ничего не делай, все должно прекрасно работать.

Шаг 7) Готово.

Окей, я установил, а дальше чо, как это использовать?:

Spoiler: Как использовать иконки

Создай голограмму при помощи установленного ранее плагина на голограммы, если делаешь это в связке с NPC - размещай ее у него над головой):

• в качестве первой строки вставь свою иконку в качестве placeholder'а %img_НАЗВАНИЕ% (Как пример для тех, кто вообще в танке - %img_holo_skyblock%. Все названия таких картинок вы устанавливаете самостоятельно в "plugins/ItemsAdder/data/items_packs/hologram_icons/hologram_icons.yml" )
• в качестве второй линии вставь пустое место (я вставил цветовой код без каких либо символов - "&n", но если плагин позволяет - можно вторую строку попросту удалить после создания третьей)
• в качестве последней линии вставь свой текст, если нужно (Максимально можно разместить примерно ≈18-20 символов в этой линии. Если интегрируешь туда placeholder - следует считать только то количество символов, которое этот placeholder выдаст. Цветовые коды, за исключением &L, не меняют количество и размер символов), Я использовал эту банальную строку: "&fСейчас играют: &6%bungee_skyblock%" как пример (около 16-17 символов по итогу).
  Spoiler: %bungee% онлайн placeholder

  Чтобы использовать "заполнитель" %bungee_имя_сервера% тебе нужна библеотека Bungee для плагина PlaceholderAPI (скачать ее можно одной командой: "/papi ecloud download Bungee" и перезагрузкой плагина)

Профит.

Окей, а как мне сделать свои иконки?:

Spoiler: Создание собственных иконок

Шаг 1) Открой папку по этому пути "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font/example_stuff" чтобы получить примеры иконок, скопируй одну из этих иконок и крути как вздумается в любом графическом редакторе с поддержкой прозрачности (советую любой из этих: Paint.NET, Photoshop, GIMP или прочее) или еще проще - не открывай никаких папок, а вместо этого редактируй файл "icon_blank_souce.psd" для Photoshop'а, который я специально там оставил.
Шаг 2) Сохрани свой шедевр в .PNG формате (Важная информация - создать шрифт-картинку с анимацией невозможно из-за глупых ограничений и механик игры, все, что ты можешь с этим поделать - использовать любой костыль из вне, например, какой-нибудь плагин с анимированными голограммами).
Шаг 3) Перетащи этот файл в папку "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font/example_stuff" (ну или создай свою, если так нужно в "plugins/ItemsAdder/data/recource_pack/assets/hologram_icons/textures/font" и перекинь туда свой PNG файлик).
Шаг 4) Открой файл конфигурации по пути "plugins/ItemsAdder/data/items_packs/hologram_icons/hologram_icons.yml" и добавь туда эти строчки:

Code (Text):

  ИМЯ_ТВОЕЙ_ИКОНКИ_БЕЗ_ПРОБЕЛОВ:                             #нужно для %img% заполнителя PAPI
    permission: ПРАВА_НА_ИСПОЛЬЗОВАНИЕ #рекомендую вставить что-то недостижимое, чтобы тебе не засрали чат.
    show_in_gui: false
    path: "ПУТЬ К ФАЙЛУ с .png на конце"    #"font/example_stuff/icon_skyblock.png" как пример
    scale_ratio: 32
    y_position: 8  

Шаг 5) Профит.

Витрина скриншотов:

Spoiler: Изначальный контент аддона

В аддоне будут лежать 4 картинки-примера, которые ты можешь использовать или редактировать по желанию:

Кроме того, я оставил Photoshop-файл для твоего удобства, используй его, если у тебя есть фотошоп или Krita:

И конечно же я оставил readme.txt файл с этой же информацией (но он полностью на английском)

простое лого сервера в воздухе:



Если иконки не пашут - проверь, все ли нормально с их установкой. Ты можешь проверить это при помощи "/iaemoji" и механики подсказок. Если ты не можешь найти добавленные иконки в подсказках в чате - ты где-то ошибся.