Set/Get Minecraft Options

How to set and get Minecraft options like volume, FOV, render distance, etc.

Updated: 2026-05-03 12:33:01 UTC

Working with Minecraft Options in FancyMenulink

FancyMenu allows you to get and set Minecraft game settings (options) using different UI elements. This guide will show you how to use buttons, sliders, and tickers to work with Minecraft options in your custom menu layouts.

Understanding Minecraft Optionslink

Minecraft has many built-in options that control everything from graphics settings to sound volume. FancyMenu lets you access these options by their names.

Some common option names include:

  • soundCategory_master - Main volume
  • soundCategory_music - Music volume
  • soundCategory_ambient - Ambient sounds volume
  • soundCategory_players - Player sounds volume
  • soundCategory_blocks - Block sounds volume
  • fov - Field of view
  • gamma - Brightness
  • renderDistance - Render distance

Displaying Option Valueslink

You can display the current value of any Minecraft option using a special placeholder.

The placeholder looks like this:

{"placeholder":"minecraft_option_value","values":{"name":"option_name"}}

Replace option_name with the actual option name you want to display.

Setting Options with Buttonslink

Buttons can be used to set specific values to Minecraft options.

How to set up a button:link

  1. Create a new Button element
  2. Set the button label (what appears on the button)
  3. Add an action: Right-click on the button → Edit Action Script → Add Action → Set Minecraft Option Value
  4. In the "Set Minecraft Option Value" window:
    • Name: Enter the option name (like renderDistance)
    • Value: Enter the value to set (like 16)

Example:link

Creating a button that sets render distance to 16 chunks:

  • Option Name: renderDistance
  • Value: 16
  • Label: "Set Render Distance to 16 chunks"

Setting Options with Sliderslink

Sliders are perfect for options with a range of values, like volume settings or brightness.

How to set up a slider:link

  1. Create a new Slider element
  2. Set the slider type:
    • For whole numbers (like render distance): Choose "Integer Range"
    • For decimal numbers (like volume): Choose "Decimal Range"
  3. Set minimum and maximum values
  4. Add an action to set the Minecraft option:
    • Right-click → Edit Action Script → Add Action → Set Minecraft Option Value
    • Name: The option name
    • Value: $$value (this special variable contains the current slider value)
  5. Set the pre-selected value to the current option value:
    • Set "Pre-Selected Value" to {"placeholder":"minecraft_option_value","values":{"name":"option_name"}}

Example slider label formats:link

To show the current option value in the slider label, use:

Volume: {"placeholder":"minecraft_option_value","values":{"name":"soundCategory_master"}}

To show a percentage (useful for volume):

Volume: {"placeholder":"calc","values":{"expression":"$$value * 100.0","decimal":"false"}}%

Setting Options with Tickerslink

Tickers are invisible elements that can change options automatically on a schedule.

How to set up a ticker:link

  1. Create a new Ticker element
  2. Configure the tick settings:
    • Tick Mode: Choose when the option should update
    • Tick Delay: Set how often it updates (in milliseconds)
  3. Add the action to set a Minecraft option:
    • Right-click → Edit Action Script → Add Action → Set Minecraft Option Value
    • Set the option name and value

Example:link

Setting gamma (brightness) to maximum when the menu loads:

  • Tick Mode: On Load Screen
  • Name: gamma
  • Value: 1.0

Common Use Caseslink

Here are some common cases for what you can do when using FancyMenu to set and get Minecraft options.

Creating Custom Volume Sliderslink

Volume sliders are a common use for the Minecraft option integration. Here's how to make a custom music volume slider:

  1. Create a new Slider element
  2. Set the "Slider Type" to "Decimal Range"
  3. Set the "Minimum Range Value" to "0.0"
  4. Set the "Maximum Range Value" to "1.0"
  5. Edit Action Script → Add Action → Set Minecraft Option Value
    • Set Name to soundCategory_music
    • Set Value to $$value
  6. Set "Pre-Selected Value" to {"placeholder":"minecraft_option_value","values":{"name":"soundCategory_music"}}
  7. To display the volume as a percentage, set the label to: 
    Music: {"placeholder":"calc","values":{"expression":"$$value * 100.0","decimal":"false"}}%

You can create similar sliders for other sound categories:

  • Master Volume: soundCategory_master
  • Music: soundCategory_music
  • Ambient: soundCategory_ambient
  • Blocks: soundCategory_blocks
  • Players: soundCategory_players
  • Weather: soundCategory_weather

Creating a Custom FOV Sliderlink

Field of View (FOV) is an important graphics setting that determines how wide your view is in the game. The FOV option internally uses values from -1.0 to 1.0, but displays as 30 to 110 in the UI.

