Oh My Minecraft Client

The project will be maintained in this repository until plusls back.

English | 中文

Make Minecraft Client Great Again!

The default hotkey to open the in-game config GUI is O + C.

❗Before reporting a problem, be sure to try the latest beta version to check if the problem still exists.

Dependencies

Dependency	Download
Fabric API	CurseForge | GitHub | Modrinth
MagicLib	CurseForge | GitHub | Modrinth
MaliLib	CurseForge | Masa WebSite

Generic

clearWaypoint

A hotkey to clear highlight waypoint.

• Category: Generic
• Type: hotkey
• Default value: C

debug

Display debug message

• Category: Generic
• Type: boolean
• Default value: false

dontClearChatHistory

Don't clear chat history and input history.

• Category: Generic
• Type: boolean
• Default value: false

forceParseWaypointFromChat

Force parse waypoint from chat (such it will override the clickevent of rtext).

• Category: Generic
• Type: boolean with hotkey
• Default value: false, no hotkey

openConfigGui

A hotkey to open the in-game Config GUI

• Category: Generic
• Type: hotkey
• Default value: O,C

parseWaypointFromChat

Parse waypoint from chat.

• Category: Generic
• Type: boolean with hotkey
• Default value: true, no hotkey

sendLookingAtPos

A hotkey to send looking at pos.

• Category: Generic
• Type: hotkey
• Default value: O,P

sortInventory

A hotkey to sort inventory.

• Category: Generic
• Type: hotkey
• Default value: R

sortInventoryShulkerBoxLast

Sort inventory shulker box last.

• Category: Generic
• Type: enum
• Default value: AUTO
• Option values: AUTO, FALSE, TRUE

sortInventorySupportEmptyShulkerBoxStack

Support empty shulker box stack when sort inventory.

• Category: Generic
• Type: boolean with hotkey
• Default value: false, no hotkey

Feature Toggles

autoSwitchElytra

Auto switch elytra and chestplate.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

betterSneaking

Player can move down 1 height when sneaking.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

disableBlocklistCheck

Workaround for MC-218167, prevent network request from blocking the Render Thread.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey
• Dependencies:
  • And (All conditions need to be satisfied):
    • minecraft: >1.15.2

disableBreakBlock

You can't break blocks in breakBlockBlackList.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

disableBreakScaffolding

You can only break scaffolding with the items in breakScaffoldingWhiteList.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

disableMoveDownInScaffolding

You can only move down scaffolding with the items inside moveDownInScaffoldingWhiteList in your hand.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

disablePistonPushEntity

Prevent piston push entities (except the player) to reduce piston lag (such as the carpet duper), it will cause entities pos error when entity push by piston.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

flatDigger

Which allowed you mine a flat road while digging stone by preventing digging of blocks under your feet while standing，sneak to dig blocks under you.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

forceBreakingCooldown

You will have 5gt cooldown after instant breaking.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

highlightLavaSource

Highlight lava sources.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

We have also provided some optional resource packs for this purpose.

• ommc-highlightLavaSource[32x](static) by Hendrix-Shen.
• ommc-highlightLavaSource[32x](dynamic) by Hendrix-Shen.
• ommc-xk(32x) by SunnySlopes.
• ommc-faithful(static) by SunnySlopes.
• ommc-faithful(dynamic) by SunnySlopes.

highlightPersistentMob

Highlight persistent mobs (Mob have item in hand or mob have custom name).

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

highlightPersistentMobClientMode

Use client data to check persistent mob, such as hand item, custom name. Tips: in local game should disable this option, in server also can use syncAllEntityData in MasaGadget to sync entity data to local.

• Category: Feature Toggles
• Type: boolean
• Default value: false

preventIntentionalGameDesign

Prevent Intentional Game Design (Bed and Respawn Anchor).

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

preventWastageOfWater

Prevent water bucket from vanishing in nether.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

realSneaking

You cannot ascend or descend non-full blocks when sneaking, e.g. carpets.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

removeBreakingCooldown

Remove cooldown after break block (default is 5gt), it will not work when enable forceBreakingCooldown.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

worldEaterMineHelper

When the blocks in worldEaterMineHelperWhitelistr are exposed to the air, the game will render a mirror image above them, which is convenient for world eater maintenance and mining.

