ItemsAdder vs Oraxen: jaki plugin custom przedmiotow wybrac w 2026

Custom items i bloki dawno przestaly byc opcja tylko dla duzych sieci RPG. Nawet maly SMP dorzuca dzis wlasne meble, bronie czy dekoracyjne bloki, zeby odroznic sie od setek typowych projektow. Ten poradnik bez ogolnikow porownuje ItemsAdder i Oraxen: co maja wspolnego, gdzie sie roznia, i ktory pasuje do twojego scenariusza.

Po co serwerowi custom items

Vanilla Minecraft daje okolo 1300 przedmiotow. Na survival to wystarcza, ale jak tylko wchodzi RP, ekonomia, questy lub porzadne RPG, vanilla tekstur jest za malo. Gracze widza 50 identycznych zelaznych mieczy i traca zainteresowanie.

Custom items rozwiazuja kilka problemow naraz:

• unikalny lut, ktorego nie da sie zdobyc w vanilli
• dekoracyjne custom blocks na meble, lampy, skrzynie
• custom moby i bronie pod mechaniki RPG
• branding wizualny serwera, ktory zostaje w pamieci

Oba pluginy opieraja sie na tym samym mechanizmie vanilly: CustomModelData w resource packu. Serwer wysyla przedmiot z konkretnym tagiem NBT, klient renderuje inny model z zaladowanego packa. Bez modow klienckich, dziala na zwyklym Vanilla launcherze.

# Uproszczony przeplyw
item:
  material: PAPER
  custom_model_data: 100001
  display_name: "<gold>Stara Mapa"

Pack zawiera assets/myserver/models/item/ancient_map.json zmapowane na custom_model_data: 100001. Klient renderuje to zamiast kartki papieru.

Oba pluginy automatyzuja proces: ty piszesz konfig, plugin buduje koncowy resource pack i podsuwa go graczom.

ItemsAdder: co dostajesz za 25$

ItemsAdder to premium plugin na SpigotMC od autora LoneDev, cena okolo 24,99 EUR za serwer, dozywotnie aktualizacje i support. Cena to glowna bariera dla malych projektow, ale za pieniadze dostajesz duzo.

Co jest w paczce:

• ogromna biblioteka community packow: meble, bronie, zbroja, moby, cale zestawy tematyczne
• automatyczny hosting resource packa przez wbudowany serwer HTTP lub zewnetrzny CDN
• wizualny GUI Builder do menu inwentarzowych bez YAML
• integracja z MythicMobs, ModelEngine, WorldGuard, Vault
• support custom mobow z wlasnymi modelami, AI i animacjami przez ModelEngine
• custom blocks na NoteBlock, StringBlock, Tripwire i Bonemeal-hack dla wiekszej roznorodnosci

W praktyce ItemsAdder jest rozwiazaniem full-stack. Kupujesz raz, dostajesz narzedzia na cala strone contentu serwera. Minusy: pierwsza instalacja odstrasza poczatkujacych, dokumentacja rozproszona, aktualizacje czesto wymagaja recznej regeneracji packa.

# config/items_adder/contents/myserver/configs/items.yml
info:
  namespace: myserver
items:
  golden_sword:
    display_name: "<gold>Miecz Krola"
    permission: myserver.items.golden_sword
    resource:
      material: GOLDEN_SWORD
      generate: true
      textures:
        - item/golden_sword.png
    behaviours:
      basic_durability:
        max_custom_durability: 2500

Po zapisaniu, /iazip buduje pack, plugin wystawia go na wbudowanym HTTP, gracze dostaja URL przy joinie.

Oraxen: alternatywa open-source

Oraxen dlugo byl w pelni open-source, w 2023 rdzen przeszedl do modelu freemium na Polymart (okolo 14,99 EUR). Starsze wersje zostaly open-source, community forki dalej dostaja patche, a filozofia YAML-first nigdy sie nie zmienila.

Mocne strony:

• aktywna spolecznosc z dziesiatkami darmowych packow na GitHubie
• prosta struktura konfigow: jeden YAML na kategorie przedmiotow
• wbudowane glify na czat-emoji przez Unicode
• custom blocks przez NoteBlock i StringBlock
• czysta integracja z MythicMobs, ModelEngine, WorldGuard
• generuje resource pack, ale hosting jest po twojej stronie, np. S3, Cloudflare R2 lub wlasny HTTP

Oraxen ma mniej gotowego contentu, co jest plusem, gdy rysujesz wlasne tekstury. Mniej magii, mniej abstrakcji, konfigi czytelne w piec minut.

# plugins/Oraxen/items/weapons.yml
king_sword:
  displayname: "<gold>Miecz Krola"
  material: GOLDEN_SWORD
  Pack:
    generate_model: true
    textures:
      - default/items/king_sword.png
  Mechanics:
    durability:
      value: 2500

Co maja wspolnego

Modele biznesowe rozne, technicznie blisko siebie:

