NodeBB Integration

Ta wtyczka Bukkit jest aplikacją towarzyszącą dla Minecraft Integration, a NodeBB forum plugin. Ustanawia połączenie WebSocket z forum, które umożliwia komunikację między forum a Twoim serwerem Minecraft. Dzięki temu informacje o Twoim serwerze Minecraft i graczach mogą być wyświetlane na Twoim forum za pomocą widżetów, profili użytkowników, postów, shoutboxów itp. Twoje forum może również wysyłać zdarzenia z powrotem do serwera, takie jak posty, wiadomości, nagrody, grupy. Wtyczka jest wyłącznie klientem WebSocket i udostępnia swój interfejs API wyłącznie wtyczce Minecraft Integration. Klient WebSocket działa asynchronicznie, aby opóźnienia sieciowe nie miały wpływu na normalne procesy serwera. Jeśli Twoje forum używa bezpiecznego połączenia, połączenie tej wtyczki będzie również bezpieczne.

Czym jest NodeBB?

Z dokumentacji NodeBB:

NodeBB to nowoczesna platforma dyskusyjna wykorzystująca web sockets do natychmiastowych interakcji i powiadomień w czasie rzeczywistym. Fora NodeBB mają wiele nowoczesnych funkcji dostępnych od razu, takich jak integracja z sieciami społecznymi i prowadzenie dyskusji na żywo.

Co robi wtyczka NodeBB Integration?

Integracja NodeBB wysyła zdarzenia gniazda do Twojego forum, gdy wystąpi zdarzenie Bukkit. Forum nasłuchuje te zdarzenia i wyświetla odpowiednie informacje użytkownikom forum.

• Wyświetlaj informacje o serwerze, takie jak czas online, wtyczki, mody i gracze online, aktualizowane w czasie rzeczywistym.
• Wyświetlaj rankingi, takie jak najwięcej pieniędzy, czas gry lub umiejętności McMMO na Twoim forum, również aktualizowane w czasie rzeczywistym.
• Synchronizuj chat serwera i shoutboxy na forum.
• Synchronizuj rangi serwera z członkostwem w grupach forum.
• Przydzielaj rangi graczom Minecrafta na podstawie aktywności na forum. (Posty, reputacja, itp.)

Konfiguracja wtyczki

Po umieszczeniu pliku NodeBB Integration jar w folderze z wtyczkami i ponownym uruchomieniu serwera Minecraft, w folderze plugins/NodeBB_Integration zostanie utworzony plik config.yml z następującymi opcjami:

FORUMURL Adres internetowy forum, do którego łącza się wtyczka. np. https://community.example.com/. Można używać kodów kolorów z '&'. FORUMNAME Nazwa Twojego forum, wyświetlana w wiadomościach wysyłanych przez tę wtyczkę. Można używać kodów kolorów z '&'. APIKEY Klucz API Twojego forum z sekcji ustawień serwera Minecraft Integration. SOCKETNAMESPACE Tylko do zaawansowanego użytku. Wartość domyślna to plugins PLUGINID Tylko do zaawansowanego użytku. Wartość domyślna to MinecraftIntegration

FORUMURL i APIKEY są wymagane. Możesz zapisać je w config.yml lub użyć poniższych poleceń. Po edycji konfiguracji użyj polecenia /nodebb reload, aby ponownie połączyć się z forum. Nie wymaga ponownego uruchamiania serwera.

Polecenia

For OPs

Te polecenia są dostępne dla wszystkich OP-ów i graczy posiadających uprawnienie nodebb.admin

/nodebb Wyświetla wszystkie polecenia wtyczki.

/nodebb reload Przeładowuje plik config.yml z dysku i ponownie łączy z forum.

/nodebb key [key] Pobiera lub ustawia klucz API forum i ponownie ładuje.

/nodebb url [url] Pobiera lub ustawia adres URL forum i ponownie ładuje.

/nodebb name [name] Pobiera lub ustawia nazwę forum i ponownie ładuje.

/nodebb debug [toggle] Wyświetla informacje przydatne do naprawiania błędów. Użyj opcji toggle, aby włączyć szczegółowe logowanie.

Dla graczy

Wszyscy gracze mają te polecenia. Nie jest wymagane uprawnienie.

/register [EMAIL] [PASSWORD] Łączy konto forum powiązane z podanym adresem email z UUID gracza, umożliwiając dodatkowe funkcje na Twoim forum.

Konfiguracja Twojego forum NodeBB

Integracja NodeBB została zaprojektowana do użycia z wtyczką NodeBB Minecraft Integration.

Minecraft Integration zapewnia GUI do zarządzania:

• Kontami forum powiązanymi z UUID gracza.
• Powiązaniem awatara użytkownika z jego skórką Minecraft.

jak również dodawanie widżetów do Twojego forum:

• Status serwera (dynamicznie aktualizowany)
• Wykres TPS
• Rankingi graczy (dla czasu gry, pieniędzy lub statystyk McMMO)
• Wykresy graczy (do wyświetlania graczy online lub rankingów graczy w czasie)

Przykładowe widżety

Status serwera

Dynamicznie aktualizuje liczbę graczy, awatary, status online i wtyczki.

Wykres gracza

Dynamicznie aktualizuje.

Rankingi graczy

Dynamicznie aktualizuje statystykę i kolejność graczy.

Zaawansowana konfiguracja

Zaawansowani użytkownicy mogą stworzyć własną wtyczkę NodeBB, aby nasłuchiwać zdarzeń Bukkit przy użyciu modułu socket.io.

Należy zmienić SOCKETNAMESPACE oraz PLUGINID na odpowiednie wartości w pliku config.yml.

var socketPlugins = require('./socket.io/plugins');

socketPlugins.MyPlugin = { eventPlayerJoin: function (socket, data, callback) { // The event is parsed into a plain js object. console.log(data.player.name); } }

Informacje o projekcie

Licencja: CC0 lub MIT License.

Źródło: https://github.com/yariplus/bukkit-plugin-nodebb-integration