WHAT IS THIS PLUGIN?
This plugin adds an OSC server to your Hytale server, allowing external applications to send commands and control your game. OSC is a protocol commonly used in multimedia applications for real-time communication.

KEY FEATURES:
- Execute commands as the player from external apps
- Spawn entities at configurable offsets from player
- Drop items with custom amounts and positions
- Teleport player to coordinates
- Send in-game messages
- Full configuration support via config.json
- Perfect for Twitch chat commands, redeem integration, and streamer tools

With Interfuse + this plugin, you can let your viewers:
- Spawn mobs via channel points
- Drop items through chat commands
- Change game settings on redeems
- Trigger in-game events
- The possibilities are endless!

OSC ENDPOINTS:
The plugin listens for OSC messages on these paths (configurable):

/hytale/command/run [command]
  - Execute any command as the player
  - Supports %player% placeholder (e.g., "give %player% rock_gem_diamond")
  - Example: "gamemode creative" or "give %player% rock_gem_diamond --quantity=64"

/hytale/message/send [message]
  - Send a message to the player
  - Example: "Hello from Twitch!"

CONFIGURATION:
All settings can be configured in config.json:
- OSC server port (default: 9000)
- OSC server host (default: 0.0.0.0)
- OSC endpoint paths
- Feature toggles for each function
- Default values for offsets and amounts

IN-GAME COMMANDS:
/osc status - Show OSC server status
/osc reload - Reload configuration
/osc stop - Stop OSC server
/osc start - Start OSC server

SETUP:
1. Install the plugin to your Hytale server plugins folder
2. Start the server

INTERFUSE INTEGRATION:
Interfuse (available on Steam) is a powerful tool that makes OSC integration easy:
- No coding required
- Visual interface for creating commands
- Built-in Twitch integration
- Channel point redeems
- Chat commands
- Custom alerts and triggers

PERMISSIONS:
This plugin requires player-level permissions for all commands. In single-player mode, all operations apply to the local player.

SUPPORT:
For issues and feature requests, please visit the project page.

CREDITS:
- Uses java-osc library for OSC communication