This API allows you to display custom images on maps and to send individual maps to players.
- Tested Minecraft Versions:
- 1.17
- Source Code:
- https://github.com/InventivetalentDev/MapManager
- Donation Link:
- https://www.patreon.com/inventivetalent
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
For more details, check out the Javadocs.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();
}
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
LinksCode (spiget-meta (Unknown Language)):SlZOd2EkUm9kI1J3YW1GeUooVWtXa2QzZFdGPk4rSmFWelV3WVZoYWJHUiNSbk5hVnpVdytHMDVlVnAzUCswa0okUk1NMEp6WkZka2NHSnBPRDBrSiRSalIzZypXakpzZFZ7Vk1XaGpSK0ZvWW0xR2JscFkkVzFrYlZaNVl6SnNkbUpxTUcqa2JWWjVZekpzZG1KcFYrMGtSMlYwSlE9PQ==
[API] MapManager 1.8.5-SNAPSHOT
API to display custom images on item frames & maps
-
adammario6556, Mengx, wizzzle and 7 others like this.
![[IMG]](http://proxy.spigotmc.org/03b89c2282b33ef720a7e5ca8cfbbb31681bc8b8?url=https%3A%2F%2Fstatic.spigotmc.org%2Fimg%2Fbtn_donate.gif)
Recent Updates
- 1.17 support Oct 17, 2021
- Compatibility May 28, 2021
- fixes Feb 12, 2021
