MCCore

MCCore

MC Core to próba zapewnienia fundamentów dla kilku aspektów tworzenia wtyczek Bukkit, aby pomóc początkującym programistom łatwiej zaczynać, zapewnić ramy dla nowych wtyczek (lub starych, które zdecydują się na konwersję), aby były bardziej kompatybilne, i ogólnie dostarczać wiele narzędzi przyspieszających proces tworzenia. Ta wtyczka działa jako biblioteka dla wielu różnych funkcji, dzięki czemu ludzie nie muszą ponownie kodować tych samych rzeczy, a także umożliwia zrobić coś, czego nie pomyśleli, że jest możliwe. Bez zbędnych ceregieli, oto narzędzia, które MC Core ma do zaoferowania:

Tablica wyników

• Wiele tablic wyników można zarejestrować jednocześnie
• Tablice wyników mogą opcjonalnie przechodzić przez wszystkie zarejestrowane lub być wybierane za pomocą komendy (kontrolowane przez graczy)
• Istnieją nowe typy tablic wyników zapewniające łatwą funkcjonalność:

StatBoard

• Automatycznie aktualizujące się statystyki
• Interfejs z jedną metodą umożliwia przekształcenie danych gracza w coś, co można użyć z tą tablicą wyników!

TextBoard

• Łatwo wyświetlać linie tekstu na tablicy wyników (nie musisz martwić się o ograniczenia długości — będą one automatycznie zawijane)
• Opcja automatycznego dzielenia wiadomości na części



To jest TextBoard w grze z opcją "separateMessages" ustawioną na true. Został on stworzony i wyświetlony w zaledwie 6 liniach kodu (4 z nich to po prostu dodanie tekstu!)

Zarządzanie czatem

• Możliwość posiadania wielu wtyczek zapewniających prefiksy bez konfliktów
• Mogą mieć kolorowe nazwy wyświetlane i wiele prefiksów

Prefiksy wtyczek

• Stosowane tylko w kodzie
• Jeden prefiks na nazwę wtyczki
• Świetny sposób na zastosowanie ważnych prefiksów bez kolizji z innymi wtyczkami

Prefiksy odblokowywane

• Można mieć praktycznie nieograniczoną liczbę
• Gracze mogą wybrać, który z nich ma być wyświetlany i zmieniać go w każdej chwili

Nazwy wyświetlane

• Obsługa kolorów za pomocą znaku ampersand '&'
• Polecenie wymagające uprawnień, abyś kontrolował, kto z niego korzysta

Narzędzia poleceń

• Prosty, elastyczny system konfigurowania poleceń
• Możesz tworzyć dowolną liczbę poziomów poleceń (np. /root, sub1 sub2 sub3 args)
• Polecenia oparte na ConfigurableCommand są automatycznie konfigurowalne dla użytkowników
• Konfiguracja obejmuje włączanie/wyłączanie poleceń, zmianę nazw poleceń oraz opisów
• Polecenia są automatycznie organizowane w strony użycia poleceń
• Przyciski tekstowe do przełączania między stronami są dostępne w wersjach 1.7.9 i nowszych!

Konfiguracja

• Zawiera podstawową implementację z samouczka Bukkit
• Dodano możliwość tworzenia konfiguracji w nowych folderach
• Dodano możliwość dodawania obiektów zapisywalnych do nich dla łatwego zapisywania
• Konfigi uzyskane za pomocą metody MCCore automatycznie zapisują się przy wyłączaniu!

Tłumaczenia nazw

• Konwersje mobów, zaklęć i przedmiotów między nazwami Bukkit i vanilla
• Moby mają możliwość szczegółowych nazw z atrybutami, takimi jak kolor owiec lub zawód wieśniaka!

Manipulacja tekstem

TextFormatter

• Formatuje ciągi znaków do UpperCamelCase, lowerCamelCase, lub Ogólnej Formy Dla Tytułów

TextSizer

• Pomiar długości ciągów znaków dla okna czatu
• Może dodawać odstępy na początku lub na końcu, aby wszystko ładnie wyrównać
• Dokładniejszy niż to, co da się uzyskać ręcznym dodawaniem spacji!

TypeChecker

• Pozwala sprawdzić, czy dany ciąg znaków jest całkowitą liczbą (integer), liczbą zmiennoprzecinkową (double) lub innym typem, zanim spróbujesz ją sparsować.

TextSplitter

• Głównie do użycia z tablicą wyników
• Dzieli wiadomości na 16 znaków na linię

Regiony

Nowością w wersji 1.9 są pomocniki regionów. Obecnie dostępne są 2:

Cuboid

• Pozwala zdefiniować prostopadłościan z wielu opcji
• Łatwo uzyskać zawartość prostopadłościanu, taką jak bloki lub gracze
• Sprawdza, czy określony gracz znajduje się w środku

Sphere

• To samo co Cuboid, ale w postaci sfer

Polecenia

Polecenia tablic wyników

• /board - Wyświetla użycie poleceń tablic wyników
• /board cycle - Włącza cyklowanie tablic wyników
• /board list - Wyświetla listę wszystkich aktywnych tablic wyników
• /board show <boardName> - Przełącza na tablicę o podanej nazwie
• /board stop - Zatrzymuje cyklowanie tablic wyników

Polecenia czatu

• /chat list - Wyświetla listę odblokowanych prefiksów
• /chat name <displayName> - Ustawia nazwę wyświetlaną (kolory za pomocą '&' są obsługiwane)
• /chat prefix <prefixName> - Ustawia prefiks jako wyświetlany
• /chat reset - Resetuje nazwę wyświetlaną

Uprawnienia

• core.* - wszystkie uprawnienia
• core.board - wszystkie uprawnienia dla tablic wyników
• core.board.cycle - polecenie cyklu tablicy wyników (domyślne true)
• core.board.list - polecenie listy tablic wyników (domyślne true)
• core.board.show - polecenie wyświetlania tablicy (domyślne true)
• core.board.stop - polecenie zatrzymania cyklu tablic wyników (domyślne true)
• core.chat - wszystkie uprawnienia dla czatu
• core.chat.list - polecenie listy czatu (domyślne true)
• core.chat.name - polecenie nazwy czatu (domyślnie op)
• core.chat.prefix - polecenie prefiksu czatu (domyślnie true)
• core.chat.reset - polecenie resetu czatu (domyślnie op)

O projekcie

Chciałem stworzyć centralny zestaw narzędzi, na którym mógłbym oprzeć pracę, aby ułatwić tworzenie. Zdecydowałem się również podzielić tym z wszystkimi, aby być może wtyczki były nieco bardziej kompatybilne i pomóc innym deweloperom tworzyć rzeczy znacznie łatwiej. Mam zamiar dodać dużo do tego (zanim zapytasz, tak, będę dodawał uprawnienia do różnych rzeczy), więc śmiało dawaj sugestie w miarę postępu!

* Podczas moich starań o jak najlepsze przetestowanie błędów, nie mogę ich znać wszystkich, zwłaszcza gdy muszę testować sam i tworzyć rzeczy dla wielu osób. Proszę poinformuj mnie o wszelkich błędach, które znajdziesz, i z góry przepraszam za nie. (W rzeczywistości wydaje mi się, że zaczynam już źle >_<)

Javadocs, kod źródłowy i samouczki

Kod źródłowy

• Kod źródłowy GitHub

JavaDocs

• Dokumentacja Javadoc online

Samouczki

• Samouczek czatu
• Samouczek poleceń
• Samouczek tablic wyników
• Samouczek konwersji nazw
• Samouczek konfiguracji

Like the Project?

Wesprzyj!