ImageOnMap

Czy kiedykolwiek chciałeś zobaczyć obraz na mapie w grze? ImageOnMap umożliwia to zrobić! (Zainspirowane ImgMap)

Funkcje

ImageOnMap umożliwia wczytanie obrazka z Internetu na mapę Minecrafta.

• Wczytuje obrazek z adresu URL na mapę. Obsługiwane są PNG, JPEG i GIF.
• Te obrazki zostaną zapisane na Twoim serwerze i ponownie wczytane po ponownym uruchomieniu.
• Duże obrazy będą automatycznie dzielone na kilka części! Na przykład obraz 1024x1024 zostanie podzielony na 16 map.
• Twój obraz będzie wyśrodkowany.
• Możesz umieścić swoją mapę w ramce na przedmiot.

To wtyczka wolnego oprogramowania na licencji GNU General Public License (wersja 3 lub nowsza). Kod źródłowy opublikowany na GitHub.

Najnowsza wersja jest kompatybilna wyłącznie z Minecraftem 1.15+.

• Dla wersji Minecraft 1.13 i 1.14 użyj 4.0-pre1.
• Dla starszych wersji, proszę użyć ImageOnMap 3.1 (uwaga: niezweryfikowane przez zespół BukkitDev — jeśli masz wątpliwości, użyj tutaj w BukkitDev 3.0, to samo, ale bez uprawnień).

Wsparcie i zgłaszanie błędów

Jeśli potrzebujesz pomocy z ImageOnMap, preferowaną metodą jest nasz serwer Discord. Mówimy po angielsku i po francusku. Powinieneś najpierw przeczytać FAQ!

Jeśli chcesz zgłosić błąd lub zasugerować funkcje, zdecydowanie najlepszą opcją dla nas jest issues na GitHubie, z którego powinieneś korzystać, gdy tylko to możliwe. Jeśli absolutnie nie możesz użyć GitHub, skorzystaj z powyższych opcji wsparcia.

Jesteśmy zespołem stojącym za ImageOnMap (i innymi), a prywatne wiadomości z Spigot mogą być odczytane tylko przez jedną osobę. Dlatego nie powinieneś wysyłać prośby o pomoc, sugestie ani zgłoszenia błędów za pomocą PM-ów Spigot lub BukkitDev. Każda wiadomość PM otrzymana po 28 czerwca 2020 r. z którymkolwiek z tych tematów zostanie zignorowana.

Szybki przewodnik

1. Upewnij się, że masz wolny slot w ekwipunku, ponieważ ImageOnMap da ci mapę.
2. Wpisz /tomap URL, gdzie URL to odnośnik do obrazu, który chcesz wyrenderować (zobacz sekcję poniżej).
3. Ciesz się swoim obrazem! Możesz umieścić go w ramce na przedmiot, aby stworzyć ładny plakat, jeśli chcesz.

Użytkownicy mówiący po niemiecku, możesz obejrzeć to wideo (dzięki StarlessMiner).
Osoby anglojęzyczne? (dzięki Arma)

Krótkie szkolenie po angielsku (dzięki ltjim007)

Polecenia i uprawnienia

/tomap <url>

Wyświetla obraz i daje graczowi mapę z nim.

• Ta komenda może być używana tylko przez gracza.
• Link musi być kompletny; nie zapomnij, że limit czatu to 240 znaków.
• Możesz użyć skracacza URL, takiego jak tinyURL lub bitly.
• Jeśli chcesz obraz w jednej mapie, wpisz resize po linku.
  • Jeśli chcesz dopasować do wielu map, dodaj szerokość i wysokość po resize: np. /tomap url resize 2 4
  • Możesz zmienić metodę skalowania, zastępując słowo kluczowe resize w poleceniu /tomap przez:
    • resize-stretched, aby rozciągnąć obraz na powierzchnię (obraz może być zniekształcony); lub
    • resize-covered, aby zapewnić pokrycie całej powierzchni (obraz nigdy nie będzie zniekształcony, ale niektóre fragmenty mogą zniknąć na brzegach).
• Uprawnienie: imageonmap.new (lub imageonmap.userender—legacy, ale będzie zachowane w wtyczce).

/maps

Otwiera GUI, aby zobaczyć, pobrać i zarządzać mapami użytkownika.

