Quick start

Installation

Download for Windows.exe · Windows 10 or newer

Windows only: macOS and Linux are not planned any time soon

1. Download the installer with the button above
2. Run the downloaded installer
3. Follow the installer's instructions

There are no macOS or Linux builds, and none are planned any time soon.

First launch

1. Create an instance

   • The "Create" button in the sidebar
   • Choose a Minecraft version (for example, 1.20.1)
   • Choose a loader (Forge/Fabric/NeoForge/Quilt)
   • Click "Create"

2. Installation takes 1-3 minutes

   • Java is downloaded automatically
   • Minecraft is installed from official sources
   • The loader is installed (Forge can take ~2 min)

3. Start the game

   • Click "Play" on the instance card
   • The first launch takes ~30 seconds (resource generation)

Adding mods

From the catalog

1. Open the instance
2. The "Mods" tab
3. The "Catalog" button
4. Find the mod you need
5. Click "Install"

Stuzhik automatically:

• Checks compatibility with the MC version
• Warns you about conflicts with installed mods
• Installs missing dependencies

From a file

1. Drag the .jar file into the mods folder
2. Or use the "Add local mod" button

Log Analyzer

When the game crashes:

1. The launcher opens the analyzer automatically
2. You'll see a list of the problems it found
3. Possible solutions for each problem
4. The "Apply" button for an automatic fix (where possible)

Keyboard shortcuts

Action	Key
Create instance	Ctrl+N
Settings	Ctrl+,
Search	Ctrl+F
Developer Console	Ctrl+Shift+D

What's next?

• Managing mods
• Modpacks
• Mod Collections
• Stuzhik Connect — modpack transfer between friends
• Log Analyzer
• FAQ