InventorySync PRO — Przegląd

Przegląd
Ta dokumentacja opisuje InventorySync PRO 1.7.0: współdzielenie profili, edytory dla administracji, przechowywanie danych i opcjonalny most proxy. Wymagania znajdziesz w sekcji Instalacja.

Jakie dane podążają za graczem

• Ekwipunek – Główna zawartość, pasek szybkiego wyboru, zbroja, przedmiot w drugiej ręce i wybrany slot paska.
  
• Skrzynia Endu – Zawartość korzysta z wybranego profilu, gdy synchronizacja skrzyni Endu jest włączona.
  
• Doświadczenie – Poziom, postęp paska XP i łączna liczba punktów, z opcjonalną synchronizacją i narzędziami administracji.
  

Łącz ekwipunki tam, gdzie ich potrzebujesz

• GLOBAL – Jeden wspólny profil o nazwie global na uczestniczących światach i serwerach.
  
• PER_WORLD – Osobne profile na podstawie nazw światów. Zgodne znormalizowane nazwy światów na połączonych serwerach korzystają z tego samego profilu.
  
• PER_GROUP – Wybierz, które serwery lub światy należą do jednej grupy. Survival-1 i Survival-2 mogą współdzielić przedmioty, a Lobby i SkyBlock zachować osobne dane.
  

Skrzynia Endu i XP mogą korzystać z tych samych grup. Wyłącz wybrany typ danych, jeśli chcesz synchronizować tylko ekwipunki.
Kolejność PER_GROUP: group-by-server → group-by-world → group-default. Przypisanie serwera obejmuje wszystkie jego światy. Pomiń dany backend w mapie serwerów, aby rozdzielić jego światy. Używaj prostych nazw profili małymi literami, np. survival; niedozwolone znaki są normalizowane. Komendy administracji przyjmują bazową nazwę profilu bez wewnętrznych przyrostków skrzyni Endu/XP.

Gracze lokalni, offline i na innych serwerach
Dla gracza online narzędzia administracyjne pobierają aktualne dane z backendu będącego właścicielem aktywnej sesji. Dla gracza offline odczytują dane zapisane w bazie. Bez argumentu profilu operacje offline wybierają ostatnio zapisany profil danego typu danych. Nazwy trafiają do wspólnego katalogu po wejściu gracza; użyj UUID, jeśli nie można znaleźć starszej nazwy offline.
Zdalne operacje i wspólne ekwipunki wymagają MySQL na uczestniczących backendach. Obecne żądania /invsee, /endersee i /xpsee korzystają z bazy i działają bez włączania opcjonalnego mostu proxy. Wyłączenie synchronizacji skrzyni Endu lub XP wyłącza również odpowiadającą im komendę administracji.

Korzystanie z edytorów ekwipunku
Kliknij przedmiot we własnym ekwipunku, aby wybrać jego kopię. Kliknij docelowy slot lewym przyciskiem, aby ją umieścić, lub prawym, aby wyczyścić slot. Edycja ekwipunku obejmuje główną zawartość, pasek, zbroję i drugą rękę oraz zachowuje wybrany slot paska. Są to narzędzia administracyjne, więc kopiowanie przedmiotu nie usuwa go z Twojego ekwipunku.

• Save – Zatwierdza szkic po sprawdzeniu uprawnień i konfliktów.
  
• Refresh – Odrzuca zmiany robocze i pobiera aktualne dane gracza.
  
• Cancel lub zamknięcie – Nie zatwierdza niezapisanych zmian.
  

Otwarte GUI pokazuje migawkę, a nie automatycznie odświeżany podgląd na żywo. Save sprawdza aktualną sesję, profil, uprawnienia i dane źródłowe. Jeśli gracz lub inny administrator zmieni dane, odśwież je i przygotuj edycję ponownie. Po przekroczeniu czasu lub niepewnym zapisie sprawdź aktualne dane przed powtórzeniem działania.

Pierwsze wejście i nowe profile
Jeśli przy wejściu nie ma zapisanego profilu, aktualne dane gracza stają się stanem początkowym. Przy zmianie świata na inny, niezapisany profil poprzedni profil jest zapisywany, a brakujący ekwipunek oraz włączone dane skrzyni Endu i XP zaczynają się od pustego stanu. Przejście między światami przypisanymi do tego samego profilu nie zmienia ekwipunku.

Kontrola zapisów i przejść
Interakcje gracza są chronione podczas ładowania danych i zmiany profilu. W sieci właściciel sesji określa, który backend może zapisywać gracza, a nieaktualne szkice edytora są odrzucane, gdy dane źródłowe uległy zmianie. Te zabezpieczenia ograniczają typowe ryzyko cofania i duplikowania danych; regularne kopie zapasowe nadal są częścią prowadzenia serwera.