README.md

Caution

Only supported on Windows x64!

Stonecutter

Fixes various bugs related to Minecraft: Bedrock Edition.

Fixes

• MCPE-98861

• MCPE-109879

• MCPE-15796

Usage

• Download the latest release from:

  • GitHub Releases

    • Extract & run Stonecutter.exe.

  • Scoop

    scoop bucket add games
    scoop install stonecutter
    

    • Run Stonecutter from the Windows Start Menu.

• Stonecutter will launch and patch Minecraft: Bedrock Edition.

FAQ

How can I disable V-Sync?

• Open the following file:

  %LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftpe\options.txt
  

• Set gfx_vsync to 0.

• Save the file.

• Launch Minecraft: Bedrock Edition via Stonecutter.

How can I force DirectX 11?

• Create the following file:

  %LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\RoamingState\Stonecutter.ini
  

• Add the following contents:

  [Stonecutter]
  Force = 1

• Save the file.

• Launch Minecraft: Bedrock Edition via Stonecutter.

How can I disable Cursor Centering?

• Create the following file:

  %LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\RoamingState\Stonecutter.ini
  

• Add the following contents:

  [Stonecutter]
  Cursor = 0

• Save the file.

• Launch Minecraft: Bedrock Edition via Stonecutter.

How can I use Minecraft's URI Protocol?

• Find where Stonecutter's executable is located.

• Open Command Prompt, PowerShell or create a shortcut to Stonecutter's executable.

• Specify the URI protocol to be used:

  Stonecutter.exe minecraft:?Editor=true

• Run Stonecutter with the specified URI protocol.

Building

1. Install MSYS2 & UPX for optional compression.

2. Update the MSYS2 Environment until there are no pending updates using:

   pacman -Syu --noconfirm

3. Install GCC & MinHook using:

   pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-MinHook --noconfirm

4. Make sure <MSYS2 Installation Directory>\ucrt64\bin is added to the Windows PATH environment variable.

5. Run Build.cmd.