Options Class

The Options class manages all game settings including graphics, audio, controls, and gameplay options. It handles loading, saving, and applying configuration changes.

Constructor

Options(Minecraft *minecraft, File workingDirectory)
Options()

Creates a new Options instance.

Minecraft*

The Minecraft instance (can be NULL for standalone options)

File

Directory where options file is stored

Initialization

init

void init()

Initializes all options with default values. Called automatically by the constructor.

Audio Settings

float

Music volume (0.0 to 1.0)

float

Sound effects volume (0.0 to 1.0)

Graphics Settings

int

Render distance:

0 - Far
1 - Normal
2 - Short
3 - Tiny

bool

Enable fancy graphics (leaves, water, etc.)

bool

Enable smooth lighting/ambient occlusion:

true - Smooth lighting enabled
false - Smooth lighting disabled

bool

Enable cloud rendering

int

Particle effects level:

0 - All
1 - Decreased
2 - Minimal

bool

Enable 3D anaglyph mode (red/cyan glasses)

bool

Enable advanced OpenGL features (occlusion culling)

int

Framerate limit:

0 - Max
1 - Balanced
2 - Power Saver

int

GUI scale:

0 - Auto
1 - Small
2 - Normal
3 - Large

float

Field of view (0.0 to 1.0, mapped to degrees)

float

Brightness/gamma (0.0 to 1.0)

Control Settings

float

Mouse sensitivity (0.0 to 1.0)

bool

Invert mouse Y-axis

bool

Enable view bobbing when walking

Key Mappings

KeyMapping*

Move forward (default: W)

KeyMapping*

Move backward (default: S)

KeyMapping*

Move left (default: A)

KeyMapping*

Move right (default: D)

KeyMapping*

Jump (default: Space)

KeyMapping*

Sneak (default: Left Shift)

KeyMapping*

Attack/destroy (default: Left mouse button)

KeyMapping*

Use/place block (default: Right mouse button)

KeyMapping*

Open inventory (default: E)

KeyMapping*

Drop item (default: Q)

KeyMapping*

Open chat (default: T)

KeyMapping*

Show player list (default: Tab)

KeyMapping*

Pick block (default: Middle mouse button)

KeyMapping*

Toggle fog (default: F)

KeyMapping*[14]

Array of all key mappings

Gameplay Settings

int

Game difficulty:

0 - Peaceful
1 - Easy
2 - Normal
3 - Hard

bool

Third-person camera enabled

bool

Show debug overlay (F3)

bool

Hide HUD/GUI

Advanced Settings

bool

Creative mode flying enabled

bool

Smooth camera movement

bool

Fixed camera position (debug)

float

Creative mode flight speed

float

Camera movement speed (spectator)

Network Settings

wstring

Last multiplayer server IP address

Skin Settings

wstring

Selected player skin name

Methods

load

void load()

Loads options from the options file (options.txt).

save

void save()

Saves current options to the options file.

set

void set(const Options::Option *item, float value)

Sets an option to a specific value.

const Options::Option*

The option to set

float

The new value (0.0 to 1.0 for progress options)

toggle

void toggle(const Options::Option *option, int dir)

Toggles or cycles an option value.

const Options::Option*

The option to toggle

int

Direction: 1 for forward, -1 for backward

getProgressValue

float getProgressValue(const Options::Option *item)

Gets the current value of a progress-based option (0.0 to 1.0).

getBooleanValue

bool getBooleanValue(const Options::Option *item)

Gets the current value of a boolean option.

getMessage

wstring getMessage(const Options::Option *item)

Gets the localized display message for an option’s current value.

getKeyDescription

wstring getKeyDescription(int i)

Gets the description for a key mapping.

int

Key mapping index (0-13)

getKeyMessage

wstring getKeyMessage(int i)

Gets the current key binding message for display.

setKey

void setKey(int i, int key)

Sets a key binding.

int

Key mapping index (0-13)

int

Key code

isCloudsOn

bool isCloudsOn()

Returns whether cloud rendering is enabled.

Option Constants

The Options::Option nested class defines available options:

static const Option *MUSIC;
static const Option *SOUND;
static const Option *INVERT_MOUSE;
static const Option *SENSITIVITY;
static const Option *RENDER_DISTANCE;
static const Option *VIEW_BOBBING;
static const Option *ANAGLYPH;
static const Option *ADVANCED_OPENGL;
static const Option *FRAMERATE_LIMIT;
static const Option *DIFFICULTY;
static const Option *GRAPHICS;
static const Option *AMBIENT_OCCLUSION;
static const Option *GUI_SCALE;
static const Option *FOV;
static const Option *GAMMA;
static const Option *RENDER_CLOUDS;
static const Option *PARTICLES;

