
SGChat | Hover Support | No Dependencies | PAPI Support
A plugin focused on enhancing your server’s chat to improve player’s gameplay experience.
Автор: NexHQ3064обновлён 21 нояб. 2025 г.
УправлениеОбщениеУтилиты
Описание

SGChat — Quick reference (v1.0.6)
Install ▸
- Put the JAR in
plugins/ - Restart server
- Edit
config.ymlandsrc/main/resources/lang/*.yml(orplugins/SGChat/lang/)
Note: messages.yml is deprecated — use lang/<code>.yml.
Quick config ▸
chat.formatsupports{player},{displayname},{message},{level}hover.enabledrequires a server restart to take effect —hover.name/hover.messageare reloadable with/sgchat reloadcustom-placeholdersare reloadable via/sgchat reload
Commands & permissions ▸
/sgchat reload— permission:sgchat.reload(orsgchat.admin)/msg,/r— messaging (usessgchat.msgwhere applicable)/mute,/unmute— moderation (sgchat.mute)/clear—sgchat.clear
Notes ▸
- Removed
/sgchat langsand/sgchat validate-langs(they no longer exist) - Fixed out-of-order chat disconnects (chat processing now occurs on main thread)
- Update checker and language messages are translatable via
lang/*.yml
If you want, I can also add a very short example chat.format and a minimal config.yml snippet. Keep it short?
Последние версии
Все версии →release
SGChat 1.0.6
1.0.621 нояб. 2025 г.123Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
# 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`.
release
SGChat 1.0.5
1.0.518 нояб. 2025 г.17Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
# 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`.
release
SGChat 1.0.4
1.0.415 нояб. 2025 г.34Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
# 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`):
```yaml
# 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.
release
SGChat 1.0.3
1.0.325 окт. 2025 г.37Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
# 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`:
```yaml
# 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
release
SGChat 1.0.2
1.0.219 окт. 2025 г.26Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
# 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`:
```yaml
# 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
release
SGChat 1.0.1
1.0.15 окт. 2025 г.28Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, spigot
Что нового
# 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
release
SGChat 1.0-SNAPSHOT
1.0-SNAPSHOT22 сент. 2025 г.41Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, spigot