Setting Up Your Development Environment

This guide will walk you through setting up a complete development environment for Hytale modding, including all necessary tools and dependencies.

Prerequisites

Before we begin, make sure you have:

• A computer running Windows 10/11, macOS, or Linux
• At least 8GB of RAM
• 10GB of free disk space
• Administrative privileges on your system

Required Software

1. Java Development Kit (JDK)

Hytale modding requires Java 25 or later. We recommend using OpenJDK.

Windows

1. Download OpenJDK 25 from Adoptium
2. Run the installer with default settings
3. Verify installation by opening Command Prompt and running:

java -version

macOS

# Using Homebrew
brew install openjdk@25

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install openjdk-25-jdk

2. Integrated Development Environment (IDE)

We recommend IntelliJ IDEA Community Edition for Hytale modding.

1. Download from JetBrains website
2. Install with default settings
3. Launch and complete the initial setup wizard

3. Git Version Control

Windows

Download Git from git-scm.com and install with default settings.

macOS

# Using Homebrew
brew install git

Linux

# Ubuntu/Debian
sudo apt install git

# Fedora/CentOS
sudo dnf install git

Verify installation:

git --version

Setting Up Your Workspace

1. Clone the Plugin Template

Instead of creating an empty directory, we'll use the official Hytale plugin template:

# Clone the template repository
git clone https://github.com/HytaleModding/plugin-template.git MyFirstMod
cd MyFirstMod

2. Configure the Project

Remove the existing Git history and initialize your own:

# Remove the template's Git history
rm -rf .git

# Initialize a new Git repository
git init
git add .
git commit -m "Initial commit from plugin template"

3. Configure Git Identity

Set up your Git identity for future commits:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

4. Open in IntelliJ IDEA

1. Open IntelliJ IDEA
2. Click "Open" and navigate to your MyFirstMod directory
3. IntelliJ will automatically detect it as a Gradle project
4. Wait for the project to index and dependencies to download

Next Steps

Now that you have your development environment set up with the plugin template:

1. Customize the template - Edit the pom.xml and manifest.json file to change your mod's name and details
2. Explore the code structure - Familiarize yourself with the template's organization
3. Start modding - Begin writing your first Hytale plugin!

The plugin template includes:

• Pre-configured Gradle build system
• Example plugin structure
• Essential dependencies
• Development tools configuration