Takaro Server Management and Much More....

CHANGELOG - Hytale-Takaro Integration Mod

  ========================================
  IMPORTANT: Configuration File Changes
  ========================================

  The configuration file has changed location and format!

  Old Location: AppData/Roaming/Hytale/UserData/Saves/<WorldName>/mods/HytaleTakaroMod/TakaroConfig.properties
  New Location: AppData/Roaming/Hytale/UserData/Saves/<WorldName>/mods/TakaroConfig.properties

  Migration Steps:
  1. Open your OLD config file and copy these two lines:
     - IDENTITY_TOKEN=YourServerName
     - REGISTRATION_TOKEN=your-token-here
  2. DELETE the entire old config file and the HytaleTakaroMod subdirectory
  3. Start the server - the mod will auto-create the NEW config file with all new properties
  4. Open the NEW config file and paste ONLY your IDENTITY_TOKEN and REGISTRATION_TOKEN values
  5. Save and restart

  DO NOT copy the old config file - it is missing required properties and will cause errors!

  ========================================
  CRITICAL WARNING - DEV Configuration
  ========================================

  DO NOT ENABLE DEV CONFIGURATION!

  NEVER enable these settings:
  - DEV_ENABLED=true
  - DEV_IDENTITY_TOKEN=...
  - DEV_REGISTRATION_TOKEN=...

  These settings are for internal Takaro development ONLY and will crash your server immediately. There is no reason for any user to
  ever enable these settings. If you see these in your config, make sure they are NOT enabled.

  ========================================

  Version 1.12.3 - 2026-01-23
  ---------------------------
  Added:
  - Configurable Command Prefix: Set custom prefix for Takaro commands (default: !)
    * Configure via COMMAND_PREFIX in TakaroConfig.properties
    * Supports any custom prefix (avoid / - reserved by Hytale)
  - Configurable Command Response: Private confirmation message when player uses command
    * Configure via COMMAND_RESPONSE in TakaroConfig.properties
    * Default: [cyan]Command[-] [green]{prefix}{command}[-]
    * Supports {prefix} and {command} placeholders
    * Full color code support
  - Command Interception: Commands no longer appear in public chat (behaves like Hytale's /commands)

  Changed:
  - Configuration File Location: Moved from mods/HytaleTakaroMod/TakaroConfig.properties to mods/TakaroConfig.properties
  - Configuration File Format: Old config files are incompatible - must migrate tokens only (see migration steps above)

  Version 1.11.3 - 2026-01-19
  ---------------------------
  Added:
  - Clickable Links in Messages: URLs in Takaro messages are automatically detected and made clickable
    * Supports http://, https://, and www. URLs
    * Links appear in cyan color and open in browser when clicked

  Version 1.10.0 - 2026-01-19
  ---------------------------
  Added:
  - Player Death Events: Track and report player deaths to Takaro
    * Uses Hytale's ECS system (RefChangeSystem) to detect deaths
    * Sends death events with player info, position, and damage source
    * Enables death-based stats and respawn commands

  Version 1.8.5 - 2026-01-18
  ---------------------------
  Added:
  - Dev Takaro Connection: Optional secondary connection for development/testing
    * Configure via DEV_ENABLED=true in TakaroConfig.properties
    * Separate dev identity and registration tokens
    * Production and dev connections run simultaneously
  - Friendly Item Names: Item lists now show display names (e.g., "Crude Arrow") instead of codes
    * Uses Hytale's I18n system for proper localization
    * Fallback to item code if translation unavailable

  Version 1.7.5 - 2026-01-18
  ---------------------------
  Added:
  - Console Commands for All API Actions: Execute any API action via console
    * testReachability - Test connection to Takaro
    * getPlayers - List all online players
    * getServerInfo - Display server information
    * listItems - Show all available items
    * sendMessage <message> - Broadcast message to all players
    * getPlayerLocation <player> - Get player coordinates
    * getPlayerInventory <player> - View player inventory
    * kickPlayer <player> [reason] - Kick player from server
    * banPlayer <player> - Ban player
    * unbanPlayer <player> - Unban player
  - Enhanced Help System: Categorized commands with examples and argument descriptions

  Version 1.4.0 - 2026-01-17
  ---------------------------
  Added:
  - Player Name Colors: Custom chat name colors via Takaro permissions
    * Takaro can set player name colors via setPlayerNameColor API action
    * Supports hex colors (e.g., ff0000) and named colors (e.g., gold, red, blue)
    * Colors cached in memory for instant application
    * Console command: setcolor <player> <color>
  - Color Code System: Rich text formatting in messages
    * Format: [color]text[-] (e.g., [red]Warning[-])
    * Supports hex: [ff0000]text[-]
    * Supports named colors: [red], [green], [blue], [yellow], [orange], [pink], [cyan], [magenta], [purple], [gold], [white],
  [gray], [black]

  Version 1.3.1 - 2026-01-16
  ---------------------------
  Added:
  - Player Bed Locations: Track and query player bed/spawn positions
    * API action: getPlayerBed returns bed coordinates
    * Console command: beds lists all player bed locations

  Version 1.3.0 - 2026-01-16
  ---------------------------
  Added:
  - Enhanced Console Commands: Execute Takaro actions directly from console
    * Core commands for testing and administration
    * Detailed help menu with examples

  Version 1.2.5 - 2026-01-15
  ---------------------------
  Initial Release

  Added:
  - Hytale-Takaro Integration: Complete integration between Hytale server and Takaro platform
    * WebSocket connection to Takaro (wss://connect.takaro.io/)
    * Real-time bidirectional communication
    * Automatic reconnection on disconnect
  - Player Event Tracking: Monitor player activity
    * Player connect/disconnect events
    * Player position tracking
    * Player inventory monitoring
  - Chat Integration: Full chat relay system
    * Send chat messages from Takaro to game
    * Forward game chat to Takaro
    * Support for private (DM) messages
  - Server Management API: Remote server control
    * Get server information
    * List online players
    * Get player location and inventory
    * Execute console commands
    * Teleport players
  - Item Management: Complete item system integration
    * List all available items with categories
    * Give items to players
    * Check item existence
  - Player Moderation: Administrative actions
    * Kick players
    * Ban/unban players
    * Execute commands as console
  - Hytale API Client: Optional integration with official Hytale API
    * Server telemetry reporting
    * Authentication support
    * Prepared for future Hytale API features
  - Configuration System: Simple properties-based config
    * Server identity token
    * Registration token for Takaro
    * Optional Hytale API configuration
  - Logging Integration: Forward server logs to Takaro
    * Real-time log streaming
    * Filtered log levels
    * Configurable log buffer

  ========================================