MC TimeManager

Wtyczka Spigot do zarządzania czasem i wyświetlaniem

FUNKCJONALNOŚCI ZARZĄDZANIA CZASEM

Zdefiniuj czas rozpoczęcia i współczynnik prędkości dla każdego świata. Ustaw odpowiedni interwał odświeżania dla wydajności serwera.

Prędkość może być zwiększana lub zmniejszana aż do 20 razy lub dopasować czas UTC z offsetem do czasu lokalnego.

Dzień i noc mogą mieć różne wartości prędkości, co może być przydatne w RPG-ach lub niektórych mini-grach.

Lista światów jest aktualizowana, a timery synchronizowane przy każdym uruchomieniu serwera i ponownym przeładowaniu.

Czas i prędkość mogą być modyfikowane lub synchronizowane za pomocą komend w grze lub ponownym ładowaniem po ręcznych zmianach.

Dla każdego gracza można zdefiniować konkretny offset czasu.

TimeManager może planować uruchamianie poleceń o czasie określonym w pliku cmds.yml. Zaplanowane polecenia mogą korzystać z opisanych poniżej placeholderów, z wyjątkiem {tm_player}.

Ta wtyczka nadpisuje standardowe polecenie '/time'. Polecenie zmiany czasu dla pojedynczego świata to '/tm set time [ticks|daypart|HH:mm:ss] [world]'.

FUNKCJONALNOŚCI ZARZĄDZANIA SNU

TimeManager umożliwia zarządzanie snem: wymagana liczba graczy, animacja podczas pominięcia nocy, synchronizacja między światami podczas budzenia itp.

Sen może być dozwolony, zabroniony lub powiązany z innymi światami.

Możliwe jest również użycie indywidualnych uprawnień.

KOMENDA GRACZA /now  <display> <world>

Jedno polecenie służy do wyświetlania niestandardowej wiadomości z czasem, datą, liczbą upływających dni lub tygodni oraz wieloma innymi placeholderami.

Wiadomości /now obsługują wiele języków i mogą być automatycznie dopasowywane do lokalizacji gracza, dostępnej w pliku lang.yml.

Dzięki uprawnieniom możesz zezwolić graczom na wybór wyświetlania i/lub argumentu świata, lub na żaden z nich.

Argument wyświetlania może mieć wartości: 'msg', 'title' lub 'actionbar'.

Światy Nether i End mogą mieć określoną wiadomość.

W plikach YAML można używać kolorów szesnastkowych.

PLACEHOLDERy

Dostępne placeholdery to następujące:

• {tm_player} : Wyświetla nazwę gracza.
• {tm_world} : Wyświetla nazwę świata.
• {tm_tick} : Wyświetla aktualny tick.
• {tm_time12} : Wyświetla bieżący czas w formacie hh:mm:ss. (1 → 12)
• {tm_time24} : Wyświetla bieżący czas w formacie HH:mm:ss. (0 → 23)
• {tm_hours12} : Wyświetla bieżącą godzinę w dwóch cyfrach. (1 → 12)
• {tm_hours24} : Wyświetla bieżącą godzinę w dwóch cyfrach. (0 → 23)
• {tm_minutes} : Wyświetla bieżącą wartość minut w dwóch cyfrach.
• {tm_seconds} : Wyświetla bieżącą wartość sekund w dwóch cyfrach.
• {tm_ampm} : Wyświetla bieżącą część dnia AM lub PM.
• {tm_daypart} : Wyświetla nazwę bieżącej części dnia, spośród czterech istniejących, dla każdego języka.
• {tm_currentday} : Wyświetla numer bieżącego dnia. (1 → ∞)
• {tm_elapseddays} : Wyświetla liczbę upływających dni. (0 → ∞)
• {tm_dayname} : Wyświetla nazwę bieżącego dnia, na podstawie wpisów w pliku lang.yml.
• {tm_yearday} : Wyświetla numer dnia w roku. (1 → 365)
• {tm_yearweek} : Wyświetla numer tygodnia w roku. (1 → 52)
• {tm_week} : Wyświetla liczbę upływających tygodni. (1 → ∞)
• {tm_monthname} : Wyświetla nazwę bieżącego miesiąca, na podstawie wpisów w pliku lang.yml.
• {tm_dd} : Wyświetla dzień miesiąca w dwóch cyfrach.
• {tm_mm} : Wyświetla miesiąc w dwóch cyfrach.
• {tm_yy} : Wyświetla rok w dwóch cyfrach.
• {tm_yyyy} : Wyświetla rok w czterech cyfrach.