• Category: Feature Toggles
• Type: boolean with hotkey
• Default value: false, no hotkey

List

blockModelNoOffsetBlacklist

blockModelNoOffsetBlacklist

• Category: Lists
• Type: string list
• Default value: []

blockModelNoOffsetListType

blockModelNoOffsetListType

• Category: Lists
• Type: enum
• Default value: WHITELIST
• Option values: WHITELIST, NONE, BLACKLIST

blockModelNoOffsetWhitelist

blockModelNoOffsetWhitelist

• Category: Lists
• Type: string list
• Default value: [minecraft:wither_rose, minecraft:poppy, minecraft:dandelion]

breakBlockBlackList

If disableBreakScaffolding is enabled, you can't break blocks in breakBlockBlackList.

• Category: Lists
• Type: string list
• Default value: [minecraft:budding_amethyst, _bud]

breakScaffoldingWhiteList

If disableBreakScaffolding is enabled, you can only break scaffolding with the items in breakScaffoldingWhiteList.

• Category: Lists
• Type: string list
• Default value: [minecraft:air, minecraft:scaffolding]

highlightEntityBlackList

highlightEntityBlackList

• Category: Lists
• Type: string list
• Default value: []

highlightEntityListType

highlightEntityListType

• Category: Lists
• Type: enum
• Default value: WHITELIST
• Option values: WHITELIST, NONE, BLACKLIST

highlightEntityWhiteList

highlightEntityWhiteList

• Category: Lists
• Type: string list
• Default value: [minecraft:wandering_trader]

moveDownInScaffoldingWhiteList

If disableMoveDownInScaffolding is enabled, you can only move down scaffolding with the items inside moveDownInScaffoldingWhiteList in your hand.

• Category: Lists
• Type: string list
• Default value: [minecraft:air, minecraft:scaffolding]

worldEaterMineHelperWhitelist

If worldEaterMineHelper is enabled, when the blocks in worldEaterMineHelperWhitelist are exposed to the air, the game will render a mirror image above them, which is convenient for world eater maintenance and mining.

• Category: Lists
• Type: string list
• Default value: [_ore, minecraft:ancient_debris, minecraft:obsidian]

Advanced Integrated Server

flight

Integrated server enable flight.

• Category: Advanced Integrated Server
• Type: boolean
• Default value: true

onlineMode

Integrated server use online mode.

• Category: Advanced Integrated Server
• Type: boolean with hotkey
• Default value: true, no hotkey

port

Integrated server lan port, 0 to use default port.

• Category: Advanced Integrated Server
• Type: integer
• Default value: 0
• Min value: 0
• Max value: 65535
• Dependencies:
  • Not (Any condition needs to be excluded):
    • minecraft: <1.19.3

pvp

Integrated server enable pvp.

• Category: Advanced Integrated Server
• Type: boolean
• Default value: true

Development

Support

Current main development for Minecraft version: 1.20.4

And use preprocess to be compatible with all versions.

Note: We only accept the following versions of issues. Please note that this information is time-sensitive and any version of the issue not listed here will be closed

• Minecraft 1.14.4
• Minecraft 1.15.2
• Minecraft 1.16.5
• Minecraft 1.17.1
• Minecraft 1.18.2
• Minecraft 1.19.2 (Ending support soon)
• Minecraft 1.19.3 (Ending support soon)
• Minecraft 1.19.4
• Minecraft 1.20.1 (Ending support soon)
• Minecraft 1.20.2 (Ending support soon)
• Minecraft 1.20.4

Mappings

We are using the Mojang official mappings to de-obfuscate Minecraft and insert patches.

Document

The English doc and the Chinese doc are aligned line by line.

License

This project is available under the LGPL-3.0 license. Feel free to learn from it and incorporate it in your own projects.

Credit

• Thanks to XeKr for the lava eye protection texture.
• Thanks to NextPage for providing the English translation, lava source texture modification and testing work.
• Thanks to 水星嗷 for providing the idea of highlighting ores and resourcepack.
• Thanks to voxelmap for providing the code of highlight waypoint.
• Thanks to Hendrix-Shen for providing highlightLavaSource x32 resource pack.
• Thanks to SunnySlopes for providing highlightLavaSource x32 resource pack.