MediaAdvertise

[](https://ko-fi.com/alekkss_/tip) # 📢 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 ``` 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+ - Optional: PlaceholderAPI ## 🧩 Extra Features - Global broadcast system - Player head display in chat - Hover interactions - Configurable sounds - Fully modular & lightweight design - No unnecessary dependencies ## ❤️ Support If you need help or want to suggest features, feel free to reach out.