Należy pamiętać, że te placeholdery rozróżniają wielkość liter.

Mogą być używane w plikach lang.yml i cmds.yml, a także na znakach, w książkach, wiadomościach czatu i poleceniach.

Zależności

TimeManager może wyświetlać swoje placeholdery za pomocą PlaceholderAPI i MVdWPlaceholderAPI. Wystarczy umieścić API w folderze wtyczek i ustawić odpowiedni węzeł na 'true' w pliku config.yml TimeManager.

KOMENDA ADMINA /tm

/tm checkConfig Administracja i konsola mogą wyświetlić podsumowanie plików config.yml i lang.yml.

/tm checkSql Sprawdź dostępność serwera MySQL zgodnie z wartościami podanymi w pliku config.yml. Sprawdza jedynie adres IP i otwarcie odpowiedniego portu.

/tm checkTime [all|server|world] Administracja i konsola mogą wyświetlić komunikat debug/zarządzania, który pokazuje czas uruchomienia serwera, bieżący czas serwera i aktualny czas, czas startu i prędkość dla konkretnego świata (lub dla wszystkich).

/tm checkUpdate [bukkit|spigot|github] Sprawdź, czy na wybranym serwerze dostępna jest nowsza wersja wtyczki. (tylko MC 1.8.8+)

/tm help [cmd] [<subCmd>] Pomoc zapewnia prawidłowe użycie oraz krótki opis wybranego polecenia i podpolecenia.

/tm now [msg|title|actionbar] [player|all|world] Wyślij wiadomość '/now' (na czacie, tytule lub pasku akcji) do wybranego gracza, wszystkich graczy w wybranym świecie lub wszystkich online.

/tm reload [all|config|lang|cmds] Ta komenda pozwala na ponowne wczytanie danych z plików YAML po ręcznych modyfikacjach. Wszystkie timery zostaną natychmiast ponownie zsynchronizowane.

/tm resync [all|world] Ta komenda ponownie zsynchronizuje timery jednego świata lub wszystkich światów, w oparciu o czas uruchomienia serwera, upływ czasu i aktualny współczynnik prędkości.

/tm set date [today|yyyy-mm-dd] [all|world] Ustawia bieżącą datę dla wskazanego świata (lub wszystkich). Może to być dziś lub dowolna data w formacie yyyy-mm-dd. Długość miesięcy odpowiada rzeczywistości, z wyjątkiem lutego, który zawsze ma 28 dni. Rok zatem ma 365 dni.

/tm set debugMode [true|false] Ustaw true, aby włączyć kolorowe, szczegółowe komunikaty w konsoli. Przydatne do zrozumienia niektórych mechanizmów tej wtyczki.

/tm set defLang [lg_LG] Wybierz tłumaczenie do użycia, jeśli locale gracza nie istnieje w lang.yml lub gdy 'useMultiLang' jest wyłączone.

/tm set duration [00d-00h-00m-00s] [all|world] Ustawia prędkość świata na podstawie żądanego czasu trwania, zamiast mnożnika prędkości.

/tm set durationDay [00d-00h-00m-00s] [all|world] & /tm set durationNight [00d-00h-00m-00s] [all|world] Długość dnia i nocy może być definiowana oddzielnie.

/tm set elapsedDays [0 → ∞] [all|world] Ustawia aktualną liczbę upływających dni dla wskazanego świata (lub wszystkich). Może to być liczba całkowita od 0 do nieskończoności (lub prawie). Ustawienie na 0 spowoduje, że świat wróci do dnia pierwszego.

