JettasLogin

# JettasLogin v1.2.0 - Release Notes

## New Features

### CAPTCHA System
- Visual CAPTCHA verification during player registration
- 5-character alphanumeric codes displayed on in-hand map items
- Advanced rendering with gradient backgrounds, noise lines, and character distortion
- Automatic regeneration on incorrect input attempts
- Bot prevention to protect against automated registrations
- Admin debug mode to view CAPTCHA codes in console
- Case-insensitive validation for better user experience

### Global/Local Chat System
- Global chat channel for server-wide communication
- Local chat channel for world-specific communication (default)
- Private messaging system with `/msg` command
- Dual-mode commands: switch channel permanently or send single message
- Chat isolation during authentication process
- Permission-based access control for all chat features
- Customizable channel prefixes with color coding
- Tab completion for player names in private messages

## Improvements

### Security Enhancements
- CAPTCHA verification prevents bot registrations
- Auth world players completely isolated from chat system
- Enhanced token-based authentication for BungeeCord networks
- Improved MySQL synchronization across network servers

### User Experience
- Colored channel prefixes: [GLOBAL] in green, [LOCAL] in gray
- Clear visual distinction between chat channels
- Private message formatting: [You → Player] and [Player → You]
- Command aliases for convenience: /gb, /lc, /m, etc.
- Multi-language support for all new features (6 languages)

## Technical Details

### New Classes
- `CaptchaGenerator` - Generates visual CAPTCHA images
- `CaptchaManager` - Manages CAPTCHA sessions and validation
- `ChatChannelManager` - Tracks player chat channel preferences
- `ChatListener` - Filters chat messages based on channel and authentication
- `GlobalChatCommand` - Handles /global command and aliases
- `LocalChatCommand` - Handles /local command and aliases
- `MessageCommand` - Handles /msg command with tab completion

### Updated Classes
- `AuthenticationManager` - Integrated CAPTCHA verification into registration flow
- `WorldManager` - Added auth world detection for chat filtering
- `MessageUtil` - Added colorize method for chat formatting
- `LanguageManager` - Added 115 new translation keys across 6 languages
- `JettasLogin` - Registered new managers, listeners, and commands

### New Commands

/global [message] - Global chat (aliases: /gb, /g) /local [message] - Local chat (aliases: /lc, /l) /msg - Private message (aliases: /message, /tell, /whisper, /w, /m)

### New Permissions

jettaslogin.chat.global - Use global chat (default: true) jettaslogin.chat.local - Use local chat (default: true) jettaslogin.chat.msg - Send private messages (default: true) jettaslogin.chat.global.receive - Receive global messages (default: true) jettaslogin.chat.local.receive - Receive local messages (default: true)

## Compatibility

- Minecraft Version: 1.17.x - 1.21.x
- Server Software: Spigot/Paper
- Java Version: 17+
- MySQL: 5.7+ or 8.0+ (optional)

## Dependencies

- Spigot API 1.21-R0.1-SNAPSHOT
- Gson 2.10.1 (included)
- MySQL Connector 8.3.0 (included)
- HikariCP 5.1.0 (included)

## Installation & Upgrade

1. Stop your server
2. Replace old JAR with `JettasLogin-1.2.0.jar`
3. Start server to generate new configuration options
4. Configure chat permissions if needed (all default to true)
5. Restart server

## Known Issues

- MapPalette.matchColor() deprecation warning (non-critical, fully functional)

## Version History

**v1.2.0** (Current)
- Added CAPTCHA verification system
- Added global/local chat channels
- Added private messaging
- Enhanced security features
- Multi-language support for new features

**v1.1.0**
- BungeeCord network support
- Token-based authentication
- MySQL database integration
- Security architecture implementation

**v1.0.0**
- Initial release
- Basic authentication system
- Individual void worlds
- Timer system with visual effects
- Multi-language support