• Ta komenda może być używana tylko przez gracza.
• Otwiera GUI z listą wszystkich map w widoku z podziałem na strony.
• Wyświetlana jest także książka z pewnymi statystykami użycia (mapy utworzone, limity).
• Użytkownik może pobrać mapę przez lewy klik, lub zarządzać nią prawym kliknięciem.
• Mapy można zmieniać nazwę (dla organizacji), usuwać (ale nie będą już renderować się w grze!), lub częściowo pobierać (dla poster map zawierających więcej niż jedną mapę).
• Uprawnienie: imageonmap.list, plus imageonmap.get, imageonmap.rename i imageonmap.delete dla operacji w GUI.

/maptool <new|list|get|delete|explore|migrate>

Główne polecenie do zarządzania mapami. Również mniej używane na co dzień.

• Nazwy poleceń są całkiem oczywiste.
• /maptool new to alias dla /tomap.
• /maptool explore to alias dla /maps.
• /maptool migrate migruje stare mapy, gdy aktualizujesz IoM z wersji <= 2.7 do IoM 3.0. NALEŻY WYKONAĆ TO POLECENIE, ABY ODZYSKAĆ WSZYSTKIE MAPY PODCZAS TAKIEJ MIGRACJI.
• Uprawnienia:
  • imageonmap.new dla /maptool new;
  • imageonmap.list dla obu /maptool list i /maptool explore;
  • imageonmap.get dla /maptool get;
  • imageonmap.delete dla /maptool delete;
  • imageonmap.administrative dla /maptool migrate.

O uprawnieniach

Wszystkie uprawnienia są domyślnie przyznawane każdemu, z wyjątkiem imageonmap.administrative. Wierzymy, że w większości przypadków administratorzy serwerów chcą udostępnić możliwość tworzenia obrazów na mapach każdemu graczowi.
Unieważnić uprawnienie przy pomocy menedżera wtyczek, jeśli chcesz ograniczyć tę możliwość do wybranych użytkowników.

Możesz przyznać imageonmap.* użytkownikom, ponieważ to uprawnienie jest skrótem do wszystkich uprawnień użytkownika (z wyłączeniem imageonmap.administrative).

Konfiguracja

# Język wtyczki. Puste: język systemowy.
# Dostępne: en_US (domyślny, zapasowy) i fr_FR.
lang:

# Umożliwia zbieranie anonimowych statystyk dotyczących środowiska i użycia wtyczki
# Statystyki są publicznie widoczne tutaj: https://bstats.org/plugin/bukkit/ImageOnMap
collect-data: true
 
# Obrazy renderowane na mapach zużywają identyfikatory map Minecrafta, i ich liczba to tylko 32 767.
# Możesz ograniczyć maksymalną liczbę map, które gracz lub cały serwer mogą używać z ImageOnMap.
# 0 oznacza brak ograniczeń.
map-global-limit: 0
map-player-limit: 0

Changelog

3.0

Wydanie 3.0 to całkowita przebudowa oryginalnego ImageOnMap, teraz oparte na zLib, które dodaje wiele funkcji i naprawia wiele błędów.

Ta nowa wersja nie jest kompatybilna z starszymi, więc Twoje starsze mapy nie będą ładowane. Uruchom polecenie/maptool migrate (jako op lub w konsoli), aby odzyskać je w tej nowej wersji.

Wśród nowości znajdziesz:

• Nowe Splatter maps, ułatwiające wdrożenie i usuwanie dużych plakatów jednym kliknięciem!
• Nie ma już tagów przedmiotów, gdy mapy są umieszczane w ramkach na przedmiot!
• Wsparcie międzynarodowe (na razie obsługiwane są tylko francuski i angielski; mile widziane wkłady)
• Limity map (dla graczy i całego serwera)
• Nowy menedżer map (oparty na interfejsie inwentarza), aby wyświetlać listę, zmieniać nazwy, pobierać i usuwać Twoje mapy
• Ulepszenia w systemie poleceń (zintegrowana pomoc i autouzupełnianie)
• Asynchroniczne renderowanie map (twój serwer nie zamarza podczas renderowania dużych map, a możesz kolejować wiele renderowań map!)
• Zarządzanie UUID (które wymaga uruchomienia /maptool migrate)