/tm set firstStartTime [default|previous|start] [all|world] Wymusza moment rozpoczęcia świata podczas uruchamiania serwera. Wartość 'default' umożliwia standardową ponowną synchronizację przy starcie. Wartość 'start' powoduje uruchomienie świata w czasie określonym w węźle 'start' świata. Wartość 'previous' zwraca czas w świecie sprzed zamknięcia serwera.

/tm set initialTick [ticks|HH:mm:ss] Zmienia początkowy tick serwera.

/tm set multiLang [true|false] Ustaw true lub false, aby użyć automatycznego tłumaczenia dla polecenia /now.

/tm set playerOffset [-23999 → 23999] [all|player] Zdefiniuj konkretny offset względem czasu świata na kliencie gracza (prędkość świata nadal będzie aktywna). Ustaw '0', aby anulować.

/tm set playerTime [ticks|daypart|HH:mm:ss|reset] [all|player] Zdefiniuj konkretny czas na kliencie gracza (prędkość świata nadal będzie aktywna). Użyj argumentu 'reset', aby anulować.

/tm set refreshRate [ticks] Ustaw opóźnienie (w tickach) przed faktywnym zastosowaniem efektu rozciągania/przyspieszania prędkości. Musi być całkowitą liczbą między 2 a 20. Domyślna wartość to 10 ticków; pamiętaj, że zbyt mała wartość może powodować lagi serwera.

/tm set sleep [true|false|linked] [all|world] Zdefiniuj, czy gracze mogą spać do następnego dnia w wybranym świecie (lub we wszystkich). Domyślnie wszystkie świata zaczynają z parametrem true, chyba że ich licznik czasu działa w czasie rzeczywistym, co wymaga ustawienia na false. Jeśli chcesz umożliwić sen i utrzymanie tego samego czasu w wielu światach, możesz użyć funkcji 'linked', która pozwala grupie światów spędzić noc razem.

/tm set speed [0.0 → 10.0] [all|world] Liczba dziesiętna będzie mnożyć prędkość świata. Użyj 0.0, aby zamarzać czas, wartości od 0.1 do 0.9, aby spowolnić czas, 1.0, aby uzyskać normalną prędkość, a wartości od 1.1 do 10.0, aby przyspieszyć czas. Ustaw tę wartość na 24.0 lub 'realtime', aby czas świata dopasował się do rzeczywistego czasu.

/tm set speedDay [0.0 → 10.0] [all|world] & /tm set speedNight [0.0 → 10.0] [all|world] Od 0.0 do 10.0 wartości daySpeed i nightSpeed mogą się różnić.

/tm set start [ticks|daypart|HH:mm:ss|timeShift] [all|world] Zdefiniuj czas przy uruchomieniu serwera dla wybranego świata (lub wszystkich). Domyślnie wszystkie światy zaczynają od tick #0. Liczniki zostaną natychmiast ponownie zsynchronizowane. Jeśli świat używa prędkości czasu rzeczywistego, wartość start określi przesunięcie czasu UTC, a wartości takie jak +1 lub -1 będą akceptowane.

/tm set sync [true|false] [all|world] Zdefiniuj, czy metoda zniekształcania prędkości będzie zwiększać/zmniejszać rzeczywisty tick świata, czy dopasowywać teoretyczny tick do serwera. Domyślnie wszystkie światy zaczynają z parametrem false. Światy oparte na czasie rzeczywistym i zamrożone nie używają tej opcji; z drugiej strony dotyczy to także światów o normalnej prędkości.

/tm set time [ticks|daypart|HH:mm:ss] [all|world] Ustaw bieżący czas dla wskazanego świata (lub dla wszystkich). Rozważ użycie tego zamiast zwykłego polecenia '/time'. Autouzupełnianie również oferuje praktyczne presety takie jak "day", "noon", "night", "midnight" itp.

/tm set update [none|bukkit|spigot|github] Zdefiniuj źródłowy serwer do wyszukiwania aktualizacji. (tylko MC 1.8.8+)

/tm set useCmds [true|false] Ustaw true, aby włączyć niestandardowy harmonogram poleceń. Zobacz plik cmds.yml po szczegóły.

KRÓTKA LISTA KOMEND I ARGUMENTÓW

