Documentation
Everything you need to know about using UnifiedHytale
Getting Started
Creating an Account
- Click "Sign Up" in the top right corner
- Enter your email, username, and password
- Verify your email address (check spam folder if needed)
- Complete your profile in Settings
💡 Tip: Choose a unique username - you can't change it later!
Browsing Projects
Use the Browse page to discover content:
- Filter by Type: Plugins, Data Packs, Asset Packs, Worlds, Prefabs, Modpacks
- Search: Find projects by name or description
- Sort: By newest, most downloads, most likes, or recently updated
- Categories: Filter by gameplay, aesthetic, technical, etc.
Downloading Content
- Navigate to any project page
- Review the description, requirements, and compatible Hytale versions
- Click the "Download" button for your desired version
- Follow installation instructions in the project description
- Check dependencies (some plugins require other plugins to work)
🔒 Security: All files are scanned for viruses before approval.
Profile Setup
Customize your profile in Settings:
- Avatar: Upload a profile picture (max 2MB)
- Bio: Tell others about yourself (supports markdown)
- Social Links: Connect your Discord, Twitter, GitHub, website
- Email Notifications: Configure what updates you receive
For Creators
Becoming a Creator
- Create and verify your account
- Go to your Dashboard
- Click "Become a Creator"
- Fill out the application form explaining your plans
- Wait for approval (usually 24-48 hours)
- You'll receive an email when approved!
⭐ Verified Creators: Build a reputation and get verified status after consistent quality uploads.
Uploading Projects
Follow these steps to upload your first project:
- From your Dashboard, click "New Project"
- Basic Info: Choose type, name, and summary
- Description: Write detailed info using markdown (see below)
- Media: Upload icon (256x256px) and banner (1920x1080px)
- Categories: Select 1-3 relevant categories
- Review: Check everything and submit
- Wait for moderation approval (24-48 hours)
Hytale Project Types
UnifiedHytale supports all Hytale modding formats:
Plugin
Server-side Java code with custom game logic
Max size: 200MB | Format: .jar, .zip
Data Pack
JSON configuration for blocks, items, NPCs, world gen
Max size: 50MB | Format: .zip
Asset Pack
Visual/audio content: models, textures, sounds
Max size: 100MB | Format: .zip
World
Complete playable world save files
Max size: 500MB | Format: .zip
Prefab
Single structures: houses, trees, landmarks
Max size: 50MB | Format: .zip
Modpack
Curated collection of plugins and packs
Max size: 500MB | Format: .zip
Markdown Guide
Project descriptions support full GitHub Flavored Markdown with live preview:
Headers
## Heading 2### Heading 3Text Formatting
**bold** *italic* ~~strikethrough~~Lists
- Bullet point1. Numbered listLinks
[Link text](https://example.com)Code
`inline code````java
code block
```Tables
| Column 1 | Column 2 ||----------|----------|| Data | Data |💡 Pro Tip: Use the preview tab while writing to see exactly how it will look!
Project Management
Editing Projects
You can edit most project details after upload:
- ✅ Can Edit: Name, summary, description, images, categories
- ❌ Cannot Edit: Project type, slug (URL)
- Changes are saved immediately
- Image updates may take a few minutes to propagate
Managing Versions
Keep your projects up to date with version management:
- Upload new versions for updates and bug fixes
- Use semantic versioning (1.0.0, 1.1.0, 2.0.0)
- Write detailed changelogs (supports markdown)
- Specify compatible Hytale game versions
- Set dependencies on other projects
- Users always see the latest version by default
Project Requirements
Text Requirements
- Name: 3-100 characters, must be unique
- Summary: 10-150 characters, appears in cards
- Description: Minimum 100 characters, supports markdown
Image Requirements
- Icon: Square (256x256px recommended), max 5MB, PNG/JPG/WebP
- Banner: Wide (1920x1080px recommended), max 5MB, PNG/JPG/WebP
- High quality images help attract more downloads!
File Requirements
- Must be properly packaged (.zip, .jar, .rar, .7z)
- Size limits vary by project type (see above)
- Include README or installation guide
- No malicious code or viruses
Accepted File Formats
Project Files
.zip, .rar, .7z, .jar
Images
.png, .jpg, .jpeg, .webp
Moderation & Safety
Moderation Queue
All uploads are reviewed before going live to ensure community safety:
- Virus Scanning: Automated checks for malware
- Content Review: Manual review of descriptions and files
- Guidelines Check: Compliance with community standards
- Copyright: No stolen or unauthorized content
Approval Process
Submission
Your project enters the moderation queue
Automated Checks
Virus scanning and basic validation
Manual Review
Staff reviews content and compliance (24-48 hours)
Decision
Project is approved or you receive feedback for changes
📧 You'll receive email notifications at each step.