⚡UltraDiscord⚡ [Spicord Addon]

Overview
UltraDiscord It's a integration designed to connect your Minecraft server and your Discord community in a powerful, customizable, and seamless way. Built from the ground up with a multi-platform architecture, UltraDiscord offers a consistent and feature-rich experience for individual Spigot servers as well as BungeeCord or Velocity networks.

Installation guide
(It is essential that you already have Spicord installed, configured with your bot token, and running correctly)

1 - Download the UltraDiscord .jar file that corresponds to your platform (Spigot, BungeeCord, or Velocity).

2 - Place the downloaded UltraDiscord_...jar file into your server's plugins folder.

3 - Go to the plugins/Spicord/ folder and open the config.toml file and find the addons section.

4 - Add the id "ultradiscord" to this list.

5 - Start your server.

Detailed Features

Fully Customizable Discord Commands
Create your own /slash commands in Discord to display vital information about your server. Configuration is as simple as editing the config.yml file.

• 100% Configurable Embeds: Define every aspect of the response message: title, description, color, author (with icon), footer (with icon), main image, thumbnail, text fields, and timestamp.
  
• Channel Restrictions: Limit which commands can be used in which channels, or make them available everywhere.
• NEW! Interactive Link Buttons: Guide players to your store, website, or social media by adding fully configurable buttons (label, URL, and emoji) to your command responses.
  

Player Counter Voice Channel
Keep your community informed about server activity with a voice channel that automatically updates its name to show the number of connected players.

• Customizable Format: Define exactly how the channel name will look using placeholders (%online%/%max% Players).
• Update Interval: Control how frequently the channel updates to avoid Discord's rate-limits.
• Proxy Support: On Bungee/Velocity networks, you can define a global maximum player count (network_max_players) so the counter reflects the status of the entire network.

Event Logging System
Log a variety of in-game events directly to the Discord channels of your choice. Each event is modular and can be enabled, disabled, and fully customized from the events.yml file.

• Player Join & Leave: Announce when a player joins or leaves the server. Works on all platforms (Spigot, Bungee, Velocity).
  • Placeholders: %player_name%
    
• Player Death (Spigot Only): Log every death, showing who died, the death message, the world, and the exact location.
  • Placeholders: %player_name%, %death_message%, %world_name%, %location%
• Advancements (Spigot Only): Celebrate your players' achievements by announcing them in Discord. You can ignore specific advancements (like the initial ones) to prevent spam.
  • Placeholders: %player_name%, %advancement_title%, %advancement_description%
    
• Sign Placement (Spigot Only): Log the content of signs placed by players. The text is cleaned of color codes for clear reading.
  • Placeholders: %player_name%, %world_name%, %location%, %line1%, %line2%, %line3%, %line4%
    
• Fish Caught (Spigot Only): Announce when a player catches an item while fishing.
  • Placeholders: %player_name%, %item_caught%, %world_name%, %location%
    

Tebex Integration
Celebrate your community's support with a seamless Tebex integration.

• Purchase Announcer: Every purchase made on your webstore is announced in a designated Discord channel.
  
• Universal Functionality: By using the official Tebex API with your secret key, this feature is fully supported on all platforms (Spigot, BungeeCord, and Velocity).
  
• Deluxe Embeds: Fully customize the announcement with placeholders like %player_name%, %price%, %currency%, and %packages%.
• Interactive Buttons: Add customizable buttons with links to your store, forums, or any other URL to increase engagement.
  

ExcellentCrates Integration (Spigot Only)
If you use ExcellentCrates, you can log the rewards your players obtain.

• Reward Logging: Announce in a Discord channel when a player gets a prize from a crate.
• All the Info: Display the player, crate name, reward, rarity, and chance of obtaining it in a customizable embed.
  

Commands and Permissions

The ultradiscord.admin permission is granted to server operators (OP) by default.

Configuration files
• config.yml
• tebex.yml
• events.yml

Important Notes & Tips

• Critical Dependency: This plugin is an addon for Spicord. You must have Spicord installed and correctly configured for UltraDiscord to work.
• Tebex Key: The Tebex integration requires the Game Server Secret Key found under Integrations > Game Servers on your Tebex dashboard, not the webhook secret key.
• Discord Command Updates: After using /ultradiscord reload to update custom commands, Discord may take a few seconds to register the changes. If a command doesn't appear, please be patient. This is normal Discord behavior.
• Multi-Platform: Remember to use the correct .jar file for your server type (Spigot, BungeeCord, or Velocity).
  
  Join my Discord Server if you need help or want to make a suggestion.
  
  New features and integrations coming soon!