• Dla graczy:
  • /now <msg|title|actionbar> <world>
• Dla adminów:
  • /tm checkConfig
  • /tm checkSql
  • /tm checkTime [all|world]
  • /tm checkUpdate [bukkit|spigot|github]
  • /tm help [cmd] [<subCmd>]
  • /tm now [msg|title|actionbar] [player|all|world]
  • /tm reload [all|config|lang|cmds]
  • /tm resync [all|world]
  • /tm set date [today|yyyy-mm-dd] [all|world]
  • /tm set debugMode [true|false]
  • /tm set defLang [lg_LG]
  • /tm set duration [00d-00h-00m-00s] [all|world]
  • /tm set durationDay [00d-00h-00m-00s] [all|world]
  • /tm set durationNight [00d-00h-00m-00s] [all|world]
  • /tm set elapsedDays [0 → ∞] [all|world]
  • /tm set firstStartTime [default|previous|start] [all|world]
  • /tm set initialTick [ticks|HH:mm:ss]
  • /tm set multiLang [lg_LG]
  • /tm set playerOffset [-23999 → 23999] [all|player]
  • /tm set playerTime [ticks|daypart|HH:mm:ss|reset] [all|player]
  • /tm set refreshRate [ticks]
  • /tm set sleep [true|false] [all|world]
  • /tm set speed [0.0 → 10.0] [all|world]
  • /tm set speedDay [0.0 → 10.0] [all|world]
  • /tm set speedNight [0.0 → 10.0] [all|world]
  • /tm set start [ticks|daypart|HH:mm:ss] [all|world]
  • /tm set sync [true|false] [all|world]
  • /tm set time [ticks|daypart|HH:mm:ss] [all|world]
  • /tm set update [none|bukkit|spigot|github]
  • /tm set useCmds [true|false]

NODY UPRAWNIEŃ

• timemanager.*
  • timemanager.admin
  • timemanager.now.*
    • timemanager.now.cmd
    • timemanager.now.display
    • timemanager.now.world
  • timemanager.placeholders
  • timemanager.sleep.*
    • timemanager.sleep.allowed
    • timemanager.sleep.counted

PLIKI YAML

• Pełne opisy znajdują się w odpowiednich nagłówkach plików.

config.yml

Plik ten zawiera przede wszystkim informacje dotyczące każdego świata, a także ogólne opcje, takie jak referencyjny tick, użycie bazy SQL, aktywacja placeholderów itp.

lang.yml

Ten plik zawiera różne tłumaczenia. Możliwe jest ich modyfikowanie i dodawanie nowych języków. Możliwe jest również włączenie automatycznego tłumaczenia w zależności od locale gracza.

cmds.yml

Ten plik pozwala na planowanie wykonywania poleceń o określonych godzinach i datach, z możliwością ich powtarzania zgodnie z wybranym cyklem. Czas i data odniesienia mogą być odpowiadać dowolnemu światu, lub aktualnemu czasowi.

PORADNIKI

KOMPATYBILNOŚĆ

• v1.10.2: MC 1.9.4 do 1.21.4

Chociaż wtyczka nie ma być API, możliwe jest użycie różnych placeholderów poprzez zaimportowanie klasy PlaceholdersHandler w kodzie Java :

import net.vdcraft.arvdc.timemanager.mainclass.PlaceholdersHandler

Następnie użyj jednej z następujących metod, aby zamienić jeden lub więcej placeholderów w dowolnym stringu :

String replaceAllPlaceholders(String msg, String world, String lang, Player p)
String replaceAllPlaceholders(String msg, String world, String lang)
String replaceAllPlaceholders(String msg, World w, String lang, Player p)
String replaceAllPlaceholders(String msg, World w, String lang)

Można pobrać język klienta poprzez zaimportowanie następującej klasy :

import net.vdcraft.arvdc.timemanager.mainclass.PlayerLangHandler

Następnie użyj jednej z następujących metod :

String setLangToUse(CommandSender sender)
String setLangToUse(Player p)

 TODO

Proszę otwórz zgłoszenie na GitHubie, jeśli chcesz konkretne usprawnienie lub napotkasz błędy.