ImageMaps

ImageMaps to wtyczka dla serwerów Bukkit Minecraft, która umożliwia umieszanie niestandardowych obrazów w świecie poprzez renderowanie ich na mapy i umieszczanie ich w ramkach przedmiotów.

Może być używana do tworzenia infografik, niestandardowych obrazów oraz wyglądu niestandardowych tekstur.

Instalacja

Będziesz potrzebował serwera, który obsługuje Bukkit 1.13 lub nowszy oraz Spigot-API. Niektóre funkcje są dostępne tylko w nowszych wydaniach. Upewnij się, że używasz najnowszej wersji oprogramowania serwera przed zgłaszaniem problemów.

Włóż wtyczkę do katalogu plugins na serwerach i uruchom ją. Folder dla wtyczki zostanie automatycznie utworzony. Możesz umieścić swoje obrazy w folderze images w nim.

Aktualizacja z wersji < 1.0.0

Wtyczka powinna automatycznie przekonwertować plik maps.yml. Spróbuje utworzyć kopię zapasową przed wykonaniem konwersji, ale zaleca się również wykonać ją ręcznie.

Użytkowanie

Aby móc umieszczać obrazy, muszą one być obecne w folderze images. Możesz umieścić je tam za pomocą FTP lub po prostu skopiować, albo użyć polecenia pobierania wtyczki, które pozwala uzyskać dostęp do obrazów z Internetu.

Aby umieścić obrazy, uruchom polecenie /imagemap place i prawym kliknięciem bloku, który powinien być lewym górnym rogiem obrazu (według twojej perspektywy).

Obrazy domyślnie będą dzielone na 128x128 pikseli podobrazy, aby zmieścić się na mapie. Obraz może być skalowany za pomocą parametrów poleceń, jednak zaleca się przygotowanie prawidłowo skalowanych obrazów.

Paleta kolorów map Minecrafta jest bardzo ograniczona, co wymaga konwersji wejściowego obrazu przez wtyczkę/Bukkit. Spowoduje to, że twoje obrazy będą wyglądać inaczej w grze niż źródło. Dostępna tabela kolorów znajduje się tutaj: https://minecraft.gamepedia.com/Map_item_format#Color_table

Właściwości niewidocznej i stałej ramki przedmiotów są dostępne dopiero w wersji 1.16+. Możesz je modyfikować dla dowolnej ramki przedmiotów, używając konfigurowalnych (domyślnie drewniana motyka) przedmiotów. Prawy klik, aby przełączyć widoczność, a Shift+Prawy klik, aby przełączyć stan stały.

Polecenia

• /imagemap place <filename> [frameInvisible] [frameFixed] [frameGlowing] [size]
  • Rozpoczyna proces rozmieszczania
  • frameVisible i frameFixed są dostępne tylko w wersji 1.16+
  • frameGlowing jest dostępny tylko od 1.17+
• /imagemap download <filename> <sourceURL>
  
  • pobiera obraz z podanego adresu URL do folderu images
• /imagemap delete <filename>
  • usuwa obraz z folderu images
• /imagemap info <filename>
  
  • Wyświetla informacje, takie jak rozdzielczość i spodziewany rozmiar
• /imagemap reload <filename>
  
  • Przeładuj obraz, gdy plik obrazu ulegnie zmianie
• /imagemap list [page]
  • Wyświetla listę wszystkich obrazów w folderze images
• /imagemap help [command]
  • Wyświetla pomoc dla poleceń

Uprawnienia

imagemaps.* - przyznaje dostęp do wszystkich uprawnień

imagemaps.place - przyznaje dostęp do polecenia /imagemap place

imagemaps.download - przyznaje dostęp do polecenia /imagemap download

imagemaps.delete - przyznaje dostęp do polecenia /imagemap delete

imagemaps.info - przyznaje dostęp do polecenia /imagemap info

imagemaps.list - przyznaje dostęp do polecenia /imagemap list

imagemaps.reload - przyznaje dostęp do polecenia /imagemap reload

imagemaps.help - przyznaje dostęp do polecenia /imagemap help

imagemaps.toggleFixed - pozwala na przełączanie stanu „fixed” ramki za pomocą drewnianej motyki

imagemaps.toggleVisible - pozwala na przełączanie stanu „visible” ramki za pomocą drewnianej motyki

Wszystkie uprawnienia mają domyślnie włączone dla OP-ów.

Maven

Będziesz musiał skonfigurować swoje środowisko, aby uzyskać dostęp do repozytoriów GitHub.

<repository>
  <id>github</id>
  <name>ImageMaps repository</name>
  <url>https://maven.pkg.github.com/SydMontague/ImageMaps&lt;/url&gt;
</repository>

<dependency>
  <groupId>net.craftcitizen</groupId>
  <artifactId>imagemaps</artifactId>
  <version>1.0.1</version>
</dependency>

Ta wtyczka została opracowana dla serwera CraftCitizen w trybie survival Minecraft.