Curios API (Forge)

Przegląd

Curios to elastyczne i rozszerzalne API do akcesoriów/wyposażenia, przeznaczone zarówno dla użytkowników, jak i twórców modyfikacji. Jego celem jest dostarczenie programistom funkcji umożliwiających dodawanie dodatkowych slotów na akcesoria/wyposażenie w wygodny i kompatybilny sposób, a także danie graczom możliwości konfiguracji tych slotów według własnych preferencji. Domyślnie Curios nie dodaje żadnej zawartości poza interfejsem ekwipunku. Nie ma żadnych slotów, a jedynie dwa przedmioty – oba dostępne wyłącznie w menu kreatywnym i służące głównie jako przykłady dla programistów podczas tworzenia własnej integracji.

Funkcje

• Rozszerzalne sloty wyposażenia dzięki centralnej bibliotece. Nowe sloty na wyposażenie można łatwo tworzyć i zarządzać nimi za pomocą rejestru identyfikatorów. Identyczne identyfikatory są łączone, aby uniknąć funkcjonalnych redundancji i zapewnić maksymalną kompatybilność z potencjalnymi przedmiotami, podczas gdy unikalne identyfikatory mogą być nadal używane do oznaczania specjalnych typów w razie potrzeby.
• Sloty są tworzone tylko na żądanie. Domyślnie nie ma żadnych slotów – wszystkie są tworzone wyłącznie wtedy, gdy są potrzebne. Zmniejsza to liczbę przypadków, w których jeden lub więcej zbędnych slotów jest obecnych bez odpowiednich przedmiotów do włożenia.
• Sloty są w pełni konfigurowalne i modyfikowalne. Sloty mogą mieć niestandardowe tła, różne rozmiary, a nawet mogą być domyślnie wyłączone lub ukryte. Jak gracz może uzyskać dostęp do wyłączonych slotów? Dzięki API programiści mogą używać funkcji do włączania/wyłączania slotów gracza lub dodawania/usuwania określonej liczby slotów danego typu.
• Elastyczne relacje przedmiotów z Curios za pomocą waniliowego systemu tagów. Potencjalne curiosa są wybierane za pomocą waniliowego systemu tagów, co oznacza, że kategoryzowanie przedmiotów na typy Curios jest tak proste, jak stworzenie pliku .json w folderze data/curios/tags. Przedmioty można kategoryzować na dowolną liczbę typów Curios, o ile są otagowane w odpowiednich plikach, a te ustawienia można nawet całkowicie nadpisać. Więcej informacji znajdziesz w waniliowym systemie tagów.
• Pełna integracja z innymi mechanikami ekwipunku. Naprawa i Klątwy będą działać ze wszystkimi odpowiednimi przedmiotami wyposażonymi w sloty Curios. Dostępne są również różne mniejsze funkcje dla programistów, które ułatwiają integrację ich obecnych przedmiotów lub mechanik z systemem Curios.
• Dostępne z jednego interfejsu. Curios posiada własny interfejs dostępny z poziomu ekwipunku, który wyświetla wszystkie dostępne dla gracza sloty. Pozwala to graczom zobaczyć wszystkie rozszerzone sloty wyposażenia w jednym miejscu, bez konieczności wchodzenia do różnych interfejsów ekwipunku. Programiści mogą jednak nadal zapewnić własne interfejsy dla slotów specyficznych dla ich modyfikacji, jeśli chcą. Domyślnym klawiszem do otwierania interfejsu jest 'g'.

Dokumentacja

• Konfiguracja środowiska programistycznego
• Sloty
• Przykładowy datapack
• Konfiguracja slotów
• Komendy
• Starsza dokumentacja dla wersji 1.19.x i starszych