1. CustomModelData jako mechanizm podmiany modeli.
2. Wsparcie Paper, Purpur, Pufferfish w wersjach 1.19 - 1.21.x. Folia czesciowo, mechaniki bazujace na NoteBlock moga sie wykrzaczyc pod region-threading.
3. Automatyczna generacja modeli JSON z tekstur PNG.
4. Hooki w MythicMobs, ModelEngine, WorldGuard, Vault, PlaceholderAPI.
5. Wlasne Furniture API na stoly, krzesla, lampy jako bloki entity-based.
6. Wsparcie custom zbroi przez trims lub kolorowana hex skorzana zbroja z bindingiem do shadera.

Oba zwracaja dzialajacy resource pack, ktory dostarczasz graczom przez server-resource-pack w server.properties lub bezposrednio przez plugin.

Gdzie sie roznia

Tutaj zaczyna sie konkret. Roznice podzielilem wedlug wplywu na codzienna prace admina.

Custom blocks i Furniture

ItemsAdder posuwa sie dalej: poza klasycznym NoteBlock i StringBlock jest mechanika REAL_NOTE ktora uzywa kazdej nuty na unikalny blok, plus Bonemeal-hack powiekszajacy zakres dostepnych ID. Na serwerze z 500+ custom blockami to ma znaczenie.

Oraxen trzyma sie NoteBlock i StringBlock, co wystarcza dla wiekszosci projektow. Az do 800 unikalnych NoteBlock blockow plus tyle samo na StringBlock. Jesli nie budujesz olbrzymiego RPG z tysiacami blokow, roznicy nie odczujesz.

Hosting resource packa

Najwiekszy praktyczny rozdzwiek. ItemsAdder odpala wbudowany serwer HTTP/HTTPS lub wpycha pack na wlasny CDN. Gracz sie laczy, plugin podaje URL, dziala.

Oraxen buduje koncowy pack w plugins/Oraxen/pack/pack.zip, ale go nie hostuje. Opcje:

• wlasny nginx serwujacy statyczne pliki
• Cloudflare R2 z publicznym bucketem
• darmowy pack-hosting VPS service
• zewnetrzne uslugi typu resource-pack-host.com

Dodatkowe zadanie na liscie instalacji, ale nie dealbreaker.

GUI i menu

ItemsAdder ma wbudowany GUI Builder: menu rysujesz w edytorze tekstur, przyciski bindujesz w YAML, dostajesz w pelni custom interfejs. Wygodne na aukcje, banki, dzienniki questow.

Menu Oraxena robi sie przez plugins firm trzecich, np. DeluxeMenus albo TrMenu. Bardziej elastyczne, ale dodatkowy plugin w stacku.

Dokumentacja i community

ItemsAdder ma oficjalna wiki i duzy Discord. Oraxen jest bardziej zwarty, ale GitHub Issues i Discord aktywne. Z mojego doswiadczenia, Oraxen szybciej odpowiada na nieoczywiste pytania, bo spolecznosc mniejsza i geste.

Wydajnosc i kompatybilnosc

Przy dobrej konfiguracji zaden z pluginow nie powoduje zauwazalnych spadkow TPS. Na serwerze z 200 custom items i 50 custom blockow oba zjadaja okolo 5-10% dodatkowego CPU w peakach. RAM: rzedu +150-300 MB na heap zaleznie od rozmiaru packa.

Co realnie ciagnie performance:

• NoteBlock custom blocks: kazdy uruchamia fizyke nuty przy stawianiu
• furniture entities: duzo mebli = duzo pasywnych entity, trzymaj 10-20 na chunk
• rozmiar resource packa: powyzej 100 MB retencja spada widocznie, gracze rzucaja pobieranie

# Sprawdz odpowiedz packa z serwera
curl --connect-timeout 3 -I https://your-cdn.com/pack.zip
# Cel: Content-Length ponizej 80MB

Folia: w 2026 ItemsAdder ma czesciowe wsparcie, Oraxen tez dziala z zastrzezeniami pod NoteBlock. Jesli stoisz na Folii, testuj na stagingu przed produkcja.

Ceny i licencja

Pole	ItemsAdder	Oraxen
Cena	~$25 jednorazowo	~$15 jednorazowo (Premium)
Wersja darmowa	brak	starsze forki + community fork
Licencja	jeden serwer	jeden serwer
Aktualizacje	dozywotnio	dozywotnio
Support	Discord + wiki	Discord + GitHub

ItemsAdder regularnie spada o 20-30% w promocjach na SpigotMC i Polymart, szczegolnie Black Friday i lato. Cena schodzi do 18-20$. Oraxen Premium trzyma stala cene.

Kiedy co wybrac

Skrocone:

Wez Oraxena, jesli:

• maly serwer RP/SMP, ograniczony budzet
• rysujesz wlasne tekstury i nie potrzebujesz gotowych packow
• czujesz sie z YAML i nie potrzebujesz wizualnego GUI buildera
• gotowy postawic wlasny hosting na pack

Wez ItemsAdder, jesli:

