Перейти к содержимому
Mineforgian

TeamChatPrefix

A lightweight Spigot plugin that adds team-based prefixes, suffixes, and colors to player chat messages using the scoreboard system.

Загрузки
858
Подписчики
4
Обновлён
17 октября 2025 г.
Лицензия
MIT

Опубликован 14 августа 2025 г.

Исходный кодСообщить об ошибке

spigot Tested on

TeamChatPrefix

TeamChatPrefix is a lightweight Spigot plugin that enhances in-game chat by automatically applying team-based prefixes, suffixes, and colors to player messages using Minecraft's scoreboard system.

Features

  • Automatic Team Formatting - Applies scoreboard team prefix, suffix, and color to chat messages
  • Customizable Chat Format - Fully configurable message format with various placeholders
  • Easy Configuration - Simple YAML configuration with comprehensive options
  • Runtime Management - Reload configuration without restarting using /tcp reload
  • Team Color Support - Uses team colors or configurable fallback colors
  • Update Notifications - Built-in update checker to stay current with latest versions
  • Lightweight - Performance-friendly with minimal resource usage
  • Broad Compatibility - Works with Bukkit, Spigot, Paper, Purpur, and more

Usage

  1. Install the plugin on your server
  2. Set up scoreboard teams with prefixes, suffixes, and colors
  3. Assign players to teams
  4. Chat messages will automatically use team formatting

The plugin works immediately with default settings, but you can customize the chat format in the config.yml file.

Commands

  • /tcp reload - Reload the plugin configuration
  • /tcp version - Check plugin version and update information
  • /tcp status - View current plugin status and settings
  • /tcp toggle - Enable or disable the plugin

Configuration

The config.yml file allows you to customize:

  • Chat message format with placeholders
  • Team color usage preferences
  • Default colors for players without teams
  • Update checker settings
  • Plugin enable/disable state

Placeholders

  • %playername% - Player's display name
  • %team% - Team name
  • %prefix% - Team prefix
  • %suffix% - Team suffix
  • %teamcolor% - Team color
  • %message% - Chat message

Support

For support, bug reports, or feature requests, visit the GitHub repository.

Ченджлог

1.3Релиз1.21.9, 1.21.10, 1.21.11 · 17 октября 2025 г.

TeamChatPrefix Changelog

Version 1.3 - Enhanced Configuration & Features

🚀 New Features

  • Toggle Command - Enable/disable the plugin without reloading using /tcp toggle
  • Status Command - View current plugin status and configuration with /tcp status
  • Tab Completion - Smart command suggestions when typing /tcp
  • Enhanced Update Checker - Periodic update checks with visual notifications
  • Console Team Display - Optional team name logging in console messages
  • Flexible Color Configuration - Support for both color names and codes in config

⚙️ Configuration Improvements

  • Added enabled option to toggle plugin functionality
  • Added show-team-name-in-console for better logging
  • Added update checker configuration section:
    • update-checker.enabled - Enable/disable update checks
    • update-checker.interval-minutes - Set check frequency
  • Improved color handling with default-color supporting both names and codes
  • Better configuration error handling with safe fallbacks

🛡️ Enhanced Reliability

  • Safe Configuration Loading - Graceful degradation on config errors
  • Improved Error Handling - Better exception management and logging
  • Null Safety - Comprehensive null checks throughout the code
  • Permission System - Refined permission structure with better defaults

🔧 Command Enhancements

  • Extended Command Set:
    • /tcp reload - Reload configuration (existing)
    • /tcp version - Show version info (enhanced)
    • /tcp status - Display current settings (new)
    • /tcp toggle - Enable/disable plugin (new)
  • Better User Feedback - More informative command responses
  • Command Aliases - Added tcpadmin as additional alias

📊 Performance Optimizations

  • Asynchronous Operations - Improved async handling for better performance
  • Resource Management - Better connection and resource handling
  • Efficient Scheduling - Optimized update checker intervals

🐛 Bug Fixes

  • Fixed color parsing issues in configuration
  • Improved team color detection logic
  • Better handling of missing team data
  • Fixed potential memory leaks in update checker

📝 Documentation

  • Comprehensive in-line code documentation
  • Enhanced config.yml with detailed comments
  • Better permission descriptions
  • Improved console logging messages

🔄 Backward Compatibility

  • Maintains full compatibility with existing v1.2 configurations
  • All existing placeholders and features preserved
  • Smooth upgrade path from previous versions

🎯 Technical Improvements

  • Code Refactoring - Cleaner, more maintainable code structure
  • Better Logging - More descriptive log messages with levels
  • Enhanced API Usage - Proper use of Bukkit API features
  • Modern Java Practices - Updated code patterns and best practices

Upgrade Note: Version 1.3 maintains full backward compatibility. However, to get the new configuration with all documentation and the improved format, it is recommended to delete the "TeamChatPrefix" folder in your plugins directory before updating. This will generate a fresh config file with all new options and comments. Your existing configuration will still work automatically if you keep it, but you won't have the new documentation and default values for new settings.

1.2Релиз1.21.9, 1.21.10, 1.21.11 · 19 августа 2025 г.
  • Added /tcp version command to check current and latest version
  • Implemented automatic update check via Modrinth API

Version Info

1.1Релиз1.21.9, 1.21.10, 1.21.11 · 18 августа 2025 г.

🔧 Config support added

  • Customizable chat format in config.yml (format)
  • Option to enable/disable team colors (use-team-color)
  • Set a default color if no team color exists (default-color)
  • Reload the config using /tcp reload

Комментарии

Загружаем…