ItemsAdder - niestandardowe przedmioty i bloki na serwerze

Co to jest ItemsAdder

ItemsAdder to płatny plugin premium stworzony przez developera o pseudonimie LoneDev. Jego głównym celem jest umożliwienie administratorom serwerów Minecraft dodawania własnych treści - przedmiotów, bloków, mebli, mobów, animacji i nakładek interfejsu - bez konieczności instalowania modów przez graczy.

Cały mechanizm opiera się na dwóch filarach: resource pack przesyłany automatycznie graczowi przy wchodzeniu na serwer oraz pliki konfiguracyjne YAML, w których admin definiuje wszystkie własne elementy. Dzięki temu z perspektywy gracza wszystko działa jak vanilla Minecraft - wystarczy zaakceptować resource pack.

Plugin jest dostępny na SpigotMC za około 25 EUR. To inwestycja, którą warto rozważyć na serwerach RPG, survivalowych z unikalną zawartością lub serwerach z własnym klimatem, gdzie wyróżnienie się jest kluczowe.

ItemsAdder jest aktywnie rozwijany od 2019 roku i posiada jedną z największych społeczności pluginów premium. Na oficjalnym forum SpigotMC plugin zebrał tysiące pozytywnych ocen i jest regularnie aktualizowany wraz z nowymi wersjami Minecrafta.

Jak działa Resource Pack

Serce ItemsAddera to własny resource pack generowany automatycznie przez plugin na podstawie Twoich plików konfiguracyjnych. Gdy gracz dołącza do serwera, Minecraft pyta go, czy chce pobrać resource pack. Po akceptacji widzi wszystkie niestandardowe przedmioty, bloki i modele.

ItemsAdder obsługuje trzy metody hostowania resource packa:

• Wbudowany serwer HTTP - plugin sam wystawia plik na porcie (domyślnie 8163). Najprostsze rozwiązanie na VPS z własnym IP. Wymaga otwarcia portu w firewallu.
• Self-hosted przez FTP/SFTP - przesyłasz wygenerowany pack na własny serwer WWW lub CDN. Więcej kontroli, ale więcej konfiguracji.
• Zewnętrzny hosting - np. GitHub Releases, Dropbox lub dedykowane usługi hostowania resource packów. Przydatne gdy dostawca hostingu blokuje dodatkowe porty.

Kluczowa kwestia: ItemsAdder używa CustomModelData, czyli numeru przypisanego do istniejącego przedmiotu vanilla (np. PAPER o CustomModelData 1001 wyświetla model niestandardowego miecza). To ograniczenie wynika z architektury Minecrafta - do wersji 1.21.3 nie ma oficjalnego API do tworzenia nowych ID przedmiotów. Od wersji 1.21.4 Minecraft dodał obsługę komponentu item_model, z której ItemsAdder już korzysta.

Po każdej zmianie w konfiguracji musisz przebudować resource pack komendą /iazip lub /iareload. Plugin automatycznie kompresuje pliki i aktualizuje URL - gracze przy następnym dołączeniu otrzymają nową wersję.

Tworzenie przedmiotów

Każdy niestandardowy przedmiot definiujesz w pliku YAML wewnątrz folderu plugins/ItemsAdder/contents/. Struktura katalogów jest w pełni dowolna - możesz grupować przedmioty według paczek lub tematów.

Przykładowa definicja niestandardowego miecza:

info:
  namespace: moj_serwer
items:
  miecz_ognia:
    display_name: "Miecz Ognia"
    permission: moj_serwer.miecz_ognia
    resource:
      material: DIAMOND_SWORD
      generate: true
      textures:
        - item/miecz_ognia.png
    durability:
      max_custom_durability: 1024
    attribute_modifiers:
      mainhand:
        attackDamage: 8
    lore:
      - "&7Wykuty w płomieniach Netheru."
    events:
      interact:
        right:
          set_on_fire:
            duration: 5

Pole namespace to unikalny identyfikator Twojej paczki treści - dzięki niemu przedmioty z różnych paczek nie kolidują ze sobą. Pole resource.material wskazuje, który przedmiot vanilla "udaje" Twój model. Tekstury umieszczasz w folderze contents/moj_serwer/textures/item/.

ItemsAdder obsługuje:

• Modele 3D w formacie JSON (zgodne z Blockbench)
• Animowane tekstury (mcmeta)
• Niestandardową trwałość i naprawę
• Efekty cząsteczkowe przy użyciu
• Dźwięki przypisane do akcji
• Zdarzenia (events) - np. podpalenie gracza przy trafieniu, leczenie przy spożyciu
• Integrację z systemem umiejętności (MMOItems, AureliumSkills)

Gotowe paczki przedmiotów możesz pobierać z oficjalnego wiki oraz z serwisu Polymart, gdzie społeczność udostępnia zarówno darmowe, jak i płatne zestawy.

Tworzenie bloków

Tworzenie własnych bloków to jedna z najtrudniejszych technicznie kwestii w modowaniu serwerów Minecraft. ItemsAdder rozwiązuje ten problem sprytnie - wykorzystuje stany notatnika (noteblock states) lub stany mushroomblock jako "pojemniki" dla własnych bloków.

