HYTOPIA World Editor - Desktop Releases

This repository contains the desktop application releases for the HYTOPIA World Editor.

📦 Download

Latest Release

Download the latest version from the Releases page.

Platform Downloads

• macOS: Universal binary (Intel + Apple Silicon)

  • .dmg installer (recommended)
  • .zip archive

• Windows:

  • .exe installer (x64 and ARM64)
  • .zip archive

• Linux:

  • .AppImage (portable, no installation)
  • .deb package (Debian/Ubuntu)

🚀 Installation

macOS

1. Download the .dmg file from the latest release
2. Open the downloaded .dmg file
3. Drag "HYTOPIA World Editor" to your Applications folder
4. Open from Applications (you may need to allow it in System Preferences → Security & Privacy)

Windows

1. Download the .exe installer from the latest release
2. Run the installer and follow the setup wizard
3. Launch "HYTOPIA World Editor" from the Start menu

Linux

AppImage:

1. Download the .AppImage file
2. Make it executable: chmod +x Hytopia-World-Editor-*.AppImage
3. Run: ./Hytopia-World-Editor-*.AppImage

Debian Package:

1. Download the .deb file
2. Install: sudo dpkg -i Hytopia-World-Editor-*.deb
3. Launch from your applications menu

✨ Features

The desktop app provides all the features of the web version with additional benefits:

• 🚀 Better Performance: Native GPU acceleration and optimized memory management
• 💻 Native Experience: Standalone window, system integration, and native controls
• 🔄 Auto-Updates: Automatically checks for new versions hourly
• 🌐 Offline Fallback: Works offline with local file fallback
• 🎮 Discord Integration: Discord Rich Presence support (when Discord is running)

Core Editor Features

• Intuitive 3D voxel building interface
• Block/GLTF placement and manipulation tools
• Custom texture support
• AI generation (textures & structures)
• Automatic terrain generation
• Minecraft 1.21 map conversion
• Persistent data storage
• Map import and export

🔄 Updates

The desktop app automatically checks for updates every hour. When a new version is available, you'll be notified and can choose to install it.

Manual Update Check:

• Restart the application to check immediately
• Or wait for the automatic hourly check

💻 System Requirements

• macOS: 10.13 (High Sierra) or later
• Windows: Windows 10 or later
• Linux: Modern distribution with GLIBC 2.28+
• RAM: 4GB minimum (8GB+ recommended)
• GPU: Hardware acceleration recommended
• Internet: Required for initial load (offline fallback available)

🌐 Web Version

Prefer using the web version? Visit https://build.hytopia.com

The desktop app loads from the live website by default, so you'll always have the latest features and updates automatically.

📝 Notes

• The desktop app prefers loading from the web version (https://build.hytopia.com) with automatic fallback to local files
• External links open in your default browser
• Your work is automatically saved locally
• Menu bar is hidden on Windows in production builds

🐛 Troubleshooting

App won't start

• Ensure your system meets the minimum requirements
• Try downloading the latest version
• Check for system updates

Can't connect to website

• The app will automatically fall back to local files after 8 seconds
• Check your internet connection
• Verify https://build.hytopia.com is accessible in your browser

Update not showing

• Restart the application to force an update check
• Verify you're connected to the internet
• Check the Releases page for the latest version

macOS: "App can't be opened because it is from an unidentified developer"

1. Go to System Preferences → Security & Privacy
2. Click "Open Anyway" next to the message about HYTOPIA World Editor
3. Or right-click the app → Open → Click "Open"

🔗 Links

• Web Editor: https://build.hytopia.com
• Source Code: https://github.com/hytopiagg/world-editor
• Report Issues: https://github.com/hytopiagg/world-editor/issues
• Discord Community: https://discord.gg/hytopia
• HYTOPIA Website: https://hytopia.com

📄 License

This desktop application is part of the HYTOPIA World Editor project. See the main repository for license information.

🙏 Support

For support, bug reports, or feature requests, please visit:

• GitHub Issues
• Discord Community

---

Note: This repository only contains release artifacts. For source code and development, see the main repository.