Admin WebDash

A powerful web-based administration panel for Hytale servers, providing real-time monitoring and management capabilities through a beautiful Hytale-themed interface.

Features

Player Management

Real-time player monitoring with live stats (Health, Stamina, Mana, Defense)
Player actions: Kick, Ban, Toggle OP, Teleport players
Gamemode switching: Visual button-based selection for Creative and Adventure modes
Heal players: Instantly restore health, stamina, and mana to maximum
Give items: Visual item browser with search, icons, and quantity selector
Clear inventory: Remove all items from a player's inventory
Inventory viewer with visual item display and tooltips
Player coordinates and game mode tracking
Search and filter players instantly

Moderation Tools

Ban/Unban players with custom reasons
Mute system with duration options (5min, 30min, 1hr, 1day, permanent)
View muted players with remaining time display
Kick players temporarily from the server
View banned players list with timestamps
Direct file access to bans.json for verification
Automatic ban and mute list synchronization

World Management

Time control: Set time to day, night, noon, or midnight instantly
Weather control: Change weather to clear, rain, or storm
Warp system: Create named teleport points and teleport players to them
Warp management: View, create, and delete warp points with coordinates

Server Communication

Broadcast messages to all players
Live server chat monitoring
Real-time message updates

Server Statistics

Live TPS monitoring with color-coded performance indicators
Memory usage tracking with automatic SI unit conversion
Online player count
Server uptime display

Installed Mods

Automatic mod detection from installed plugins
CurseForge integration for rich mod metadata
Display mod icons, authors, and download counts
Direct links to CurseForge pages
Alphabetically sorted mod list

Web Interface

Hytale-themed design matching the official website
Responsive layout for desktop and mobile
Live connection status with automatic reconnection
Keyboard shortcuts (Ctrl+R to refresh, Ctrl+F to search)
Visual item browser with search functionality

Installation

Standard Installation

Download AdminWebDash-1.0.jar from the releases page
Place the JAR file in your Hytale server's Mods folder
Start or restart your Hytale server
Check the console for the dashboard URL and admin token
The dashboard will be accessible at the displayed URL (default: http://localhost:9081)

Docker Installation

If you're running your Hytale server in Docker:

Place the mod in your mounted mods directory
Expose port 9081 in your docker-compose.yml:

services:
  hytale:
    image: ghcr.io/machinastudios/hytale
    stdin_open: true
    tty: true
    ports:
      - "5520:5520/udp"
      - "9081:9081"  # Admin WebDash
    volumes:
      - ./mods:/hytale/mods
      - ./logs:/hytale/logs
      - ./universe:/hytale/universe
    environment:
      - SERVER_ACCEPT_EARLY_PLUGINS=true
      - SERVER_BIND=0.0.0.0:5520

Restart your container and access the dashboard at http://localhost:9081

Note: If you set port: 0 in the config for a random port, Docker cannot dynamically map random ports. You must use a fixed port number (like 9081) in both the config and docker-compose.yml.

Configuration

The mod creates a configuration file at mods/AdminWebDash/config.json:

{
  "port": 9081,
  "adminToken": "your-secure-token-here",
  "loggingEnabled": false
}

Configuration Options

port: The port number for the web dashboard
- Default: 9081
- Valid range: 1024-65535
- Set to 0 for a random available port (useful for avoiding conflicts)
adminToken: Security token required to access the dashboard (auto-generated on first run)
loggingEnabled: Enable/disable custom logging to logs/dashboard.log (default: false)

Note: After changing the port, restart your server for the changes to take effect. If using port 0, check the console output for the actual assigned port.

First Time Setup

After starting the server, check the console output or mods/AdminWebDash/config.json for your admin token and dashboard URL
Open your browser and navigate to the URL shown (default: http://localhost:9081)
Enter the admin token from the config file
You're ready to manage your server!

Tip: Bookmark the dashboard URL for quick access.

Security

Token-based authentication protects all API endpoints
Change the auto-generated admin token in the config file
Keep your admin token secure
Dashboard is only accessible from the server's network by default

Logging

Custom logging writes to logs/dashboard.log. Disabled by default, enable with loggingEnabled: true in config.

Keyboard Shortcuts

Ctrl/Cmd + R: Refresh dashboard data
Ctrl/Cmd + F: Focus search box
Escape: Close modals

Requirements

Hytale Server (compatible version)
Java 25 or higher
Modern web browser (Chrome, Firefox, Edge, Safari)

Support

Need help or have questions?

Discord Community: https://discord.gg/YUxuTa4ZzX - Get help, report bugs, and discuss features

Credits

Created by Patrick Jr.

CurseForge: https://www.curseforge.com/members/patrickjr/projects