W Minecrafcie noteblock ma 800 unikalnych stanów (kombinacji instrumentu, oktawy i nuty). ItemsAdder rezerwuje te stany dla Twoich bloków - gracz widzi model z resource packa, a silnik serwera widzi noteblock o konkretnym stanie. Dzięki temu bloki zachowują się jak prawdziwe bloki: można je zbierać, stawiać, kopać z odpowiednią szybkością.

Przykładowa definicja bloku:

items:
  rubin_ore:
    display_name: "Ruda Rubinu"
    resource:
      material: PAPER
      generate: false
      model_path: block/rubin_ore
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
          break_particles_material: DIAMOND_ORE
        hardness: 5
        blast_resistance: 6
        drop_exp:
          min: 2
          max: 5

Typ REAL_NOTE oznacza użycie stanu noteblock - blok jest "prawdziwy", ma kolizję, można na nim stać i można go kopać. Alternatywnie dostępne są typy REAL_TRANSPARENT (mushroomblock, obsługuje przeźroczystość) i REAL_WIRE (na bazie trypwire, dla cienkich elementów).

Bloki obsługują też niestandardowe dropy - możesz skonfigurować, że Twoja ruda wypada tylko przy konkretnym poziomie wydobycia lub konkretnym przedmiotem, co świetnie współgra z systemami RPG.

Niestandardowe moby

ItemsAdder umożliwia tworzenie niestandardowych mobów z własnymi modelami 3D i animacjami. Moby definiuje się podobnie jak przedmioty - w plikach YAML z referencją do modelu Blockbench.

Modele mobów dla ItemsAddera tworzy się w formacie Blockbench z wtyczką ItemsAdder. Plugin obsługuje pełny zestaw animacji: chodzenie, bieg, atak, śmierć, jedzenie i własne animacje zdefiniowane przez twórcę.

Największa moc ujawnia się przy integracji z MythicMobs. Możesz przypisać model z ItemsAddera do moba z MythicMobs - otrzymujesz wtedy bestię z unikalnym wyglądem i rozbudowaną logiką AI, fazami walki, specjalnymi atakami i nagrodami. To kombinacja używana na dziesiątkach serwerów RPG.

Przykład konfiguracji niestandardowego moba w ItemsAdder:

info:
  namespace: moj_serwer
entity_models:
  smok_ognia:
    display_name: "Smok Ognia"
    model: entity/smok_ognia
    animations:
      walk:
        speed_multiplier: 1.0
      attack:
        duration: 1.2

Następnie w MythicMobs referencjonujesz ten model przez opcję Options.ItemsAdder: moj_serwer:smok_ognia. Gracz widzi piękny model 3D, a MythicMobs zarządza całą logiką zachowania.

Meble i dekoracje

Jedną z najbardziej docenianych funkcji ItemsAddera jest system mebli. Meble to wieloblokowe struktury dekoracyjne - krzesła, stoły, łóżka, lampy, skrzynie - które możesz umieszczać w świecie gry.

Technicznie meble są zbudowane z niewidzialnych stojaków na zbroję (armor stands) z przypiętymi modelami z resource packa. Dzięki temu mogą mieć niestandardowe wymiary, przekraczać jeden blok i być ustawiane pod różnymi kątami.

ItemsAdder dostarcza kilka zestawów mebli z pudełka, ale prawdziwa wartość to możliwość tworzenia własnych. Z Blockbencha eksportujesz model, konfigurujesz hitboksy i gotowe. Meble obsługują:

• Siadanie (gracze mogą usiąść na krześle lub ławce)
• Kolizję z graczem (blokują ruch)
• Interakcje (otwieranie szafek, aktywowanie mechanizmów)
• Umieszczanie na ścianach i sufitach (np. obrazy, lampy)
• Rotację w 8 lub 16 kierunkach

Plugin FurnitureLib i FurnitureEngine są alternatywami dla systemu mebli, ale ItemsAdder integruje wszystko w jednym ekosystemie, co eliminuje problemy z kompatybilnością między pluginami.

Emocje (emotes)

ItemsAdder obsługuje animowane emocje graczy - pełne animacje postaci widoczne dla innych graczy w czasie rzeczywistym. Gracz może machać ręką, tańczyć, śmiać się lub wykonywać dowolną animację zdefiniowaną przez admina.

Emocje działają poprzez nadpisanie modelu gracza w resource packu i odtwarzanie animacji po stronie klienta. Aby emocja była widoczna dla innych, ItemsAdder używa protokołowych trików z entity metadata.

Przykłady zastosowań emocji:

• Powitania VIP na spawnie (specjalna animacja dla donatorów)
• Animacje klas postaci w grach RPG (czarodziej rzucający zaklęcia)
• Tańce i gesty w strefach socjalnych
• Animacje śmierci zamiast domyślnego upadku postaci

Emocje można przypisywać do rang przez LuckPerms - np. tylko gracze z rangą VIP mają dostęp do rzadkich animacji. To popularny element oferty monetyzacji na serwerach.

GUI i HUD

