[Holograms] Simple holograms icons | ItemsAdder addon 1.01

Add your textures for Holograms | ItemsAdder addon

  1. The_Gust
    Native Minecraft Version:
    1.16
    Tested Minecraft Versions:
    • 1.15
    • 1.16
    Contributors:
    _TheGust_, LoneDev
    Languages Supported:
    English, Russian
    This is not a plugin!
    This is an addon for ItemsAdder


    Make your server-selections NPC's more interesting and unique.
    [​IMG]

    Article languages:
    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:

    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:
    - 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.
    - if you use self-hosting - type "/iareload" and you don't need to do anything else.
    step 7) Done.

    How to use icons:
    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" [​IMG] )
    • 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).
      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:
    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:

    In Addon you can find 4 default example-icons of simple minigames for your server:
    [​IMG]
    Also, I leave Photoshop-file with blank-icon for your easier own icons creations:

    [​IMG]
    And of course I leave readme.txt file with all needed information

    [​IMG]
    [​IMG]
    simple hologram server-title:
    [​IMG]


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

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

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

    Окей, я установил, а дальше чо, как это использовать?:
    Создай голограмму при помощи установленного ранее плагина на голограммы, если делаешь это в связке с NPC - размещай ее у него над головой):
    • в качестве первой строки вставь свою иконку в качестве placeholder'а %img_НАЗВАНИЕ% (Как пример для тех, кто вообще в танке - %img_holo_skyblock%. Все названия таких картинок вы устанавливаете самостоятельно в "plugins/ItemsAdder/data/items_packs/hologram_icons/hologram_icons.yml" [​IMG] )
    • в качестве второй линии вставь пустое место (я вставил цветовой код без каких либо символов - "&n", но если плагин позволяет - можно вторую строку попросту удалить после создания третьей)
    • в качестве последней линии вставь свой текст, если нужно (Максимально можно разместить примерно ≈18-20 символов в этой линии. Если интегрируешь туда placeholder - следует считать только то количество символов, которое этот placeholder выдаст. Цветовые коды, за исключением &L, не меняют количество и размер символов), Я использовал эту банальную строку: "&fСейчас играют: &6%bungee_skyblock%" как пример (около 16-17 символов по итогу).
      Чтобы использовать "заполнитель" %bungee_имя_сервера% тебе нужна библеотека Bungee для плагина PlaceholderAPI (скачать ее можно одной командой: "/papi ecloud download Bungee" и перезагрузкой плагина)
    Профит.

    Окей, а как мне сделать свои иконки?:
    Шаг 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) Профит.


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

    В аддоне будут лежать 4 картинки-примера, которые ты можешь использовать или редактировать по желанию:
    [​IMG]
    Кроме того, я оставил Photoshop-файл для твоего удобства, используй его, если у тебя есть фотошоп или Krita:

    [​IMG]
    И конечно же я оставил readme.txt файл с этой же информацией (но он полностью на английском)
    [​IMG]
    [​IMG]
    простое лого сервера в воздухе:
    [​IMG]


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

Recent Reviews

  1. RifusX
    RifusX
    5/5,
    Version: 1.01
    Благодарность тебе за инструкцию! Действительно, ItemsAdder в СНГ использутся только поверхностно. Я ни где не видел использование всего потенциала плагина. С другой стороны, порог вхождения выше среднего :D
    1. The_Gust
      Author's Response
      Очень радует, что он становится популярнее у нас с каждым днем, пусть даже и поверхностно. Это всяко лучше, чем без него.
      Спасибо за отзыв :D
  2. Eemeego
    Eemeego
    5/5,
    Version: 1.01
    Спасибо за аддон) Вообще-то itemsadder используют в снг. Видел на данном сервере play.lollipopmc.net
    1. The_Gust
      Author's Response
      Потихоньку, коммьюнити ItemsAdder растет на РУ-сегменте, что сильно радует, ведь серверов с авторским контентом будет больше, но на момент публикации аддона - практически никто не знал об этом плагине вовсе.
      Спасибо за отзыв.
  3. Kosta_TV
    Kosta_TV
    5/5,
    Version: 1.01
    Неплохой аддон. Жаль что сам ItemsAdder в странах СНГ не используется. Ну по крайней мере, я не видел что бы использовали.

    Очень хорошая работа! 5 звёзд.
    1. The_Gust
      Author's Response
      Спасибо за отзыв, бро.
      По поводу использования IA в пределах СНГ - сам удивлен, что нигде и никто его не использует. Возможно это связано с тем, что большинство Ру-серверов это просто нагло скачанные и украденные сборки для выкачивания денег с детей и не более, но все же.
  4. RickyLaChow
    RickyLaChow
    5/5,
    Version: 1.0
    Fantastic addon for ItemsAdder
    Gust is helpful and kind
    5 stars

    Easy and fast to use
    1. The_Gust
      Author's Response
      thanks <3
  5. LoneDev
    LoneDev
    5/5,
    Version: 1.0
    Amazing job! I love your style, it looks so professional.
    I hope to see more works from you :D
    1. The_Gust
      Author's Response
      thanks for review, bro
  6. WaylunC
    WaylunC
    5/5,
    Version: 1.0
    This is absolutely wonderful addon for IA,
    but Unicode Font is base on Minecraft Limit,
    so there isn't anything we can do to fix.
    But to go though all of this addon project,
    it's something really cool,
    and thanks for a nicely addon to support.
    10/10 ★★★★★★★★★★
    1. The_Gust
      Author's Response
      Thank you.