https://github.com/aetopia/igneous
A library for managing & interacting with Minecraft: Bedrock Edition.
https://github.com/aetopia/igneous
Last synced: 3 months ago
JSON representation
A library for managing & interacting with Minecraft: Bedrock Edition.
- Host: GitHub
- URL: https://github.com/aetopia/igneous
- Owner: Aetopia
- License: mit
- Created: 2025-05-04T18:42:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-21T12:10:09.000Z (about 1 year ago)
- Last Synced: 2025-06-11T11:41:42.028Z (12 months ago)
- Language: C
- Homepage:
- Size: 49.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Igneous
> [!CAUTION]
> **Only supported on Windows x64!**
Fixes various bugs related to Minecraft: Bedrock Edition (GDK).
## Fixes
|Issue|Summary|
|-|-|
|[MCPE-15796](https://bugs.mojang.com/browse/MCPE-15796)|Cursor is not recentered upon the opening of a new gui|
|[MCPE-98861](https://bugs.mojang.com/browse/MCPE-98861)|Significant input delay on devices with Render Dragon|
|[MCPE-110006](https://bugs.mojang.com/browse/MCPE-110006)|Vsync not being able to be turned off|
|[MCPE-166745](https://bugs.mojang.com/browse/MCPE-166745)|FPS is capped at double the screen's refresh rate when v-sync is disabled|
|[MCPE-230832](https://bugs.mojang.com/browse/MCPE-230832)|Mouse cursor moves in the background during gameplay, disrupting gameplay|
### Tweaks
- Cursor changes are disallowed to prevent a change from lingering.
- The game's window background is now black to prevent flashbangs.
- The game's window menu is now disabled preventing unwanted freezes.
- If locked, the cursor's position is updated when the game's window is moved.
## Usage
- [Download](https://github.com/Aetopia/Igneous/releases/latest/download/vcruntime140_1.dll) the latest release of Igneous.
- Run the following command in PowerShell to find where the game is located:
```powershell
& "$ENV:SystemRoot\explorer.exe" "$((Get-AppxPackage "Microsoft.MinecraftUWP").InstallLocation)"
```
- Place the dynamic link library in the opened folder & launch the game.
### Configuration
- Run the following command in PowerShell to find where the game is located:
```powershell
& "$ENV:SystemRoot\explorer.exe" "$((Get-AppxPackage "Microsoft.MinecraftUWP").InstallLocation)"
```
- Create a new file called `Igneous.cfg`, add the following contents & save the file to the game's install location:
```ini
[Igneous]
D3D11 = 0
Cursor = 1
Tearing = 1
```
- To enable a feature, set their value to `1`.
- To disable a feature, set their value to `0`.
|Name|Description|
|-|-|
|`D3D11`|Forces DirectX 11 to be used instead of DirectX 12.|
|`Cursor`|Fixes MCPE-15796, MCPE-230832 & improves cursor handling.|
|`Tearing`|Fixes MCPE-98861, MCPE-110006, MCPE-166745 & fixes V-Sync off.|
## FAQ
#### How can I disable V-Sync?
- Open the following file:
```cmd
%APPDATA%\Minecraft Bedrock\Users\*\games\com.mojang\minecraftpe\options.txt
```
- Set `gfx_vsync` to `0`, save the file & launch the game.
## Build
1. Install & update [MSYS2](https://www.msys2.org):
```bash
pacman -Syu --noconfirm
```
3. Install [GCC](https://gcc.gnu.org) & [MinHook](https://github.com/TsudaKageyu/minhook):
```bash
pacman -Syu mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-MinHook --noconfirm
```
3. Start MSYS2's `UCRT64` environment & run `Build.cmd`.