Right Shift menu¶

Press Right Shift in a world and Xol's menu opens over the game: the module grid with its tabs and search box, a settings page for every module, and your HUD live behind it so you can arrange it while the menu is open. The client's own hints call it the Mods menu.

Opening it¶

Esc steps back: it first clears the search or closes an open field or color picker, then returns from a settings page to the grid, and then closes the menu.

Layout¶

At the top is the Xol wordmark and three buttons:

Under them is one panel that shows the view you picked. Your HUD stays drawn behind the panel and can be dragged, scaled and nudged at any time; see HUD editor.

Three small buttons sit in the bottom left corner of the screen:

The module grid¶

The grid lists every module as a row with its name, an on or off button and a gear. An enabled row is filled in the theme color and its button shows an X; a disabled row is dark and its button shows a +.

• Left click a row to switch the module on or off.
• Right click a row, or click its gear, to open its settings page.
• Hover over a row to see the module's one-line description.

Above the grid:

Search¶

The search box has focus when the grid opens, and typing goes into it. Matching ignores upper and lower case, and every word you type must appear somewhere. A module matches on its name, its identifier, its description, a few extra keywords (for example "freelook" finds Perspective) or on any of its settings' labels, identifiers and descriptions. If nothing matches, the grid says so.

Keys in the grid¶

A module's settings page¶

The page starts with the module's name in capitals, a back arrow, Enabled or Disabled with its switch, and the module's description. Its settings follow, grouped under headings that fold open and closed. At the bottom are a line starting "Multiplayer:" with the module's multiplayer note, and two buttons:

Some rows only appear when another setting makes them useful, for example Rotation interval in Pack display only while Pack order is Rotate.

If a server does not allow a feature of the module, the page says so in a highlighted line, for example that Freelook is switched off on that server. If the module switched itself off after an error, the page says that too.

Keys on a page¶

Controls by setting type¶

Colors are stored as eight hex digits, transparency first: FFFFFFFF is opaque white, 80FFFFFF is half-transparent white.

Client settings¶

The gear button shows one list with three parts:

1. XOL SETTINGS: General, Performance, Multiplayer, Menu theme, Font and Xol pack. None of them can be switched off.
2. THEME MANAGER: the color of this menu.
3. Every module in grid order, each under a heading you can unfold, with an Enabled row, its settings and its two reset buttons.

General settings¶

General also has two rows that are not settings:

Multiplayer note: "Interface and input preferences only. Sends nothing."

Smart disconnect¶

With Smart disconnect on, the pause menu's Disconnect button on a server opens a question first: "Are you sure you want to disconnect?", with Disconnect and Cancel. Cancel or Esc takes you back to the pause menu. Disconnect leaves the server the way the button always does.

Only that button asks. Leaving a singleplayer world is never asked, and a kick, a time out or any other way the game leaves a server never meets the question. If anything goes wrong, you leave as if the setting were off. It sends nothing.

Performance¶

Ways Xol makes each frame cheaper, in five sections: FPS boost (with a master switch, Enable FPS boost, on by default), FPS limiting (with its own master switch, on by default), Drawing less, Frame rate and timing and System. Each row can be switched on or off, and each row's description in the menu says exactly what it does.

With FPS boost on, Entity distance and Block entity distance (48 blocks each by default) stop drawing players, mobs, items, arrows, chests, signs and the like beyond that range. Minecraft's own limit for a player is about 64 blocks, so these can only ever draw less. The rows that hide end portals, arrows (in the ground, stuck in players or mobs, in flight), placed skulls and foliage are off by default. Hide foliage stops tall grass, flowers and dead bushes being drawn, which also removes cover other players stand in, the same as a clear-grass resource pack.

The FPS limiting rows only apply while you are not playing: in the background, in the pause menu, in containers if you switch that on, and in Xol's own screens. The one exception is Use your own maximum frame rate (off by default), which replaces the game's Max Framerate with a number of your choice and is not used while VSync is on.

Multiplayer note: "Drawing only. These switches make your own screen cheaper to draw, mostly by not drawing things: far entities, arrows, skulls, tall grass. Nothing is sent and nothing behind a wall is ever shown."

Xol makes no claim about how many frames any of this gains on your computer.

Multiplayer¶

Multiplayer note: "Changes one field of the first packet: the address, which Forge marks as a modded connection. Same packet, same moment, same address and port; nothing is hidden from the server and nothing extra is sent."

Menu theme¶

The look of the game's menus. See Menu theme.

Font¶

Multiplayer note: "Drawing only, and only of text Xol itself puts on the screen. Nothing is measured, moved or sent for a server."

Xol pack¶

Switches and choices for Xol's own resource pack, in four sections. They apply while the Xol pack is on in Resource Packs.

• Animations: Animated fireball, Animated ender pearl, Buzz ball liquid animation, Animated water, lava and fire, and Sky animations.
• Colours: the table below.
• Textures: Colour bow draw, Custom sky, Clouds over the custom sky and Connected glass.
• Sounds: Fireball sound and BuzzBallz sip sound.

A colour change reloads the textures when you close the menu. Reload on the Changes are waiting row applies it at once; the game pauses for a moment while it reloads. The pack's ender pearl is red and has no colour choice.

Multiplayer note: "Display only. Changes which of the Xol pack's textures your own game draws; nothing is sent."

Theme manager¶

Settings every HUD element has¶

Every module that draws a HUD element has a Visibility section at the end of its page:

The HUD editor ignores these conditions, so an element can always be placed.

Text elements¶

The one-line readouts (FPS, CPS, Ping, Playtime, Pack display, ToggleSprint's status line, and the new counters such as Clock, Date, Memory usage, SPS and Server address) share these rows as well, under Text, Background and Visibility:

The other HUD elements (Coordinates, Key Strokes, Armor Status, Potion Effects and some of the new ones) have Background, Text shadow (on or off) and Text color plus their own rows instead. Each module page lists them.

Position and scale are not settings. They belong to the active layout and are changed in the HUD editor.

When settings are saved¶

When a Xol screen closes, after you name a layout, and when you go from the HUD editor's own bar back to the menu. Saving never interrupts the game: if the file cannot be written, the client carries on with the settings in memory. The settings live in xol/config.json, which the launcher shares between the Xol profiles for 1.8.9 and 1.7.10. The file format is on Settings files.