Eco - framework ekosystemu pluginów

Co to jest Eco

Eco to nie pojedynczy plugin, lecz framework - baza, na której działają wszystkie pluginy z ekosystemu Eco autorstwa Auxilor. Sam Eco nie dodaje bezpośredniej funkcjonalności dla graczy, ale dostarcza silnik efektów (libreforge), system konfiguracji i API, z których korzystają pluginy potomne.

Filozofia Eco opiera się na konfigurowalności: zamiast hardkodowanych efektów, każdy enchant, boss, umiejętność czy przedmiot składa się z warunków (conditions), efektów (effects) i wyzwalaczy (triggers), które admin konfiguruje w plikach YAML. To pozwala tworzyć praktycznie dowolne mechaniki bez programowania.

Eco jest darmowy i open-source, dostępny na Modrinth i GitHub.

Ekosystem pluginów Eco

Eco jest wymagany przez każdy z poniższych pluginów. Wszystkie dzielą ten sam system efektów i konfiguracji:

Nie musisz instalować wszystkich pluginów - wybierasz tylko te, które potrzebujesz. Ale wszystkie wymagają Eco jako bazy i dzielą ze sobą efekty. Na przykład enchant z EcoEnchants może dawać punkty umiejętności z EcoSkills.

Libreforge - silnik efektów

Sercem Eco jest libreforge - system deklaratywnego definiowania efektów. Każdy element gry (enchant, boss atak, umiejętność) składa się z trzech warstw:

• Triggers (wyzwalacze) - kiedy efekt się aktywuje: przy trafieniu, kopaniu, zabiciu, skoku, jedzeniu itp.
• Conditions (warunki) - dodatkowe warunki: biom, pora dnia, HP gracza, typ bloku, pogoda
• Effects (efekty) - co się dzieje: obrażenia, leczenie, teleportacja, cząsteczki, dźwięki, komendy

Przykład konfiguracji efektu:

effects:
  - id: damage_multiplier
    args:
      multiplier: 1.5
    triggers:
      - melee_attack
    conditions:
      - id: below_health_percent
        args:
          percent: 30
    filters:
      - id: is_entity_type
        args:
          types:
            - ZOMBIE
            - SKELETON

Ten efekt zwiększa obrażenia o 50% przy ataku wręcz, ale tylko gdy gracz ma poniżej 30% HP i atakuje zombie lub szkieleta. Taki poziom szczegółowości jest dostępny w każdym pluginie ekosystemu.

Instalacja

1. Pobierz Eco z Modrinth
2. Umieść eco.jar w folderze plugins/
3. Uruchom serwer - Eco wygeneruje konfigurację
4. Pobierz wybrane pluginy ekosystemu (EcoEnchants, EcoBosses itd.) i umieść w plugins/
5. Uruchom ponownie serwer

Wymagania: Paper lub Purpur 1.20.2+, Java 17+. Eco nie działa na Spigot - wymaga Paper API. Niektóre pluginy ekosystemu wymagają dodatkowych zależności (np. WorldGuard dla regionów bossów).

Po instalacji komenda /eco wyświetla status frameworka i zainstalowanych pluginów. Komenda /eco reload przeładowuje wszystkie konfiguracje bez restartu serwera.

Konfiguracja

Globalna konfiguracja Eco w plugins/eco/config.yml:

# Globalne ustawienia
update-checker: true
mysql:
  enabled: false    # SQLite domyślnie, MySQL opcjonalnie
  host: localhost
  port: 3306
  database: eco

# Wygląd GUI
gui:
  rows: 6
  filler-item: BLACK_STAINED_GLASS_PANE

# PlaceholderAPI
placeholders:
  enabled: true

Eco obsługuje zarówno SQLite (domyślnie) jak i MySQL/MariaDB do przechowywania danych graczy. Na serwerach z wieloma graczami (50+) zalecane jest MySQL.

Każdy plugin ekosystemu ma własny folder konfiguracyjny z plikami YAML. System hot-reload (/eco reload) pozwala edytować konfigurację na żywo bez restartu serwera.

Porady i filozofia

• Zacznij od Eco + 1-2 pluginy - nie instaluj wszystkiego na raz. Zacznij od EcoEnchants lub EcoSkills, poznaj system libreforge, potem dodawaj kolejne
• Czytaj dokumentację - plugins.auxilor.io ma doskonałą dokumentację każdego pluginu i systemu efektów
• Niestandardowe efekty - możesz tworzyć własne enchanty, bossy i umiejętności od zera w YAMLu. Nie jesteś ograniczony do gotowych konfiguracji
• Spójność ekosystemu - pluginy Eco współpracują ze sobą natywnie. Boss z EcoBosses może dropować przedmioty z EcoItems z enchantami z EcoEnchants
• Wydajność - libreforge jest zoptymalizowany pod wydajność. Ewaluacja warunków jest cache-owana, a efekty przetwarzane asynchronicznie gdzie to możliwe

Ekosystem Eco to jeden z najlepszych darmowych frameworków dla serwerów Minecraft. Konkuruje z płatnymi rozwiązaniami jak AdvancedEnchantments i oferuje znacznie większą elastyczność konfiguracji.