• projekt komercyjny lub mocno content-heavy
• chcesz meble, bronie, moby od reki
• nie masz czasu i chec rysowac wszystkiego sam
• zalezy ci na wbudowanym hostingu packa
• planujesz custom GUI bez plugins firm trzecich

Na wlasnych sieciach Oraxen trzymam na malych SMP, ItemsAdder na wiekszych projektach RPG. Oba dzialaja. Wybor to bardziej strategia contentu i budzet niz wyzszosc techniczna.

Dostarczenie resource packa graczom

Niezaleznie od plugina, cel jest ten sam: pack laduje sie automatycznie przy joinie. Dwa robocze sposoby:

1. Przez server.properties:

resource-pack=https://your-cdn.com/pack.zip
resource-pack-sha1=ABC123DEF456...
require-resource-pack=true
resource-pack-prompt=Zaladuj pack po custom content

2. Bezposrednio przez plugin: ItemsAdder i Oraxen umieja nadpisac server.properties i pchnac URL packa przy joinie. Czysciej, bo hash SHA1 odswieza sie automatycznie przy kazdej regeneracji.

Jesli gracz odrzuci pack, custom items pokaza sie jako material bazowy (papier, lisc, dynia) z poprawna nazwa i loremem, ale bez custom modelu. Serwery RP zwykle wymuszaja pack przez require-resource-pack=true. PvP i survival czesto zostawiaja opcjonalnie.

FAQ

Czy moge uzywac ItemsAdder i Oraxen rownoczesnie

Technicznie tak, w praktyce nie. Oba korzystaja z CustomModelData i koliduja na powtarzajacych sie ID. Jesli koniecznie chcesz, rozdziel namespace i zakresy custom_model_data: ItemsAdder na 100000-199999, Oraxen na 200000-299999. Aktualizacje staja sie koszmarem, na produkcji ten kombi sie sypie.

Czy custom items dzialaja dla graczy Bedrock przez Geyser

Tylko z GeyserMC + Floodgate + Hydraulic lub GeyserOptionalPack. Sam Geyser nie tlumaczy CustomModelData na format Bedrock. Hydraulic konwertuje pack Java na pack Bedrock i serwuje go klientom Bedrock. Dziala, ale nie kazda mechanika przezywa konwersje (meble czesto wygladaja zle).

Co robic, jesli gracz odmawia pobrania resource packa

Dwie opcje. Wymus przez require-resource-pack=true w server.properties: brak packa, brak wejscia. Albo zostaw opcjonalnie, wtedy gracz bez packa widzi vanilla materialy z custom nazwami i lore. RP trzyma sztywno, PvP zwykle opcjonalnie.

Czy mozna kupic ItemsAdder taniej

Na SpigotMC i Polymart sezonowe rabaty 20-30%, glownie Black Friday i lato. Cena spada do 17-19$. Tylko oficjalne platformy. Zadnych null-repo i wersji crackowanych, czesto siedza tam backdoory albo koparki.

Ktory plugin jest lepszy pod Folie 2026

Oraxen jest aktualnie nieco stabilniejszy na Folii dzieki mniejszej liczbie asynchronicznych operacji NoteBlock. ItemsAdder tez dziala, ale wymaga starannych testow. Jesli budujesz Folia-serwer od zera, zacznij od Oraxena.

Ile wazy typowy resource pack

Maly projekt z 50-100 itemami: 5-15 MB. Sredni RP serwer z meblami i zbroja: 30-60 MB. Duzy RPG z tysiacem itemow i custom mobami: 100-300 MB. Powyzej 100 MB rosnie procent graczy rzucajacych pobieranie. Tnij assety albo schodz z rozdzielczoscia tekstur.

Czy oba pluginy wspieraja Minecraft 1.21.4 i nowsze

Oba sa aktywnie aktualizowane. ItemsAdder zwykle goni release Minecrafta 1-2 tygodnie, Oraxen szybciej dzieki mniejszej bazie kodu. Na 1.21.x oba lataja, zawsze sprawdz changelog przed bumpniem wersji serwera.

Co dalej

Jesli dopiero zaczynasz z custom contentem, nie probuj od razu skladac wlasnego packa od zera. Wez Oraxena, sciagnij kilka darmowych packow z GitHuba i pograj z konfigami. Po tygodniu bedziesz wiedzial, ktore limity przeszkadzaja, i wtedy podejmiesz swiadoma decyzje o przejsciu na ItemsAdder.

Rownolegle planuj ochrone. Im bardziej unikalny content, tym wiecej ataki DDoS od zazdrosnych konkurentow. MineGuard filtruje ataki L4/L7 na serwery Minecraft i pilnuje, zeby twoj projekt nie padl tuz po release nowego packa. Przed publicznym launchem custom contentu sprawdz, ze filtracja stoi i kanal zapasowy dziala.

Jeszcze jedno: zawsze trzymaj pack.zip i konfigi YAML w osobnym repo. Odbudowa packa po crashu dysku zajmuje dni.