Map-Ads - Ads on maps ✏️ [1.16.5 - 1.21.9] 1.2.38

How it works
Admins can create ad-screens that can be used by players to display their own images to advertise something (their shop for example). Multiple ads can run on one screen (the screen cycles through the ads, each ad will be shown for a minute). Staff has to manually review ads before they go live.

Features

• Everything is clientside
  • No existing maps will be overwritten
  • Won't hurt your servers performance since the heavy lifting can be done in separate threads*
    • Certain animations can cause performance problems depending on your CPU and Minecraft version.
• Easy-to-use GUIs for staff and players
• Configurable help book that explains the advertising process to players
• Discord integration
  • Requires free map-ads-discord-bot extension
  • Docs
• Image dithering
  • Currently only supports the Floyd-Steinberg algorithm
  • What is image dithering?
• Screen groups
• (Experimental) Transition recording
• Good documentation
• Developer API
• Open-source
• Compatible with Spigot, Paper and Purpur

Compatibility issues

• Colorful Tools and ImageOnMap overwrite the /maps command. Use /maps:maps as a workaround.
• MapManager and MapReflectionAPI force all maps to use positive ids. This breaks Map-Ads because it uses negative map ids.

Installation / Configuration / Usage
Please check out the wiki! Everything is explained there in detail.

Commands
Spoiler: Commands
/mapads
/mapads advertise
/mapads defaultimage set SIZE/SCREEN DITHER IMAGEURL
/mapads help
/mapads premium
/mapads preview DITHER IMAGEURL
/mapads review list
/mapads screen create NAME SCREENID
/mapads screen set transition NAME TRANSITION
/mapads screen set screenid NAME SCREENID
/mapads screen teleport NAME
/mapads advert list
/mapads advert remove ADVERTID
/mapads group create GROUPID GROUPNAME
/mapads group remove GROUPID
/mapads group list
/mapads group screen add GROUPID SCREENID
/mapads group screen remove GROUPID SCREENID
Permissions
Spoiler: Permissions
mapads.admin - Players with this perm get notifications about broken screens and new ads
mapads.update - Players with this perm receive messages about new updates
mapads.command.advertise - /mapads advertise
mapads.command.defaultimage - /mapads defaultimage
mapads.command.review - /mapads review
mapads.command.preview - /mapads preview
mapads.command.premium - /mapads premium
mapads.command.screen - /mapads screen
mapads.command.advert - /mapads advert
mapads.command.group - /mapads group
mapads.limit.concurrent-ads.NUMBER - Limits the maximum amount of ads a player can rent at the same time (replace NUMBER with the amount)
Dependencies

• An economy plugin
  • Supported economy plugins: Vault, PlayerPoints, AquaCore (untested)
• maps
  • For versions 1.1.4 and below use maps v1.0.6
  • For versions 1.2.0 - 1.2.11 use maps v2
  • For versions 1.2.12 and up use maps v3

Optional dependencies

• map-ads-discord-bot (for the Discord integration)

Images
Spoiler: Images
Videos
Spanish showcase by @Ajneb97 (v1.2.1)

Things to keep in mind

• The plugin was not designed to sync ads across multiple servers!
• This plugin was meant for Hub or SMP servers, but you could use it on basically any type of server.
• This plugin uses bStats.