MediaAdvertise
MediaAdvertise is a modern Paper/Spigot 1.20+ plugin designed for Minecraft servers that want to promote YouTube content (videos and livestreams) directly in-game and on Discord in a stylish, automated, and fully configurable way.Perfect for content creator servers, communities, and networks that want to boost engagement and promote media professionally.
Key Features
Main Command
/ad <video|livestream> <youtube_link>Allows players to promote a YouTube video or livestream directly into server chat and Discord.
YouTube Promotion System
- ✔ Supports videos and livestreams
- ✔ Automatic content type detection (video or live stream)
- ✔ Advanced YouTube link validation
- ✔ Duplicate prevention (same video cannot be promoted twice)
- ✔ Link normalization (short URLs → full YouTube format)
- ✔ Supported formats:
- youtube.com/watch?v=
- youtu.be/
- youtube.com/live/
In-Game Chat Announcements (Modern & Interactive)
All announcements are displayed using the Adventure API (MiniMessage) with a clean, modern broadcast style.
Livestream Format
- LIVE NOW (bold red header)
- Player name
- Stream title (auto-fetched if available)
- Clickable WATCH NOW link
- Player head displayed in message
Video Format
- NEW VIDEO (bold purple header)
- Creator name
- Video title (auto-fetched via YouTube API / oEmbed)
- Clickable WATCH NOW link
- Player head displayed in message
Chat Design
MiniMessage formatting support HEX color customization Hover text: "Click to watch" Clean broadcast-style layout Global server-wide announcements Optional PlaceholderAPI support
Discord Integration
Automatically sends a Discord webhook embed when content is promoted:- Clickable video title
- Embed colors:
- red for livestreams
purple for videos
Content type label (LIVE NOW / NEW VIDEO)
Creator name
Watch link button- 🖼 YouTube thumbnail preview (if available)
- ⏱ Automatic timestamp
Configuration (config.yml)
Fully customizable settings:- Webhook URL
- Cooldowns
- HEX colors (video/live)
- Chat messages (MiniMessage)
- Enable/disable Discord integration
- Title fetching toggle
- Blocked links list
- Sound effects
- Global broadcast settings
Language Support (language.yml)
Fully customizable messages including:- Success messages
- Error messages
- Cooldown messages
- LIVE NOW / NEW VIDEO labels
- WATCH NOW text
Permissions
- media.advertise → Allows promoting videos
- media.bypass.cooldown → Bypass cooldown restrictions
- media.admin → Access admin commands
🛠 Admin Commands
/mediareload Reloads configuration files without restarting the server.Aliases:
- /madreload
- /mareload
Technical Features
- Async API calls (non-blocking)
- Clean modular architecture
- Persistent storage (YAML or SQLite)
- YouTube metadata fetching (oEmbed / Data API v3)
- Input sanitization & validation
- Duplicate tracking system
- Cooldown system per player
- Full logging system
Requirements
- Minecraft Paper/Spigot 1.20+
- Java 17+
Extra Features
- Global broadcast system
- Player head display in chat
- Hover interactions
- Configurable sounds
- Fully modular & lightweight design
- No unnecessary dependencies
Support