3.1

• Naprawiono wsparcie uprawnień, dodając pełny zestaw uprawnień dla każdej akcji wtyczki.

4.0 pre-release 1

• Dodano kompatybilność z 1.13.2 i 1.14
• Porzucono kompatybilność z 1.12 i niższymi
• Ulepszono niektóre interfejsy
• Dodano obsługę zmiany rozmiaru obrazów do określonej wielkości: możesz wykonać /tomap https://url/image.png resize 2 2 aby uzyskać obraz w rozmiarze 2×2
• Wiadomości statusowe wysyłane są w pasku akcji zamiast czatu
• Dodano powrót statystyk (możesz z nich zrezygnować w plugins/bStats/config.yml)
• Dodano sprawdzanie aktualizacji

4.0 pre-release 2

• Wsparcie dla 1.15 (teraz budowane z wersją zLib kompatybilną z 1.15).
• Ta wersja jest kompatybilna wyłącznie z Minecraft 1.15 i nowszymi — dla starszych wersji Minecraft użyj 4.0-pre1 lub starszych.
• Ulepszono niektóre tłumaczenia we francuskim (dzięki Gabriel C.).

4.0

• Możesz teraz umieszczać mapę na podłożu lub na suficie.
• Języki z niestandardowymi znakami wyświetlają się poprawnie (naprawiono błąd kodowania UTF-8).
• Mapy typu Splatter nie wywołują wyjątku po umieszczeniu.
• Kiedy gracz umieszcza mapę Splatter, inni gracze w tej samej okolicy widzą ją w całości, łącznie z dolnym lewym rogiem.
• Dodano tłumaczenia na rosyjski i niemiecki (dzięki Danechek i squeezer).

4.2.0 Aktualizacja uprawnień i cliffhanger • Część I

• Wsparcie dla 1.17.
• Uprawnienia umożliwiające ograniczenie liczby map/obrazu używanych/posiadanych są teraz dostępne. (uprawnienia imageonmap.mapLimit.XX i imageonmap.imageLimit.XX, gdzie XX to liczba całkowita definiująca limit dla gracza).
• Dodano whitelist dla zaufanych witryn hostingowych obrazów. Dodaj listę images-hostnames-whitelist w config.yml i zapisz każdy prefiks URL, który chcesz zezwolić. Jeśli chcesz zezwolić na wszystko, usuń całą listę images-hostnames-whitelist lub wyczyść ją. Istnieje również uprawnienie do pomijania listy zezwolenia: imageonmap.bypasswhitelist.
  
  Kod (YAML):

  images-hostnames-whitelist:
  - i.imgur.com
  - cdn.discord.com
• Obrazy są teraz chronione przed interakcjami niezależnymi od gracza. (Żegnaj, podstępny szkielet, który doprowadzał do szkód sztuce!)
• Teraz domyślnie podczas wdrażania mapy ramka z przedmiotu staje się niewidoczna i wraca do widoczności po usunięciu mapy z ramki (istnieje uprawnienie, aby zezwolić na to zachowanie: imageonmap.placeinvisiblesplattermap).
• Błędy i optymalizacje.
  • Usunięto migratora (brak błędów podczas przeładowania lub czasem podczas ładowania serwera).
  • Naprawiono problem przy zmianie rozmiaru za pomocą resize 0 0.
  • Naprawiono problem z ładowaniem mapy. (mapa nie renderowała się w ogóle, jeśli nie była w ekwipunku gracza).
  • Dodano poprawkę do ładowania mapy na papierze. (mapa nie renderowała się w pełni na papierze).

4.2.1 Aktualizacja uprawnień i cliffhanger • Część II

 

• Wsparcie dla 1.18.
• Naprawiono problem z opóźnieniem spowodowany zmianami w ładowaniu map w wersji 4.2.0.
• Naprawiono problem z częściami map nie działającymi poprawnie.
• Naprawiono problem w trybie przetrwania, w którym zużywano niepoprawną ilość map.
• Naprawiono problem, w którym folder map obrazów nie był tworzony i powodował problemy.

Gromadzenie danych

Używamy bStats do zbierania podstawowych danych dotyczących wykorzystania tej wtyczki*. To można wyłączyć w pliku plugins/bStats/config.yml.