ItemsAdder zawiera zaawansowany system tworzenia nakładek na interfejs gracza (HUD). Możesz wyświetlać własne paski, ikony, liczniki i informacje bezpośrednio na ekranie gracza - bez żadnych dodatkowych pluginów.

HUD w ItemsAdderze działa przez nadpisanie bossbar lub actionbar z niestandardową czcionką Bitmap Font z resource packa. Efekt: gracz widzi pixel-artową nakładkę na ekranie, która wygląda jak element interfejsu gry.

Typowe zastosowania HUD:

• Pasek many/energii - obok paska życia wyświetla się zasób do czarów
• Licznik walut - saldo lub punkty doświadczenia w rogu ekranu
• Wskaźnik temperatury/głodu/skażenia - dla serwerów survival z mechanikami przetrwania
• Miniatura kompasu - kierunek i współrzędne w górnej części ekranu
• Powiadomienia osiągnięć - animowane bannery przy odblokowaniu

Do tworzenia HUD możesz używać edytora graficznego zintegrowanego z pluginem lub zewnętrznych narzędzi jak HMCCosmetics. ItemsAdder dostarcza też API dla deweloperów, dzięki któremu inne pluginy mogą rejestrować własne elementy HUD.

Cena i licencja

ItemsAdder jest płatnym pluginem premium dostępnym wyłącznie na platformie SpigotMC. Aktualna cena to około 25 EUR za licencję - sprawdź aktualną cenę na stronie SpigotMC, ponieważ może ulec zmianie.

Zakup daje:

• Licencję na jeden serwer (jeden IP lub jedna sieć proxy)
• Dostęp do wszystkich aktualizacji przez czas nieokreślony
• Dostęp do oficjalnego kanału wsparcia na Discordzie
• Dostęp do oficjalnego wiki z dokumentacją

Ważne kwestie licencyjne:

• Każdy serwer wymaga osobnej licencji - jedna licencja nie pokrywa farmy serwerów
• Sieci BungeeCord/Velocity mogą kwalifikować się jako jedna licencja, ale warto to potwierdzić z autorem
• Plugin pobierasz przez panel SpigotMC po zakupie - plik .jar nie jest publicznie dostępny
• Nie ma wersji "trial" - przed zakupem możesz testować jedynie na środowisku lokalnym z kilkoma ograniczeniami

Cena może wydawać się wysoka w porównaniu z darmowymi alternatywami jak Oraxen CE (Community Edition), ale ItemsAdder oferuje znacznie więcej funkcji, lepszą dokumentację i aktywne wsparcie. Dla serwerów z budżetem to solidna inwestycja, która zwraca się szybko przez lepsze doświadczenie graczy.

Porównanie z Oraxen

Głównym konkurentem ItemsAddera jest Oraxen. Przez lata to był wybór "darmowa alternatywa vs płatne premium", ale sytuacja się skomplikowała - Oraxen wprowadził płatny plan premium (Oraxen Pro), podczas gdy ItemsAdder pozostał na stałej cenie.

Kiedy wybrać ItemsAdder: masz budżet, potrzebujesz emocji i rozbudowanego HUD, chcesz natywnej integracji z MythicMobs, zależy Ci na profesjonalnym wsparciu i dużej społeczności zasobów.

Kiedy wybrać Oraxen CE: masz zerowy budżet na pluginy, potrzebujesz tylko niestandardowych przedmiotów i bloków, cenisz open source i możliwość modyfikowania kodu.

Kompatybilność

ItemsAdder jest kompatybilny z:

• Wersje Minecraft: 1.14 - 1.21.x (aktualizowany na bieżąco)
• Silniki serwerów: Paper (zalecany), Spigot, Purpur, Pufferfish
• Sieci: BungeeCord, Velocity (plugin instaluje się na każdym backendzie osobno)
• MythicMobs - natywna integracja modeli i mobów
• MMOItems - własne statystyki przypisane do przedmiotów IA
• AureliumSkills / AuraSkills - system umiejętności z przedmiotami IA
• LuckPerms - uprawnienia do przedmiotów, emocji i rang
• EssentialsX - kity i sklepy z przedmiotami IA
• PlaceholderAPI - własne placeholdery dla HUD i chatów
• WorldGuard - ochrona regionów z uwzględnieniem bloków IA

Znane ograniczenia:

• Nie działa na Bedrock Edition (tylko Java)
• Wymaga akceptacji resource packa przez gracza - gracze z wyłączonym resource packiem widzą tylko przedmioty vanilla
• Duże resource packi mogą spowalniać dołączanie do serwera (czas pobierania)
• Limity stanów noteblock/mushroomblock ograniczają liczbę unikalnych bloków (około 800 noteblock + 54 mushroom)
• Nie jest kompatybilny z innymi pluginami używającymi tych samych stanów noteblock bez dedykowanej integracji

Więcej informacji o pluginach serwerowych znajdziesz w katalogu pluginów. Jeśli budujesz serwer RPG, koniecznie sprawdź też MythicMobs - połączenie obu pluginów daje niesamowite możliwości tworzenia unikalnych bossów i przygód.