Understanding the FOV Value Mappinglink

  • Internal value range: -1.0 to 1.0
  • Display value range: 30 to 110
  • Mapping formula: (internal_value + 1) * 40 + 30

Step 1: Create a Ticker Element to Update FOV Textlink

First, we need a ticker that will check the current FOV value and set a variable with the appropriate description:

  1. Create a new Ticker element
  2. Set the "Tick Mode" to "Normal" (so it updates constantly)
  3. Set the "Tick Delay" to around "10" (milliseconds) to avoid excessive checks

Now we need to set up actions for the FOV labels. Here's what your action script structure should look like:

▶ Action Script
│
├─▶ IF (mapped FOV = 70)
│  └─■ Set Variable Value: fov_text:Normal
│
├─▶ ELSE-IF (mapped FOV = 110)
│  └─■ Set Variable Value: fov_text:Quake Pro
│
└─▶ ELSE
   └─■ Set Variable Value: fov_text:[calculated numeric value]

Let's set up each part:

Set up the "Normal" FOV Label:link

  1. Right-click → Edit Action Script → Add Action
  2. Click "IF Statement" to add a conditional block
  3. Set the requirement to "Is Number" with:
    • Compare Mode: "equals"
    • Number: {"placeholder":"calc","values":{"decimal":"false","expression":"({"placeholder":"minecraft_option_value","values":{"name":"fov"}} + 1) * 40 + 30"}}
    • Compare With: "70"
  4. Inside this IF block, add "Set Variable Value (FM Variable)" action with:
    • Value: fov_text:Normal

Set up the "Quake Pro" FOV Label:link

  1. Inside the Action Script, add "ELSE-IF Statement"
  2. Set the requirement to "Is Number" with:
    • Compare Mode: "equals"
    • Number: {"placeholder":"calc","values":{"decimal":"false","expression":"({"placeholder":"minecraft_option_value","values":{"name":"fov"}} + 1) * 40 + 30"}}
    • Compare With: "110"
  3. Inside this ELSE-IF block, add "Set Variable Value (FM Variable)" action with:
    • Value: fov_text:Quake Pro

Set up the Numeric FOV Label:link

  1. Add an "ELSE Statement" block
  2. Inside this ELSE block, add "Set Variable Value (FM Variable)" action with:
    • Value: fov_text:{"placeholder":"calc","values":{"decimal":"false","expression":"({"placeholder":"minecraft_option_value","values":{"name":"fov"}} + 1) * 40 + 30"}}
FOV Slider Action Script

Step 2: Create the FOV Sliderlink

  1. Create a new Slider element
  2. Set the "Slider Type" to "Decimal Range"
  3. Set the "Minimum Range Value" to "-1.0"
  4. Set the "Maximum Range Value" to "1.0"
  5. Edit Action Script → Add Action → Set Minecraft Option Value
    • Set Name to fov
    • Set Value to $$value
  6. Set "Pre-Selected Value" to {"placeholder":"minecraft_option_value","values":{"name":"fov"}}

Step 3: Set the Slider Labellink

Set the slider label to simply display the FOV text variable:

FOV: {"placeholder":"getvariable","values":{"name":"fov_text"}}

This label will show:

  • "FOV: Normal" when the value is 70
  • "FOV: Quake Pro" when the value is 110
  • "FOV: 85" (or any other number) for all other values

Tips for FOV Sliderslink

  • The internal slider value range is -1.0 to 1.0, which needs to be mapped to 30 to 110 for display
  • The conversion formula is: (internal_value + 1) * 40 + 30
  • Only two values have special labels: 70 (Normal) and 110 (Quake Pro)
  • The default FOV in Minecraft is 70 (which corresponds to internal value 0.0)
  • The fov_text variable automatically contains either the special label or the numeric value

Displaying Option Values in Text Elementslink

You can also display current option values in Text elements:

  1. Create a Text element
  2. For the text content, use the placeholder: {"placeholder":"minecraft_option_value","values":{"name":"option_name"}}

For example, to show the current render distance:

Current render distance: {"placeholder":"minecraft_option_value","values":{"name":"renderDistance"}} chunks

Finding Option Nameslink

You can find the names of all available options by:

  1. Creating a button
  2. Right-clicking it
  3. Clicking "Edit Action Script"
  4. Adding "Set Minecraft Option Value" action
  5. When editing the action's value, look at the dropdown suggestions when you start typing in the "Name" field

Important Tipslink

  • Valid Values: Not all options accept all values. For example:

    • Volume options accept values from 0.0 to 1.0
    • Render distance typically accepts whole numbers from 2 to 32
    • Boolean options (true/false) like pauseOnLostFocus accept "true" or "false"

  • Testing: Always test your settings to make sure they work as expected!

  • Visual Feedback: Give users visual feedback about the current value using the placeholders described above.