Minecraft:Options.txt (Java Edition)
From SAS Gaming Wiki
More actions
Template:Exclusive
options.txt is the file that stores all the options changeable in the in-game Minecraft:options menu and various other information the game needs to store after quitting. It is found in the Minecraft:.minecraft folder, and can be edited with any basic text editor to change options. Most settings can be changed in-game, but a few can be changed only by editing this file. The options.txt file for the latest version of the game is not backward-compatible with older versions of the game, and if older versions are played in the same directory as a newer version, options.txt can be reset back to its default settings.
Options
| Option name | Explanation | Valid values | Default value | Development version addedTemplate:Note | Version added |
|---|---|---|---|---|---|
| version | Minecraft:Data version of the client that last saved the file. It is used to update old settings. If missing, the file is replaced with the default settings. | Integer | Template:Data version (for latest release Template:V) |
1.10-pre1 | 1.10 |
| ao | Whether smooth lighting is enabled | true/false | true | ||
| biomeBlendRadius | Radius for which biome blending should happen | 0–7 | 2 | 18w15a | 1.13 |
| chunkSectionFadeInTime | Time it takes for chunks to fade in | 0–2 | 0.75 | 25w44a | 1.21.11 |
| cutoutLeaves | Whether Minecraft:leaves are see-through | true/false | true | 25w44a | 1.21.11 |
| enableVsync | Whether v-sync (vertical synchronization) is enabled | true/false | true | 1.3.1 | |
| entityDistanceScaling | The maximum distance from the player that entities render | 0.5–5.0 | 1.0 | 20w17a | 1.16 |
| entityShadows | Whether to display entity shadows | true/false | true | 1.8.1-pre4 | 1.8.1 |
| forceUnicodeFont | Whether Unicode font should be used | true/false | false | 13w42b | 1.7.2 |
| japaneseGlyphVariants | Uses Japanese variants of CJK (Chinese, Japanese, and Korean) characters in the default font | true/false | false | 24w06a | 1.20.5 |
| fov | The field of view in degrees | 30–110 | 70 | ||
| fovEffectScale | How much the field of view changes while sprinting or while affected by Minecraft:Speed or Minecraft:Slowness | 0–1 | 1.0 | 1.16.2-pre1 | 1.16.2 |
| darknessEffectScale | How much the Minecraft:Darkness effect pulses | 0–1 | 1.0 | 22w15a | 1.19 |
| glintSpeed | The speed of visual Minecraft:glint on enchanted items | 0–1 | 0.5 | 23w05a | 1.19.4 |
| glintStrength | The strength of visual Minecraft:glint on enchanted items | 0–1 | 0.75 | 23w05a | 1.19.4 |
| preferredGraphicsBackend | The graphics backend used for rendering | default/opengl/vulkan | default | 26.2-snapshot-1 | 26.2 |
| graphicsPreset | The graphics preset used in the video settings screen | fast/fancy/fabulous/custom | fancy | 25w41a | 1.21.11 |
| prioritizeChunkUpdates | Chunk section update strategy | 0–2 (Threaded, Semi Blocking, Fully Blocking) | 0 (Threaded) | 21w37a | 1.18 |
| fullscreen | Whether the game attempts to go fullscreen at startup | true/false | false | 1.3.1 | |
| exclusiveFullscreen | Whether fullscreen mode should take full control of a monitor | true/false | false | 26.1-pre-2 | 26.1 |
| macFullscreenMenuVisibility | Whether moving the pointer to the edge of the screen shows the menu bar and Dock while fullscreen on macOS | true/false | false | 26.3-pre-1 | 26.3 |
| Template:Anchor gamma | Brightness | 0–1 (Note: values below 0 and above 1 are invalid and inaccessible on vanilla, even via editing the options.txt file.<ref>Template:Bug</ref>) | 0.5 | ||
| guiScale | Size of interfaces | 0 (Auto) or 1+ for size. Upper limit based on window resolution. | 0 (Auto) | ||
| debugGuiScale | Size of the Minecraft:debug screen | -1 (Same as guiScale), 0 (Auto), or 1+ for size. Upper limit based on window resolution. | 0 (Auto) | 26.3-snapshot-4 | 26.3 |
| maxAnisotropyBit | The amount of anisotropic filtering | 1–3 (2×, 4×, 8×) | 2 (4×) | 25w44a | 1.21.11 |
| textureFiltering | Texture filtering mode | 0–2 (None, RGSS, Anisotropic) | 0 (None) | 1.21.11-pre1 | 1.21.11 |
| maxFps | The maximum framerate | 10–260 | 120 | 13w38a | 1.7.2 |
| improvedTransparency | Whether to use an order-independent transparency algorithm to render translucent objects. | true/false | false | 25w41a | 1.21.11 |
| inactivityFpsLimit | When to limit the frame rate: while the player is inactive or while Minecraft is minimized | afk/minimized | afk | 24w33a | 1.21.2 |
| mipmapLevels | Amount by which distant textures are smoothed | 0–4 | 4 | 13w38a | 1.7.2 |
| narrator | Setting of the Narrator | 0–3 (Off, Narrates All, Narrates Chat, Narrates System) | 0 (Off) | 17w06a | 1.12 |
| particles | Amount of particles, such as rain and potion effects | 0–2 (All, Decreased, Minimal) | 0 (All) | ||
| reducedDebugInfo | Whether to show reduced information on the Minecraft:Debug screen | true/false | false | 14w29a | 1.8 |
| renderClouds | Whether to display Minecraft:clouds | false/fast/true | true | 14w25a | 1.8 |
| cloudRange | The render distance of clouds, in chunks from the player | 2–128 | 128 | 25w17a | 1.21.6 |
| renderDistance | The render distance in the chunk radius from the player | 2–32 without external editing of options.txt; maximum is further limited to 16 on machines with less than 1 gigabyte of memory | 12 (64-bit) | 13w38a | 1.7.2 |
| simulationDistance | The Minecraft:simulation distance in the chunk radius from the player | 5–32 without external editing of options.txt; maximum is further limited to 16 on machines with less than 1 gigabyte of memory | 12 | 21w38a | 1.18 |
| screenEffectScale | Intensity of distortion effects from Minecraft:Nausea and Minecraft:nether portals | 0–1 | 1.0 | 1.16.2-pre1 | 1.16.2 |
| soundDevice | Sound device to be used | String | 21w37a | 1.18 | |
| vignette | Whether to show the vignette | true/false | true | 25w41a | 1.21.11 |
| weatherRadius | The distance in blocks from the player where rain and snow effects are visible | 3–10 | 10 | 25w41a | 1.21.11 |
| autoJump | Whether auto-jump is enabled | true/false | false | 16w20a | 1.10 |
| rotateWithMinecart | Whether the player's direction changes with the direction of the Minecraft:minecart they are riding | true/false | false | 24w33a | 1.21.2 |
| operatorItemsTab | Whether the player has access to the "Operator Utilities" tab in the Minecraft:Creative inventory | true/false | false | 22w45a | 1.19.3 |
| autoSuggestions | Whether command suggestions appear automatically instead of only after pressing Template:Key | true/false | true | 17w47a | 1.13 |
| chatColors | Whether colored chat is allowed | true/false | true | 1.3.1 | |
| chatLinks | Whether links in chat are displayed as links rather than plain text | true/false | true | 1.3.1 | |
| chatLinksPrompt | Whether clicking on links in chat needs confirmation before opening them | true/false | true | 1.3.1 | |
| discrete_mouse_scroll | Whether operating-system scroll settings are ignored | true/false | false | 1.14 Pre-Release 2 | 1.14 |
| invertXMouse | Whether mouse is inverted horizontally | true/false | false | 25w31a | 1.21.9 |
| invertYMouse | Whether mouse is inverted vertically | true/false | false | ||
| realmsNotifications | Whether Realms invites are alerted on the main menu | true/false | true | 1.8.9 | |
| showSubtitles | Whether Minecraft:subtitles are shown | true/false | false | 15w43b | 1.9 |
| directionalAudio | Whether directional audio is enabled | true/false | false | 22w11a | 1.19 |
| bobView | Whether the camera bobs up and down as the player walks | true/false | true | ||
| toggleCrouch | Whether sneaking is toggled instead of held | true/false | false | 19w41a | 1.15 |
| toggleSprint | Whether sprinting is toggled instead of held | true/false | false | 19w41a | 1.15 |
| toggleAttack | Whether attacking and destroying are toggled instead of held | true/false | false | 25w31a | 1.21.9 |
| toggleUse | Whether using items and placing blocks are toggled instead of held | true/false | false | 25w31a | 1.21.9 |
| sprintWindow | Time window in ticks where double-tapping the forward key activates sprint | 0–10 | 7 | 25w31a | 1.21.9 |
| darkMojangStudiosBackground | Whether the Mojang Studios loading screen appears monochrome | true/false | false | 21w13a | 1.17 |
| hideLightningFlashes | Whether lightning flashes are hidden | true/false | false | 21w37a | 1.18 |
| hideSplashTexts | Whether Minecraft:splash texts are shown on the Minecraft:title screen | true/false | false | 23w42a | 1.20.3 |
| mouseSensitivity | How much a mouse movement changes the position of the camera | 0–1 | 0.5 | ||
| damageTiltStrength | The amount of camera shake when the player is hurt | 0–1 | 1.0 | 23w06a | 1.19.4 |
| highContrast | Whether UI elements use higher contrast | true/false | false | 1.19.4-pre1 | 1.19.4 |
| highContrastBlockOutline | Whether targeted Minecraft:block outlines are easier to see | true/false | false | 24w40a | 1.21.2 |
| narratorHotkey | Whether Template:Key can turn on the narrator | true/false | true | 23w33a | 1.20.2 |
| resourcePacks | A list of active resource packs, with pack names in quotation marks and separated by commas | List of strings | [] | 13w36a | 1.7.2 |
| incompatibleResourcePacks | A list of active resource packs marked as incompatible with the current Minecraft version, with pack names in quotation marks and separated by commas | List of strings | [] | 1.8.8 | |
| lastServer | The address of the last server used with Direct Connection | String | |||
| lang | The language used | String | en_us | 1.1 | |
| chatVisibility | Which messages are shown in chat | 0–2 (Shown, Commands only, Hidden) | 0 (Shown) | 1.3.1 | |
| chatOpacity | Opacity of the chat | 0–1 | 1.0 | 1.3.1 | |
| chatLineSpacing | Spacing between text in chat | 0–1 | 0.0 | 20w15a | 1.16 |
| textBackgroundOpacity | Opacity of text background | 0–1 | 0.5 | 19w11a | 1.14 |
| backgroundForChatOnly | Whether text backgrounds are shown only in chat rather than behind all text | true/false | true | 19w11a | 1.14 |
| hideServerAddress | Has no effect in modern versions | true/false | false | 1.3.2 | |
| advancedItemTooltips | Whether hovering over an item in the Minecraft:inventory shows its ID and durability. Toggled by pressing Template:Key. | true/false | false | 1.4.2 | |
| pauseOnLostFocus | Whether switching away from Minecraft automatically pauses the game. Toggled by pressing Template:Key. | true/false | true | 12w34a | 1.4.2 |
| overrideWidth | Initial window width in pixels. A value of 0 uses the default. No in-game control. | Integer | 0 | 1.4.6 | |
| overrideHeight | Initial window height in pixels. A value of 0 uses the default. No in-game control. | Integer | 0 | 1.4.6 | |
| chatHeightFocused | How tall the chat span is | 0–1 | 1.0 | 1.5.1 | |
| chatDelay | Delay between chat messages | 0–6 | 0.0 | 20w15a | 1.16 |
| chatHeightUnfocused | Maximum height of chat when it is not focused | 0–1 | 0.4375 | 1.5.1 | |
| chatScale | The size of text in chat | 0–1 | 1.0 | 1.5.1 | |
| chatWidth | The span width of the chat | 0–1 | 1.0 | 1.5.1 | |
| notificationDisplayTime | How long Minecraft:toast notifications remain on screen | 0–10 | 1.0 | 23w03a | 1.19.4 |
| useNativeTransport | Whether Netty uses EpollSocketChannel instead of NioSocketChannel when EPOLL is available | true/false | true | 1.8.1-pre1 | 1.8.1 |
| mainHand | Which hand is the main hand | left/right | right | 15w31a | 1.9 |
| attackIndicator | Where the attack indicator is shown on screen | 0–2 (Off, Crosshair, Hotbar) | 1 (Crosshair) | 15w34b | 1.9 |
| tutorialStep | Next stage of Minecraft:tutorial hints to display | movement, find_tree, punch_tree, open_inventory, craft_planks, none | movement | 17w06a | 1.12 |
| mouseWheelSensitivity | Sensitivity of Template:Mouse input (see Template:Bug) | 1–10 | 1.0 | 18w21a | 1.13 |
| allowCursorChanges | Whether the cursor changes shape when hovering over certain UI elements | true/false | true | 25w35a | 1.21.9 |
| quitShortcuts | Whether shortcuts such as Template:Key on Windows and Linux or Template:Key on macOS will close the game. | true/false | true | 26.3-snapshot-6 | 26.3 |
| ctrlClickEmulatesRightClick | Whether Template:KeyTemplate:Mouse acts as Template:Mouse on macOS | true/false | false | 26.3-snapshot-9 | 26.3 |
| glDebugVerbosity | LWJGL log info level (only on some machines) | 0–4 (None, High, Medium, Low, Notification) | 1 | 1.13-pre2 | 1.13 |
| skipMultiplayerWarning | Whether to skip the legal disclaimer when entering the multiplayer screen | true/false | false | 1.15.2-pre1 | 1.15.2 |
| hideMatchedNames | Some servers send chat messages in non-standard formats. With this option on, the game attempts to apply chat hiding anyway by matching the text in messages. | true/false | true | 1.16.4-rc1 | 1.16.4 |
| joinedFirstServer | Whether the player has joined a Minecraft:server before. If false, the Minecraft:Social interactions Minecraft:tutorial hint appears when joining a server. | true/false | false | 1.16.4-pre1 | 1.16.4 |
| syncChunkWrites | Whether to open region files in synchronous mode | true/false | true (Windows), false (other systems) | 1.16-pre3 | 1.16 |
| showAutosaveIndicator | Whether to show the Minecraft:autosave indicator in the bottom-right corner of the screen | true/false | true | 21w42a | 1.18 |
| allowServerListing | Whether to allow the player's ID to be shown in the player list on the multiplayer screen | true/false | true | 1.18-pre2 | 1.18 |
| inGameNotification | Whether to show an in-game notification for the friends list | true/false | false | 26.2-snapshot-7 | 26.2 |
| sharePresence | Amount of presence to share to friends on the friends list | all/limited/none | all | 26.2-snapshot-7 | 26.2 |
| onlyShowSecureChat | Whether chat displays only cryptographically signed player messages | true/false | false | 1.19-pre1 | 1.19 |
| saveChatDrafts | Whether chat drafts are saved when chat is closed | true/false | false | 25w33a | 1.21.9 |
| panoramaScrollSpeed | Changes the scrolling speed of the Minecraft:panorama in the main menu | 0–1 | 1.0 | 22w42a | 1.19.3 |
| telemetryOptInExtra | Whether extended Minecraft:telemetry data is sent | true/false | false | 22w46a | 1.19.3 |
| onboardAccessibility | Whether the narrator welcome screen appears after the first launch | true/false | true | 23w03a | 1.19.4 |
| menuBackgroundBlurriness | Changes the blurriness of the menu background | 0–10 | 5 | 24w09a | 1.20.5 |
| startedCleanly | Records whether the previous startup completed successfully. A failed startup can cause the game to select another graphics backend. | true/false | true | 25w02a | 1.21.5 |
| musicToast | Where to show the music toast | never/pause/pause_and_toast | never | 25w46a | 1.21.11 |
| musicFrequency | Frequency of music | DEFAULT/FREQUENT/CONSTANT | DEFAULT | 25w20a | 1.21.6 |
| key_key.attack | Attack control | Minecraft:Key codes | key.mouse.left | ||
| key_key.use | Use Item control | Minecraft:Key codes | key.mouse.right | ||
| key_key.forward | Forward control | Minecraft:Key codes | key.keyboard.w | ||
| key_key.left | Left control | Minecraft:Key codes | key.keyboard.a | ||
| key_key.back | Back control | Minecraft:Key codes | key.keyboard.s | ||
| key_key.right | Right control | Minecraft:Key codes | key.keyboard.d | ||
| key_key.jump | Jump control | Minecraft:Key codes | key.keyboard.space | ||
| key_key.sneak | Sneak control | Minecraft:Key codes | key.keyboard.left.shift | ||
| key_key.sprint | Sprint control | Minecraft:Key codes | key.keyboard.left.control | 13w36a | 1.7.2 |
| key_key.drop | Drop control | Minecraft:Key codes | key.keyboard.q | ||
| key_key.inventory | Inventory control | Minecraft:Key codes | key.keyboard.e | ||
| key_key.chat | Chat control | Minecraft:Key codes | key.keyboard.t | ||
| key_key.playerlist | List Players control | Minecraft:Key codes | key.keyboard.tab | ||
| key_key.pickItem | Pick Block control | Minecraft:Key codes | key.mouse.middle | ||
| key_key.command | Command control | Minecraft:Key codes | key.keyboard.slash | 1.3.1 | |
| key_key.friends | Friends control | Minecraft:Key codes | key.keyboard.o | 26.2-snapshot-7 | 26.2 |
| key_key.socialInteractionsTemplate:Until | Social Interaction control | Minecraft:Key codes | key.keyboard.p | 1.16.4-pre1 | 1.16.4 |
| key_key.otherPlayersTemplate:Upcoming | Other Players control | Minecraft:Key codes | key.keyboard.p | 26.4-snapshot-3 | 26.4 |
| key_key.toggleGui | HUD toggle control | Minecraft:Key codes | key.keyboard.f1 | 25w41a | 1.21.11 |
| key_key.toggleSpectatorShaderEffects | Spectator shader effect toggle control | Minecraft:Key codes | key.keyboard.f4 | 25w41a | 1.21.11 |
| key_key.screenshot | Screenshot control | Minecraft:Key codes | key.keyboard.f2 | 13w36a | 1.7.2 |
| key_key.togglePerspective | Perspective control | Minecraft:Key codes | key.keyboard.f5 | 13w36a | 1.7.2 |
| key_key.smoothCamera | Mouse Smoothing control | Minecraft:Key codes | key.keyboard.unknown | 13w36a | 1.7.2 |
| key_key.fullscreen | Fullscreen control | Minecraft:Key codes | key.keyboard.f11 | 13w48a | 1.7.4 |
| key_key.spectatorOutlines | Visibility of player outlines in Spectator Mode control | Minecraft:Key codes | key.keyboard.unknown | 14w06a | 1.8 |
| key_key.spectatorHotbar | Show hotbar in Spectator Mode control | Minecraft:Key codes | key.mouse.middle | 25w36a | 1.21.9 |
| key_key.swapOffhand | Swapping of items between both hands control | Minecraft:Key codes | key.keyboard.f | 1.16-pre3 | 1.16 |
| key_key.saveToolbarActivator | Save current toolbar to a Minecraft:Saved Hotbars slot (in Creative Mode) | Minecraft:Key codes | key.keyboard.c | 17w06a | 1.12 |
| key_key.loadToolbarActivator | Load toolbar from a Minecraft:Saved Hotbars slot (in Creative Mode) | Minecraft:Key codes | key.keyboard.x | 17w06a | 1.12 |
| key_key.advancements | Open the Minecraft:Advancements screen | Minecraft:Key codes | key.keyboard.l | 17w06a | 1.12 |
| key_key.quickActions | Open the quick actions dialog control | Minecraft:Key codes | key.keyboard.g | 1.21.6-pre1 | 1.21.6 |
| key_key.debug.overlay | Open the debug overlay control | Minecraft:Key codes | key.keyboard.f3 | 25w41a | 1.21.11 |
| key_key.debug.modifier | Debug modifier control | Minecraft:Key codes | key.keyboard.f3 | 25w41a | 1.21.11 |
| key_key.hotbar.1 | Hotbar Slot 1 control | Minecraft:Key codes | key.keyboard.1 | 13w36a | 1.7.2 |
| key_key.hotbar.2 | Hotbar Slot 2 control | Minecraft:Key codes | key.keyboard.2 | 13w36a | 1.7.2 |
| key_key.hotbar.3 | Hotbar Slot 3 control | Minecraft:Key codes | key.keyboard.3 | 13w36a | 1.7.2 |
| key_key.hotbar.4 | Hotbar Slot 4 control | Minecraft:Key codes | key.keyboard.4 | 13w36a | 1.7.2 |
| key_key.hotbar.5 | Hotbar Slot 5 control | Minecraft:Key codes | key.keyboard.5 | 13w36a | 1.7.2 |
| key_key.hotbar.6 | Hotbar Slot 6 control | Minecraft:Key codes | key.keyboard.6 | 13w36a | 1.7.2 |
| key_key.hotbar.7 | Hotbar Slot 7 control | Minecraft:Key codes | key.keyboard.7 | 13w36a | 1.7.2 |
| key_key.hotbar.8 | Hotbar Slot 8 control | Minecraft:Key codes | key.keyboard.8 | 13w36a | 1.7.2 |
| key_key.hotbar.9 | Hotbar Slot 9 control | Minecraft:Key codes | key.keyboard.9 | 13w36a | 1.7.2 |
| key_key.debug.reloadChunk | Debug reload chunk control | Minecraft:Key codes | key.keyboard.a | 25w41a | 1.21.11 |
| key_key.debug.showHitboxes | Debug show hitboxes control | Minecraft:Key codes | key.keyboard.b | 25w41a | 1.21.11 |
| key_key.debug.clearChat | Debug clear chat control | Minecraft:Key codes | key.keyboard.d | 25w41a | 1.21.11 |
| key_key.debug.crash | Debug crash control | Minecraft:Key codes | key.keyboard.c | 25w41a | 1.21.11 |
| key_key.debug.showChunkBorders | Debug show chunk borders control | Minecraft:Key codes | key.keyboard.g | 25w41a | 1.21.11 |
| key_key.debug.showAdvancedTooltips | Debug show advanced tooltips control | Minecraft:Key codes | key.keyboard.h | 25w41a | 1.21.11 |
| key_key.debug.copyRecreateCommand | Debug copy recreate command control | Minecraft:Key codes | key.keyboard.i | 25w41a | 1.21.11 |
| key_key.debug.spectate | Debug spectate control | Minecraft:Key codes | key.keyboard.n | 25w41a | 1.21.11 |
| key_key.debug.switchGameMode | Debug switch game mode control | Minecraft:Key codes | key.keyboard.f4 | 25w41a | 1.21.11 |
| key_key.debug.debugOptions | Debug options menu control | Minecraft:Key codes | key.keyboard.f6 | 25w41a | 1.21.11 |
| key_key.debug.focusPause | Debug focus pause control | Minecraft:Key codes | key.keyboard.p | 25w41a | 1.21.11 |
| key_key.debug.dumpDynamicTextures | Debug dump dynamic textures control | Minecraft:Key codes | key.keyboard.s | 25w41a | 1.21.11 |
| key_key.debug.reloadResourcePacks | Debug reload resource packs control | Minecraft:Key codes | key.keyboard.t | 25w41a | 1.21.11 |
| key_key.debug.profiling | Debug profiling control | Minecraft:Key codes | key.keyboard.l | 25w41a | 1.21.11 |
| key_key.debug.copyLocation | Debug copy location control | Minecraft:Key codes | key.keyboard.c | 25w41a | 1.21.11 |
| key_key.debug.dumpVersion | Debug dump version control | Minecraft:Key codes | key.keyboard.v | 25w41a | 1.21.11 |
| key_key.debug.profilingChart | Debug profiling chart control | Minecraft:Key codes | key.keyboard.1 | 25w41a | 1.21.11 |
| key_key.debug.fpsCharts | Debug fps charts control | Minecraft:Key codes | key.keyboard.2 | 25w41a | 1.21.11 |
| key_key.debug.networkCharts | Debug network charts control | Minecraft:Key codes | key.keyboard.3 | 25w41a | 1.21.11 |
| key_key.debug.lightmapTexture | Debug lightmap texture control | Minecraft:Key codes | key.keyboard.4 | 26.1-snapshot-1 | 26.1 |
| key_key.debug.improvedTransparency | Debug improved transparency control | Minecraft:Key codes | key.keyboard.x | 26.3-snapshot-2 | 26.3 |
| soundCategory_master | The volume of all sounds | 0–1 | 1.0 | 13w36a | 1.7.2 |
| soundCategory_music | The volume of gameplay music | 0–1 | 1.0 | 13w36a | 1.7.2 |
| soundCategory_record | The volume of music and sounds from jukeboxes and note blocks | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_weather | The volume of rain and thunder | 0–1 | 1.0 | 13w36a | 1.7.2 |
| soundCategory_block | The volume of blocks | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_hostile | The volume of hostile and neutral mobs | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_neutral | The volume of passive mobs | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_player | The volume of players | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_ambient | The volume of cave sounds and fireworks | 0–1 | 1.0 | 13w42a | 1.7.2 |
| soundCategory_voice | The volume of voices and the narrator | 0–1 | 1.0 | 16w02a | 1.9 |
| soundCategory_ui | The volume of the UI | 0–1 | 1.0 | 1.21.6-pre3 | 1.21.6 |
| modelPart_cape | Whether the cape is shown | true/false | true | 14w03a | 1.8 |
| modelPart_jacket | Whether the "Jacket" skin layer is shown | true/false | true | 14w03a | 1.8 |
| modelPart_left_sleeve | Whether the "Left Sleeve" skin layer is shown | true/false | true | 14w03a | 1.8 |
| modelPart_right_sleeve | Whether the "Right Sleeve" skin layer is shown | true/false | true | 14w03a | 1.8 |
| modelPart_left_pants_leg | Whether the "Left Pant Leg" skin layer is shown | true/false | true | 14w03a | 1.8 |
| modelPart_right_pants_leg | Whether the "Right Pant Leg" skin layer is shown | true/false | true | 14w03a | 1.8 |
| modelPart_hat | Whether the "Hat" skin layer is shown | true/false | true | 14w03a | 1.8 |
| fullscreenResolution | Fullscreen resolution. Values must be supported by the monitor. Unsupported values reset to "Current". When set to "Current", this option is omitted from options.txt. | widthxheight@refresh rate:color bits | Absent | 17w43a | 1.13 |
| shieldIndicatorTemplate:Only | Where the shield indicator is shown on screen | 0–2 (Off, Crosshair, Hotbar) | 0 (Off) | Combat Test 3 | |
| useShieldOnCrouchTemplate:Only | Whether shields are activated by Template:Ctrl | true/false | true | Combat Test 4 | |
Removed options
These options no longer appear in newly generated options.txt files. The ranges show when each option was written by default.
| Template:Tc | No replacement |
| Template:Tc | Renamed or moved to another key |
| Template:Tc | Replaced by another key with similar functionality |
| Option name | Explanation | Valid values | Default value | Development version added | Version added | Development version removed | Version removed | Status | Replacement or notes |
|---|---|---|---|---|---|---|---|---|---|
| advancedOpengl | Whether advanced OpenGL occlusion culling is enabled | true/false | false | Minecraft:b1.6-tb3 | 14w30a | 1.8 | Template:Tc | ||
| allowBlockAlternatives | Whether alternate block models are enabled | true/false | true | 14w28a | 1.8 | 15w31a | 1.9 | Template:Tc | |
| anaglyph3d | Whether anaglyph 3D rendering is enabled | true/false | false | Minecraft:c0.24_st_03 | 17w43a | 1.13 | Template:Tc | ||
| anisotropicFiltering | Anisotropic filtering level | Number | 1 | 13w38a | 1.7 | 14w25a | 1.8 | Template:Tc | Replaced by maxAnisotropyBit in 1.21.11 |
| chatPreview | When the client will send the current chat to the server to preview it | true/false | true | 22w19a | 1.19 | 1.19.1-pre5 | 1.19.1 | rowspan="2" Template:Tc | |
| 0–2 (Off, While Typing, While Sending) | 1 | 1.19.1-pre5 | 1.19.1 | 22w42a | 1.19.3 | ||||
| chunksPerFrame | Template:Info needed | Template:Info needed | 2 | 1.8.2-pre1 | 1.8.2-pre2 | Template:Tc | |||
| clouds | Whether clouds are displayed | true/false | true | Minecraft:b1.9-pre5 | 14w25a | 1.8 | Template:Tc | Replaced by renderClouds in 1.8 | |
| difficulty | The world difficulty. Had no effect after 1.7.2 | 0–3 (Peaceful, Easy, Normal, Hard) | 2 (Normal) | Template:Info needed | 22w12a | 1.19 | Template:Tc | ||
| enableWeakAttacks | When false, the client will ignore attempts to attack when weapon cooldown is less than 75% recharged. | true/false | false | 1.9.1-pre1 | 1.9.1 | 19w08a | 1.14 | Template:Tc | |
| fancyGraphics | Whether fancy graphics are enabled | true/false | true | Minecraft:inf-20100615 | 1.16-pre1 | 1.16 | Template:Tc | Replaced by graphicsMode in 1.16, then by graphicsPreset in 1.21.11 | |
| fboEnable | Whether framebuffer objects is enabled | true/false | true | 13w38a | 1.7.2 | 18w44a | 1.14 | Template:Tc | |
| fpsLimit | Frame rate limit mode, named "Performance" in video settings | 0–2 (Max FPS, Balanced, Power Saver) | 1 | Minecraft:b1.6.5 | 13w38a | 1.7.2 | Template:Tc | Replaced by maxFps in 1.7.2 | |
| graphicsMode | Whether Fast (less detailed), Fancy (more detailed), or Fabulous! (most detailed) graphics are turned on | 0-2 (Fast, Fancy, Fabulous!) | 1 (Fancy) | 1.16-pre1 | 1.16 | 25w41a | 1.21.11 | Template:Tc | Replaced by graphicsPreset in 1.21.11 |
| heldItemTooltips | Whether switching between items shows the name of the item | true/false | true | 12w50a | 1.4.6 | 23w06a | 1.19.4 | Template:Tc | |
| hideBundleTutorial | Whether the player has seen the bundle tutorial hint when trying to use a bundle. | true/false | false | 21w05a | 1.17 | 24w33a | 1.21.1 | Template:Tc | |
| key_Back | Back control | Minecraft:Key codes | 31 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.back | ||
| key_Build | Use control | Minecraft:Key codes | 48 | Minecraft:c0.0.23a_01 | Minecraft:in-20091231-2 | Template:Tc | Renamed to key_key.use | ||
| key_Chat | Chat control | Minecraft:Key codes | 20 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.chat | ||
| key_Drop | Drop control | Minecraft:Key codes | 16 | Minecraft:in-20091231-2 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.drop | ||
| key_Forward | Forward control | Minecraft:Key codes | 17 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.forward | ||
| key_Inventory | Inventory control | Minecraft:Key codes | 23 | Minecraft:in-20091231-2 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.inventory | ||
| key_Jump | Jump control | Minecraft:Key codes | 57 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.jump | ||
| key_key.fog | Fog control | Minecraft:Key codes | 33 | Minecraft:b1.1-2 | Minecraft:b1.8 | Template:Tc | |||
| key_key.streamCommercial | Run a commercial during a stream | Minecraft:Key codes | 0 (none) | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| key_key.streamPauseUnpause | Pause or resume a stream | Minecraft:Key codes | 65 (F7) | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| key_key.streamStartStop | Start or stop a stream | Minecraft:Key codes | 64 (F6) | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| key_key.streamToggleMic | Toggle the microphone during a stream | Minecraft:Key codes | 0 (none) | 13w47d | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| key_key.swapHands | Swapping of items between hands control | Minecraft:Key codes | key.keyboard.f | 15w31a | 1.9 | 1.16-pre3 | 1.16 | Template:Tc | Renamed to key_key.swapOffhand in 1.16 |
| key_Left | Left control | Minecraft:Key codes | 30 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.left | ||
| key_Load location | Load location control | Minecraft:Key codes | 19 | Minecraft:c0.0.23a_01 | Minecraft:a1.0.10 | Template:Tc | |||
| key_Right | Right control | Minecraft:Key codes | 32 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.right | ||
| key_Save location | Save location control | Minecraft:Key codes | 28 | Minecraft:c0.0.23a_01 | Minecraft:a1.0.10 | Template:Tc | |||
| key_Sneak | Sneak control | Minecraft:Key codes | 42 | Minecraft:a1.1.1 | Minecraft:b1.1-2 | Template:Tc | Renamed to key_key.sneak | ||
| key_Toggle fog | Old fog control | Minecraft:Key codes | 33 | Minecraft:c0.0.23a_01 | Minecraft:b1.1-2 | Template:Tc | Replaced by key_key.fog, which was later removed | ||
| limitFramerate | Whether to limit the framerate | true/false | false | Minecraft:c0.27_st | Minecraft:b1.6.5 | Template:Tc | Replaced by fpsLimit in Beta 1.6.5, then replaced by maxFps in 1.7.2 | ||
| music | Music volume | 0.0–1.0 | 1.0 | Minecraft:c0.0.23a_01 | 13w36a | 1.7.2 | Template:Tc | Renamed to soundCategory_music in 1.7.2 | |
| onlyShowSignedChat | Toggles whether the chat displays only cryptographically signed player messages | true/false | false | 22w19a | 1.19-pre1 | Template:Tc | Renamed to onlyShowSecureChat | ||
| postProcessEnable | Template:Info needed | true/false | true | 13w38a | 13w38b | Template:Tc | |||
| rawMouseInput | Whether operating-system mouse acceleration is ignored | true/false | true | 1.14.4-pre2 | 1.14.4 | 26.3-snapshot-4 | 26.3 | Template:Tc | |
| saturation | No in-game control. Never did anything.Template:Verify | 0-1 | 0.0 | 13w38a | 1.7.2 | 19w08a | 1.14 | Template:Tc | |
| serverTextures | Whether server-provided resource packs were enabled | true/false | true | 12w18a | 1.3.1 | 1.7.6-pre1 | 1.7.6 | Template:Tc | |
| shieldAnimation | Whether to show the shield in first-person when blocking with it | true/false | true | Minecraft:Combat Test 3 | Minecraft:Combat Test 4 | Template:Tc | |||
| showCape | Whether the player's cape was displayed | true/false | true | 12w41a | 1.4.2 | 14w03a | 1.8 | Template:Tc | Renamed to modelPart_cape in 1.8 |
| showFrameRate | Template:Info needed | true/false | false | Minecraft:c0.0.23a_01 | Minecraft:a1.1.1 | Template:Tc | |||
| showInventoryAchievementHint | Whether the "Press 'E' to open your inventory" toast appears in the upper right corner of the screen upon initially spawning | true/false | true | 13w36a | 1.7.2 | 17w13a | 1.12 | Template:Tc | |
| showNowPlayingToast | Whether to show a toast when a song starts playing | true/false | false | 25w20a | 1.21.6 | 25w46a | 1.21.11 | Template:Tc | Replaced by musicToast in 1.21.11 |
| skin | Legacy skin selection value | String | Default | Minecraft:a1.2.2-1 | 13w36a | 1.7.2 | Template:Tc | ||
| skipFriendsListPromo | Template:Info needed | true/false | false | 26.2-snapshot-7 | 26.2-pre-1 | Template:Tc | |||
| skipRealms32bitWarning | Whether to skip the 32-bit environment warning when entering the Realms screen | true/false | false | 1.18.2-pre1 | 1.18.2 | 24w14a | 1.20.5 | Template:Tc | |
| snooperEnabled | Whether snooper functionality is turned on | true/false | true | 12w30a | 1.3.1 | 21w43a | 1.18 | Template:Tc | |
| sound | Master sound volume | 0.0–1.0 | 1.0 | Minecraft:c0.0.23a_01 | 13w36a | 1.7.2 | Template:Tc | Renamed to soundCategory_master in 1.7.2 | |
| soundCategory_animals | The volume of animals | 0.0–1.0 | 1.0 | 13w36a | 13w42a | Template:Tc | Renamed to soundCategory_neutralTemplate:Verify | ||
| soundCategory_blocks | The volume of blocks | 0.0–1.0 | 1.0 | 13w36a | 13w42a | Template:Tc | Renamed to soundCategory_blockTemplate:Verify | ||
| soundCategory_mobs | The volume of mobs | 0.0–1.0 | 1.0 | 13w36a | 13w42a | Template:Tc | Renamed to soundCategory_hostileTemplate:Verify | ||
| soundCategory_players | The volume of players | 0.0–1.0 | 1.0 | 13w36a | 13w42a | Template:Tc | Renamed to soundCategory_playerTemplate:Verify | ||
| soundCategory_records | The volume of jukeboxes | 0.0–1.0 | 1.0 | 13w36a | 13w42a | Template:Tc | Renamed to soundCategory_recordTemplate:Verify | ||
| streamBytesPerPixel | Stream video quality in bytes per pixel (BPP) | 0.0–1.0 | 0.5 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamChatEnabled | Stream chat display mode | 0–2Template:More info | 0 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamChatUserFilter | Stream chat user-filter mode | 0–2Template:More info | 0 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamCompression | Stream compression mode | 0–2Template:More info | 1 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamFps | Stream frame rate | Number | 0.31690142 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamKbps | Stream bitrate in kilobits per second | Number | 0.5412844 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamMicToggleBehavior | Microphone toggle mode | 0–1Template:More info | 0 | 13w47d | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamMicVolume | Microphone's output volume when livestreaming | 0–1 | 1.0 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamPreferredServer | The preferred ingest server of the livestream | String | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature | |
| streamSendMetadata | Whether to send extra metadata in the livestream | true/false | true | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| streamSystemVolume | System's output volume when livestreaming | 0–1 | 1.0 | 13w47a | 1.7.4 | 15w31a | 1.9 | Template:Tc | Removed with the built-in streaming feature |
| touchscreen | Whether touchscreen controls are enabled | true/false | false | 1.4.6-pre | 1.4.6 | 26.2-snapshot-5 | 26.2 | Template:Tc | |
| uploadsPerFrame | Template:Info needed | Template:Info needed | 16 | 1.8.2-pre2 | 1.8.2-pre5 | Template:Tc | |||
| useVbo | Whether vertex buffer objects are enabled | true/false | false | 14w29a | 1.8 | 18w44a | 1.14 | Template:Tc | |
| viewDistance | Render distance mode | 0–3 (Far, Normal, Short, Tiny) | 0 | Minecraft:c0.0.23a_01 | 13w38a | 1.7.2 | Template:Tc | Replaced by renderDistance in 1.7.2 | |
April Fools' options
| Option name | Explanation | Valid values | Default value | April Fools' version |
|---|---|---|---|---|
| key_key.potato | Potato control | Minecraft:Key codes | key.keyboard.apostrophe | 24w14potato |
| potatoFont | Whether the Minecraft:potato font is used | true/false | false | 24w14potato (original) |
| hasSeenVotingScreen | Whether to not show a toast every few seconds about a new voting proposal | true/false | false | 23w13a_or_b |
| key_key.boss_mode | Boss mode control | Minecraft:Key codes | key.keyboard.b | 3D Shareware v1.34 |
| key_key.decrease_view | Screen size control | Minecraft:Key codes | key.keyboard.f8 | |
| key_key.increase_view | Screen size control | Minecraft:Key codes | key.keyboard.f7 | |
| grayscale | Whether to make all textures monochrome except for recolored/secondary layer textures | true/false | false | 2.0 |