AdsPoster

A Minecraft Spigot/Paper plugin for managing advertising regions and displaying custom ads

Overview
AdsPoster is a powerful Minecraft plugin that allows server administrators to define advertising regions and display custom advertisements using item frames. The plugin supports both map-based ads and banner-based ads, providing flexibility for various advertising needs.

Features

• Region-Based Ad Management: Define cuboid regions where ads will be displayed
• Command-Based Controls: Easy-to-use /ads command with multiple subcommands
• Multiple Ad Types: Support for both filled maps and banners
• Persistent Storage: All regions are saved to YAML configuration and persist across server restarts
• Asynchronous Operations: File operations and ad placement handled asynchronously to prevent lag
• Permission System: Granular permission controls for different operations
• Customizable Messages: All messages can be customized through the configuration file
• Tab Completion: Full tab completion support for all commands
• Modular Design: Easily extensible with new features like rotating or scheduled ads

Installation

1. Download the AdsPoster.jar file
2. Place it in your server’s plugins folder
3. Restart your server
4. Configure the plugin by editing plugins/AdsPoster/config.yml

Commands
All commands use the /ads prefix:

Command	Description	Permission
/ads set pos1 <regionName>	Set the first corner of a region	adsposter.set
/ads set pos2 <regionName>	Set the second corner of a region	adsposter.set
/ads place <regionName> <adId>	Place ads in a defined region	adsposter.place
/ads remove <regionName>	Remove ads from a region	adsposter.remove
/ads list	List all defined regions	adsposter.admin
/ads info <regionName>	Show detailed region information	adsposter.admin
/ads help	Display help information	adsposter.admin

Permissions

Permission	Description	Default
adsposter.admin	Access to all AdsPoster commands	op
adsposter.set	Allows setting region positions	op
adsposter.place	Allows placing ads in regions	op
adsposter.remove	Allows removing ads from regions	op

Usage Guide
Defining a Region

1. Stand at the first corner of your desired region
2. Run /ads set pos1 myRegion
3. Move to the opposite corner
4. Run /ads set pos2 myRegion
5. Region is automatically saved

Placing Ads
Map-based ads:
(Replace 0 with your map ID)

Banner-based ads:
(Replace WHITE_BANNER with a valid banner material)

Removing Ads
Viewing Regions
List all regions:
View region info:
Configuration
The configuration file is located at plugins/AdsPoster/config.yml:

Configuration Options

• async_file_operations: Enable asynchronous file operations (recommended: true)
• item_frame.invisible: Make item frames invisible
• item_frame.fixed: Prevent item frames from being broken
• item_frame.glow: Make item frames glow
• max_region_size: Maximum region size per dimension (in blocks)
• debug: Enable debug logging

Data Storage
All region data is stored in plugins/AdsPoster/ads_positions.yml:

Future Extensions

• Rotating Ads
• Scheduled Ads
• URL Integration
• Analytics
• Economy Integration
• Holographic Ads

Support
For issues or requests:

• Author: NotGamerPratham
• Version: 1.0.0
• Discord: Join Server

License
This plugin is provided as-is for use on Minecraft servers. Please respect the author's work.

Credits
Author: NotGamerPratham
Plugin Name: AdsPoster