Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/zardoy/minecraft-web-client/llms.txt

Use this file to discover all available pages before exploring further.

​
Start playing now

No downloads, no installation. Just open your browser and start playing.
1

Visit the web app

Open mcraft.fun in your browser.Works on:
  • Desktop browsers (Chrome, Firefox, Safari, Edge)
  • Mobile devices (iOS 14+, Android 13+)
  • Tablets
For the latest features (but potentially less stable), try beta.mcraft.fun
2

Choose your game mode

You have three options:

​
Singleplayer

Create a new world with simple generation or load an existing save.
Singleplayer uses a built-in JavaScript server. Full survival features are limited - see the Space Squid repo for supported features.

​
Multiplayer

Connect to any Java server running versions 1.8 through 1.21.5.You’ll need:
  • Server IP address
  • Server version
  • Optional: Custom proxy URL (built-in proxy provided)

​
Load a world file

Drag and drop a world file or folder:
  • Zip files: Stored entirely in RAM (300 MB limit on iOS)
  • Folders: Can be opened in read-write mode
  • Any version: All Minecraft versions supported
New chunks may generate incorrectly when opening existing worlds.
3

Start playing

Once you’re in the game, use these controls:

​
Desktop controls

  • WASD - Move forward/left/back/right
  • Space - Jump
  • Shift - Sneak
  • Mouse - Look around
  • Left click - Break blocks
  • Right click - Place blocks/interact
  • E - Open inventory
  • Escape - Pause menu
  • F3 - Debug overlay

​
Mobile controls

On mobile, you’ll want to enable joystick controls:
  1. Press Escape to open the menu
  2. Go to Settings → Controls
  3. Set Touch Controls Type to Joystick
Enable Auto Full Screen in Controls settings to avoid accidentally closing the tab.
For the best experience, configure these settings (press Escape → Settings):
  • Touch Controls Type → Joystick (mobile only)
  • Auto Full Screen → On (prevents ctrl+w tab closing)
  • Raw Input → On (more precise controls, already enabled by default)
  • Enable Minimap → Always (shows useful minimap)
  • Chat Select → On (select chat messages, already enabled by default)

​
Quick examples

​
Connect to a server

1

Select Multiplayer

Click Multiplayer on the main menu.
2

Enter server details

  • Server IP: e.g. play.hypixel.net
  • Version: e.g. 1.21.4
  • Username: Your desired username
  • Proxy: Leave as default or enter custom proxy URL
3

Connect

Click Join Server and wait for the connection.
For online mode servers (like Hypixel), you’ll need to authenticate with your Microsoft account.

​
Load a world from zip

1

Prepare your world

Find a Minecraft world save and compress it to a .zip file.The zip should contain:
  • level.dat
  • region/ folder with .mca files
2

Drag and drop

Simply drag the .zip file onto the browser window.
iOS has a ~300 MB file size limit for zip files loaded into memory.
3

Wait for loading

The world will be loaded into the integrated server and you’ll spawn in.

​
Load a folder (read-write mode)

1

Select folder

Drag a world folder onto the browser window.
2

Grant permissions

Your browser will ask for read-write permissions to the folder.
3

Play and save

Changes you make will be saved back to the folder.
Use /export command to export the world as a zip file at any time.

​
Console access (mobile)

On mobile devices, you can access the browser console for advanced settings:
  1. Add #dev to the browser URL (page won’t reload)
  2. Tap the console button that appears
  3. Access advanced settings with options.<setting_name> = <value>
Type options in the console to see all available settings.

​
Export your world

Whatever mode you used (zip, folder, singleplayer), you can always export: 
/export
Type this command in the game chat to download your world as a zip file.

​
Query parameters

You can use URL parameters to customize behavior:

​
Auto-connect to a server

https://mcraft.fun/?ip=play.hypixel.net&version=1.21.4&username=Steve

​
Load a specific world

https://mcraft.fun/?singleplayer=1&version=1.19.4

​
Load world from URL

https://mcraft.fun/?map=https://example.com/world.zip
See the query parameters reference for all available options.

​
Troubleshooting

  • Check the server version matches what you specified
  • Try the built-in proxy (default)
  • Verify the server IP is correct
  • Some servers may block VPN/proxy connections
  • Click on the game window to capture mouse input
  • On mobile, enable joystick controls in settings
  • Check browser permissions for pointer lock
  • Reduce render distance in settings
  • Close other browser tabs
  • Ensure hardware acceleration is enabled in browser settings
  • Try Chrome for best performance
  • Check file size (iOS has 300 MB limit for zips)
  • Verify world format is correct (Java Edition only)
  • Try loading in a folder instead of zip
  • Check browser console for errors (F12)

​
Next steps

Singleplayer guide

Learn about world generation and management

Multiplayer guide

Advanced server connection options

Controls reference

Complete keybindings and control options

Mobile & touch

Optimize for mobile devices

Build docs developers (and LLMs) love

Get started for freeTalk to us