Ambient Occlusion Constants

static const int AO_OFF = 0;  // No ambient occlusion
static const int AO_MIN = 1;  // Minimum ambient occlusion
static const int AO_MAX = 2;  // Maximum ambient occlusion

Example Usage

Creating and Loading Options

// Create options instance
Options *options = new Options(minecraft, workingDirectory);

// Load from file
options->load();

Modifying Graphics Settings

// Enable fancy graphics
options->fancyGraphics = true;

// Set render distance to far
options->viewDistance = 0;

// Enable ambient occlusion
options->ambientOcclusion = true;

// Reduce particles
options->particles = 2; // Minimal

// Save changes
options->save();

Adjusting Audio

// Set music volume to 50%
options->set(Options::Option::MUSIC, 0.5f);

// Set sound effects to 75%
options->set(Options::Option::SOUND, 0.75f);

options->save();

Configuring Controls

// Change forward key to Arrow Up
options->setKey(2, Keyboard::KEY_UP);

// Enable mouse inversion
options->invertYMouse = true;

// Increase sensitivity
options->sensitivity = 0.8f;

options->save();

Using Option Toggles

// Toggle graphics quality
options->toggle(Options::Option::GRAPHICS, 1);

// Cycle render distance
options->toggle(Options::Option::RENDER_DISTANCE, 1);

// Toggle view bobbing
options->toggle(Options::Option::VIEW_BOBBING, 1);

options->save();

Difficulty Management

// Set to peaceful
options->difficulty = 0;

// Set to hard
options->difficulty = 3;

options->save();

Reading Current Settings

// Check if clouds are enabled
if (options->isCloudsOn()) {
    // Render clouds
}

// Get FOV value
float fovValue = options->getProgressValue(Options::Option::FOV);

// Get formatted message for display
wstring fovMessage = options->getMessage(Options::Option::FOV);

File Format

Options are stored in options.txt as key-value pairs:

music:1.0
sound:1.0
invertYMouse:false
mouseSensitivity:0.5
fov:0.0
gamma:0.0
renderDistance:0
guiScale:0
particles:0
bobView:true
anaglyph3d:false
advancedOpengl:false
fpsLimit:2
difficulty:2
fancyGraphics:true
ao:true
renderClouds:true
skin:Default
lastServer:192.168.1.100
key_forward:17
key_left:30
key_back:31
key_right:32

Performance Considerations

Fancy graphics and high render distances significantly impact performance. For optimal framerates on lower-end hardware, use:

viewDistance = 2 or 3 (Short/Tiny)
fancyGraphics = false
particles = 2 (Minimal)
ambientOcclusion = false

Client

World

Rendering

Networking

Constructor

Initialization

init

Audio Settings

Graphics Settings

Control Settings

Key Mappings

Gameplay Settings

Advanced Settings

Network Settings

Skin Settings

Methods

load

save

set

toggle

getProgressValue

getBooleanValue

getMessage

getKeyDescription

getKeyMessage

setKey

isCloudsOn

Option Constants

Ambient Occlusion Constants

Example Usage

Creating and Loading Options

Modifying Graphics Settings

Adjusting Audio

Configuring Controls

Using Option Toggles

Difficulty Management

Reading Current Settings

File Format

Performance Considerations

​Constructor

​Initialization

​init

​Audio Settings

​Graphics Settings

​Control Settings

​Key Mappings

​Gameplay Settings

​Advanced Settings

​Network Settings

​Skin Settings

​Methods

​load

​save

​set

​toggle

​getProgressValue

​getBooleanValue

​getMessage

​getKeyDescription

​getKeyMessage

​setKey

​isCloudsOn

​Option Constants

​Ambient Occlusion Constants

​Example Usage

​Creating and Loading Options

​Modifying Graphics Settings

​Adjusting Audio

​Configuring Controls

​Using Option Toggles

​Difficulty Management

​Reading Current Settings

​File Format

​Performance Considerations

Constructor

Initialization

init

Audio Settings

Graphics Settings

Control Settings

Key Mappings

Gameplay Settings

Advanced Settings

Network Settings

Skin Settings

Methods

load

save

set

toggle

getProgressValue

getBooleanValue

getMessage

getKeyDescription

getKeyMessage

setKey

isCloudsOn

Option Constants

Ambient Occlusion Constants

Example Usage

Creating and Loading Options

Modifying Graphics Settings

Adjusting Audio

Configuring Controls

Using Option Toggles

Difficulty Management

Reading Current Settings

File Format

Performance Considerations