Changelog

[1.0.6] - 2025-11-21

Added

• Hover message in the name of the player and message.

Changed

• The /sgchat command now requires the sgchat.reload permission (or sgchat.admin) to use administrative actions such as reload. See plugin.yml for details.
• hover.enabled is read at plugin startup and requires a server restart to take effect. hover.name and hover.message remain reloadable and can be updated with /sgchat reload.

Fixed

• Resolved out-of-order chat disconnects by ensuring chat processing occurs on the main thread and avoiding async resends that could reorder client packets.

Removed / Notes

• Removed the /sgchat langs and /sgchat validate-langs subcommands.
• The plugin no longer falls back to messages.yml; migrate custom translations to lang/<code>.yml.

Changelog

[1.0.5] - 2025-11-18

Added

• Multi-language support
  • Language files moved to src/main/resources/lang/<code>.yml
  • Added placeholder language files: en, es, fr, de, pt, it (placeholders for translations)
  • Commands and system notifications are now translatable via lang/*.yml
• New /sgchat subcommands:
  • /sgchat langs — list available languages in plugins/SGChat/lang/
  • /sgchat validate-langs — validate missing keys across language files

Changed

• Messages now use language prefix automatically when retrieved via the messages manager
• Update checker console and player notifications are now translatable and colored

Fixed

• Ensure translation files are loaded from plugins/SGChat/lang/ and warn when missing (no silent fallback to old messages.yml)

Removed / Notes

• The plugin no longer falls back to messages.yml; please migrate custom translations to lang/<code>.yml.

Changelog

[1.0.4] - 2025-11-15

Added

• Discord webhook integration
  • Optional webhook support to send server events to a Discord channel
  • Configurable username and avatar for webhooks
• Chat relay to Discord
  • Optional: send player chat messages to the configured webhook (discord.send-chat)
  • Template configurable via discord.chat-message-template (placeholders: {player}, {displayname}, {message}, {server})

Changed

• Improved Discord embed handling for join/quit notifications
  • Embeds are used by default when discord.use-embeds is enabled

Fixed

• Fixed avatar fetch issues in Discord embeds
  • Crafatar UUIDs are now handled without hyphens and requests prefer a direct PNG URL
  • Added validation/fallback logic when building embed image URLs to reduce broken images

Removed

• Player avatar is no longer automatically attached to join/quit embeds by default (avoids broken/placeholder images)

Config Changes

Added to config.yml (under discord):

  # Chat relay: send player chat messages to Discord webhook
  send-chat: false
  # Template for chat messages sent to Discord (placeholders: {player}, {displayname}, {message}, {server})
  chat-message-template: "{displayname}: {message}"

Notes / Upgrade

• After upgrading, review and set discord.webhook-url and enable discord.enable: true to activate integration.
• Restart the server after changing Discord-related settings.

Technical

• Uses asynchronous HTTP requests to avoid blocking the server thread when calling webhooks.
• Embed JSON is built with safe escaping and optional author/thumbnail fields.

Changelog

[1.0.3] - 2025-10-24

Added

• Custom placeholders system
  • Add your own variables in custom-placeholders section of config.yml
  • Use placeholders anywhere in plugin messages with {placeholder}
  • Full color code support in placeholder values
  • Dynamic reloading with /sgchat reload
  • Examples included in default configuration

Changed

• Improved configuration reload system
  • More reliable configuration reloading
  • Better handling of custom placeholders updates
  • Enhanced error handling during reload

Fixed

• Fixed custom placeholders not updating on reload
• Fixed placeholder values not being saved correctly
• Fixed color codes not processing in placeholder values

Config Changes

Added to config.yml:

# Custom placeholders configuration
custom-placeholders:
  server: "&6My Server"
  website: "&bwww.example.com"
  discord: "&9discord.gg/example"

Technical

• Reworked configuration management system
• Improved config reload mechanism
• Enhanced placeholder processing efficiency
• Added better error handling for config operations

Changelog

[1.0.2] - 2025-10-18

Added

• Added update checker system
  • Automatically checks for new versions on Modrinth
  • Notifies operators and players with sgchat.admin permission when they join
  • Can be disabled in config using check-update: false

Fixed

• Fixed {level} placeholder not working in chat format
  • Now correctly displays player's experience level in chat messages
  • Works with both default and group-specific chat formats

Changed

• Simplified configuration structure
  • Removed unnecessary configuration options
  • Made update checker configuration more straightforward

Config Changes

Added to config.yml:

# Whether to check for updates (true/false)
check-update: true

Permissions

• sgchat.admin - Allows players to receive update notifications (defaults to op)

Technical

• Added Modrinth API integration for version checking
• Improved version comparison logic
• Added automatic update checking on player join
• Optimized permission checks for update notifications

Changelog

[1.0.1] - 2025-10-05

Minor update with fixes, configuration improvements, and new features.

Added

• /clear command to clear the chat (permission: sgchat.clear).
• Functional /unmute command with configurable messages (permission: sgchat.unmute).
• Option to specify reason and duration in /mute <player> [time] [reason].
• ASCII banner displayed in console when the plugin is enabled (shows version, author, and Discord link).
• CHANGELOG.md file with update history.

Improved

• Centralized all system messages (warnings, errors, confirmations) into messages.yml.
• Chat formats, join/quit messages, and MOTD are now configured from config.yml.
• MOTD is sent only to the joining player (not publicly broadcast).
• Added support to disable per-group formats (chat.enable-group-formats) and the automatic mute system (chat.enable-mute).
• Mute/Unmute messages now display duration and reason to both staff and the muted player.
• /sgchat now displays a list of subcommands and requires the sgchat.admin permission.
• /sgchat reload now reloads both config.yml and messages.yml.

Fixed

• Prevented double sending of join/MOTD/quit messages (removed extra class extending JavaPlugin and properly initialized managers).
• Fixed issues caused by Component.toString() — now sends Adventure Components correctly formatted.
• Fixed /unmute exception caused by missing getInstance() implementation.
• Fixed duplicate listener and command registrations (now handled once via SGChatPlugin).
• Corrected failed message and format conversions for proper display in both console and client.

Removed / Cleanup

• Removed duplicate or misplaced messages and keys from config.yml and messages.yml; cleaned and separated structure.

Update Notes

• Restart the server or use /sgchat reload after updating to apply changes.
• Review config.yml and messages.yml, and verify permissions:
  • sgchat.admin → access to /sgchat
  • sgchat.reload → reload configurations
  • sgchat.mute / sgchat.unmute → mute management
  • sgchat.msg → private messaging
  • sgchat.clear → clear chat