Co to jest EcoItems

EcoItems to plugin z ekosystemu Eco, który pozwala tworzyć niestandardowe przedmioty z unikalnymi zdolnościami. W odróżnieniu od Oraxen (który skupia się na niestandardowych modelach 3D i resource packach), EcoItems koncentruje się na mechanice - przedmioty mają efekty, warunki i wyzwalacze z systemu libreforge.

Każdy przedmiot to vanillowy item Minecraft z niestandardowym display name, lore, atrybutami i efektami. Nie wymaga resource packa ani modów po stronie klienta - gracze widzą standardowe tekstury z kolorową nazwą i opisem zdolności.

EcoItems jest darmowy i dostępny na Modrinth. Wymaga Eco jako zależności.

Tworzenie przedmiotów

Przedmioty definiujesz w plikach YAML w plugins/EcoItems/items/:

# infernal_blade.yml
display-name: "&c&lPiekielny Miecz"
material: NETHERITE_SWORD
lore:
  - "&7Wykuty w ogniu Netheru"
  - ""
  - "&cEfekt: &7Podpala cel na &c3s&7 przy trafieniu"
  - "&cEfekt: &7+20% obrażeń przeciw Netherowcom"
  - ""
  - "&e&oLegendarny przedmiot"
item-flags:
  - HIDE_ATTRIBUTES
attributes:
  attack-damage: 12
  attack-speed: 1.6
effects:
  - id: potion_effect
    args:
      effect: FIRE
      duration: 60
      apply-to-victim: true
    triggers:
      - melee_attack
  - id: damage_multiplier
    args:
      multiplier: 1.2
    triggers:
      - melee_attack
    conditions:
      - id: is_entity_type
        args:
          types:
            - BLAZE
            - GHAST
            - WITHER_SKELETON
            - PIGLIN_BRUTE

Kluczowe elementy przedmiotu:

material - bazowy przedmiot Minecraft
attributes - statystyki (obrażenia, szybkość ataku, zbroja)
effects - efekty libreforge (podpalanie, leczenie, teleportacja itp.)
lore - opis wyświetlany na przedmiocie

Dawanie przedmiotów: /ecoitems give [gracz] infernal_blade. Przedmioty można też dodawać do dropów z EcoBosses, skrzynek (EcoCrates) czy sklepów serwerowych.

Zestawy zbroi

EcoItems obsługuje zestawy zbroi (armor sets) z bonusami za noszenie pełnego kompletu:

# dragon_set.yml
type: set
display-name: "&5Smoczy Zestaw"
items:
  helmet:
    material: NETHERITE_HELMET
    display-name: "&5Smoczy Hełm"
    attributes:
      armor: 4
      armor-toughness: 3
  chestplate:
    material: NETHERITE_CHESTPLATE
    display-name: "&5Smoczy Napierśnik"
    attributes:
      armor: 9
      armor-toughness: 3
  leggings:
    material: NETHERITE_LEGGINGS
    display-name: "&5Smocze Spodnie"
    attributes:
      armor: 7
      armor-toughness: 3
  boots:
    material: NETHERITE_BOOTS
    display-name: "&5Smocze Buty"
    attributes:
      armor: 4
      armor-toughness: 3
set-bonus:
  effects:
    - id: damage_multiplier
      args:
        multiplier: 1.15
      triggers:
        - melee_attack
    - id: damage_reduction
      args:
        multiplier: 0.85
      triggers:
        - take_damage
  lore:
    - "&5Bonus zestawu: &7+15% obrażeń, -15% otrzymywanych obrażeń"

Gracz musi nosić wszystkie 4 elementy, żeby aktywować bonus zestawu. Bonus wyświetla się w lore każdego elementu, informując gracza o korzyściach z pełnego kompletu.

Zestawy zbroi to doskonały end-game content - gracz zbiera elementy z różnych bossów lub craftuje je z rzadkich surowców. Pełny zestaw daje potężne bonusy, motywując do zdobycia wszystkich elementów.

Receptury craftingu

EcoItems pozwala definiować niestandardowe receptury dla każdego przedmiotu:

# W pliku przedmiotu
recipe:
  type: shaped
  recipe:
    - "NNN"
    - "NSN"
    - " S "
  key:
    N: NETHERITE_INGOT
    S: STICK

Obsługiwane typy receptur:

shaped - receptura z kształtem (układ w craftingu ma znaczenie)
shapeless - receptura bez kształtu (kolejność nie ma znaczenia)
furnace - wypalanie w piecu
smithing - stół kowalski (1.20+)

Receptury mogą zawierać inne przedmioty EcoItems jako składniki - na przykład Smoczy Napierśnik wymaga 4x Smocza Łuska (inny niestandardowy przedmiot). To tworzy łańcuch craftingu i dodaje głębię progresji.

Receptury pojawiają się w vanillowej książce receptur Minecraft, więc gracze mogą je przeglądać normalnie.

Konfiguracja

Globalna konfiguracja w plugins/EcoItems/config.yml:

# config.yml
crafting:
  enabled: true
  show-in-recipe-book: true

gui:
  enabled: true
  title: "&8Niestandardowe przedmioty"
  command: "/ecoitems browse"

stats:
  show-in-lore: true    # wyświetlaj bonusy statystyk w lore
  stat-format: "&7%stat%: &a+%value%"

Integracja ze statystykami EcoSkills:

# W pliku przedmiotu
stats:
  strength: 5      # +5 Strength gdy trzymany
  crit-chance: 3   # +3% Crit Chance

Statystyki z przedmiotów sumują się ze statystykami z umiejętności, enchantów i innych źródeł. To tworzy bogaty system buildowania postaci.

Porady dla adminów

Tier-uj przedmioty - twórz hierarchię: zwykłe (Common) -> rzadkie (Rare) -> epickie (Epic) -> legendarne (Legendary). Każdy tier powinien być wyraźnie silniejszy
Źródła zdobywania - Common z craftingu, Rare z bossów (EcoBosses), Epic z eventów, Legendary z najtrudniejszych bossów
Nie zastępuj vanilli - niestandardowe przedmioty powinny uzupełniać vanillową progresję, nie zastępować ją. Smoczy Miecz powinien być lepszy od netherite, ale wymagać netherite jako składnika
Zestawy jako end-game - pełny zestaw zbroi to cel na tygodnie gry. Nie rozdawaj elementów za łatwo
Lore informuje - opisuj efekty przedmiotu w lore. Gracz powinien wiedzieć, co przedmiot robi, bez czytania wiki
Łącz z EcoEnchants - niestandardowe przedmioty mogą mieć wstępne enchanty, tworząc unikalne kombinacje

Alternatywy: Oraxen (niestandardowe modele 3D, resource pack), Nova (framework z maszynami i GUI), ItemsAdder (płatny, wszechstronny). EcoItems wyróżnia się integracją z ekosystemem Eco i systemem efektów libreforge.