[API] MapManager icon

[API] MapManager -----

API to display custom images on item frames & maps



This API allows you to display custom images on maps and to send individual maps to players.
Its main feature is the support for rapid map updates (as in AnimatedFrames), since the map data can be sent to players and you can later change the map displayed in an item frame or in the player's inventory.



Usage
Code (Java):

try {
    //Get the MapManager instance
    MapManager mapManager = ( (MapManagerPlugin ) Bukkit. getPluginManager ( ). getPlugin ( "MapManager" ) ). getMapManager ( ) ;

    //Wrap the local file "myImage.png"
    MapWrapper mapWrapper = mapManager. wrapImage (ImageIO. read ( new File ( "myImage.png" ) ) ) ;
    MapController mapController = mapWrapper. getController ( ) ;

    //Add "inventivetalent" as a viewer and send the content
    mapController. addViewer (Bukkit. getPlayer ( "inventivetalent" ) ) ;
    mapController. sendContent (Bukkit. getPlayer ( "inventivetalent" ) ) ;

    //At this point, the player is able to see the image
    //So we can show we can show it in ItemFrames
    mapController. showInFrame (Bukkit. getPlayer ( "inventivetalent" ), null /* <Item Frame Object > */ ) ;
    //or just as an Item
    mapController. showInHand (Bukkit. getPlayer ( "inventivetalent" ) ) ;
} catch ( IOException e ) {
    e. printStackTrace ( ) ;
}
 
For more details, check out the Javadocs.

Depends on PacketListenerAPI!




Commands

/mapmanager reload - Reloads the configuration

Permissions
mapmanager.reload - Permission to reload the config


Config
Code (YAML):

# If vanilla maps should be allowed to be sent to the players (less efficient, since we need to check the id of every sent map)
allowVanilla
: true

# Change this to a higher number to "preserve" a number of map IDs that won't be used by MapManager plugins
# Please note that increasing this too much limits the amount of maps that plugins can create
forcedOffset
: 0

# If the plugin checks for duplicate images before creating a new one (Less efficient when first creating a image, but more efficient overall)
checkDuplicates
: true

# Cache the packet data in the image object (less CPU intensive for a lot of players, but probably a bit more memory intensive depending on the image size)
cacheData
: true

sender
:
  # Delay between map packets (ticks)
  delay
: 2

  # Maximum amount of map packets sent at once
  amount
: 10

  # Allow immediate sending of map data
  allowQueueBypass
: true

# Enable this if you are using PaperSpigot (and/or you get this error: http://paste.inventivetalent.org/damuhonebu)
paperSpigot
: false
 

Maven
[​IMG]





Code (spiget-meta (Unknown Language)):
SlZOd2EkUm9kI1J3YW1GeUooVWtXa2QzZFdGPk4rSmFWelV3WVZoYWJHUiNSbk5hVnpVdytHMDVlVnAzUCswa0okUk1NMEp6WkZka2NHSnBPRDBrSiRSalIzZypXakpzZFZ7Vk1XaGpSK0ZvWW0xR2JscFkkVzFrYlZaNVl6SnNkbUpxTUcqa2JWWjVZekpzZG1KcFYrMGtSMlYwSlE9PQ==
Links
Resource Information
Author:
----------
Total Downloads: 57,477
First Release: Feb 28, 2016
Last Update: Apr 1, 2022
Category: ---------------
All-Time Rating:
18 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings