Minecraft Access Docs

Configuration

Contents

This page contains all the configuration that controls the features on-off and behavior.

The configuration can be modified in two ways: via the config menu or directly editing the configuration file. The Config Menu can be opened via opening the Access Menu (press F4) then click Open Config Menu button. The configuration file (named as config.json) can be found in the {minecraft directory}/config/minecraft_access/ directory. You can use Notepad or any text editor to edit the file. You can also use online JSON editor like Json Editor Online, Json Formatter or Code Beautify JSON Online Editor.

If you want to reset the config back to default values, delete the configuration file while the game is not running, or click Reset Config button in the Config Menu.

Camera Controls

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Normal Rotating Angle22.5The rotation angle when we press the camera moving keys
Modified Rotating Angle11.25The rotation angle when we press the camera moving keys while holding down the Left Alt key
Delay (in milliseconds)250Cooldown between two feature executions

This config is under Other Configurations section in the config file and config menu.

ConfigurationDefault ValueDescription
Enable Facing DirectiontrueWhether to automatically speak the current direction as the camera moves

See also: Feature Description, keybindings

Mouse Simulation

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Scroll Delay (in milliseconds)150Cooldown between two mouse wheel scroll simulations

See also: Feature Description, keybindings

Read Crosshair

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Speak Block SidestrueEnable speaking of the side of block as well
Disable Speaking Consecutive Blocks With Same NamefalseDisable speaking the block if the previous block was also same
Repeat Speaking Interval (in milliseconds)0 (for tuning it off)Repeat speaking for the given amount of time, even you haven’t moved the camera

Config Disable Speaking Consecutive Blocks With Same Name option can be useful when you don’t want to hear repetitive speaking of a large area with the same block type.

See also: Feature Description

Relative Position Sound Cue

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Min Sound Volume0.25Min volume of the sound cue
Max Sound Volume0.4Max volume of the sound cue

See also: Feature Description

Partial Speaking

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
White List ModetrueIf true, only speak what have been configured. Set to false for blacklist mode, only not speak what you’ve configured
Fuzzy ModetrueWhether to do fuzzy matching, for example bed will match all colors of beds, door will match all textures of doors
Target ModeblockWhich type would you like to apply this feature to, either all, entity or block
Targets[slab,​planks,​block,​stone,​sign]Indicated what to be spoken

The Targets config can only be configured in config.json file. Values are written in Minecraft resource location format, the so-called snake_case (consists of lowercase letters with underscores). For example, the White Bed is written in white_bed. There are lots of exceptions, the Smooth Quartz Block is written in smooth_quartz, the Block of Diamond is written in diamond_block, so please check the correct values in this wiki link (expand to show the list by clicking Blocks[show] then Item form's ID[show]).

See also: Feature Description

Inventory Controls

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Auto Open Recipe BooktrueAutomatically opens the recipe
book on opening the inventory (in creative/survival inventory screen and crafting screen)
Row and Column Format in Crafting Input Slots%dx%dThe speaking format of row and column prefix, two %d are representing the position of row and column
Speak Focused Slot ChangestrueSpeak if the content of focused slot changes, close it if you hear the mod is continuously repeating changes of item name, some mods like Hypixel will cause that.
Delay (in milliseconds)250Cooldown between two feature executions

Most recipes require their ingredients to be arranged in a specific way on the crafting grid (a.k.a. our crafting input group). That’s how Row and Column Format in Crafting Input Slots config can help you, you’ll hear something like 1x2 Empty Slot which represent you’re locating at row one and column two slot inside the crafting input group, and it contains nothing.

See also: Feature Description, keybindings

Point of Interest

See also: Feature Description, keybindings

Blocks

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable scanning blocks
Detect Fluid BlockstrueEnable detecting fluid blocks (water and lava)
Range6Range of blocks to scan
Play SoundtruePlay a sound cue at positions of detected blocks
Sound Volume0.25Volume of the sound cue
Play Sound for Other Blocks as wellfalsePlay sound cue for other blocks other than the ores as well
Delay (in milliseconds)3000Execute at set intervals

Entities

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable scanning entities
Range6Range of entities to scan
Play SoundtruePlay a sound cue at positions of detected entities
Sound Volume0.25Volume of the sound cue
Delay (in milliseconds)3000Execute at set intervals

Entities/Blocks Locking

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Lock on BlockstrueEnable lock on POI blocks as well, if false, only entities can be locked
Play SoundtruePlay a sound cue at positions of detected entities
Speak Relative Distance to Entity/BlockfalseSpeak relative distance to the target when locking on
Play Sound Instead Of SpeakfalsePlay a base drum sound cue on unlock instead of speak unlock
Auto Lock on to Eye of Ender when UsedtrueAutomatically lock on to the Eye of Ender when used
Delay (in milliseconds)100Cooldown between two feature executions
Bow aim assisttrueEnable automatic temporary locking onto the nearest monster when using a bow
Aim assist soundtrueEnables audio cues for bow aim assist
Aim assist sound volume0.5Controls the volume of the aim assist audio cues

Entities/Blocks Marking

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Suppress Other POI When Marking OntrueWhen marking on, suppress scanning and notifying on pre-configured ones

Position Narrator

These configs are under Other Configurations section in the config file and config menu.

ConfigurationDefault ValueDescription
Enable Position NarratortrueWhether to enable this feature
Position Narrator Format{x}x, {y}y, {z}zThe speaking format of the position, {x}, {y}, {z} represent the corresponding axis’s position

See also: Feature Description, keybindings

Player Status

This config is under Other Configurations section in the config file and config menu.

ConfigurationDefault ValueDescription
Enable PlayerStatustrueWhether to enable this feature

See also: Feature Description, keybindings

Player Warnings

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Play SoundtruePlay a sound cue when any of the status reach the threshold
Health Threshold First6The first threshold for health
Health Threshold Second3The seconds threshold for health
Hunger Threshold3The threshold for hunger/food
Air Threshold3The threshold for air when you’re submerged in water

See also: Feature Description

Fall Detector

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature
Range6Range of drop to scan
Depth Threshold4The threshold for playing the sound
Play Alternate SoundtrueUnused
Sound Volume0.25Volume of the sound cue
Delay (in milliseconds)2500Execute at set intervals

See also: Feature Description

Access Menu

ConfigurationDefault ValueDescription
EnabledtrueWhether to enable this feature

See also: Feature Description, keybindings

Fluid Detector

ConfigurationDefault ValueDescription
Range10Range of fluid to scan, be careful, the default 10 blocks will already make the game lag for a second or two
Sound Volume0.25Volume of the sound cue

Other Configurations

ConfigurationDefault ValueDescription
Enable Biome IndicatortrueWhether to enable Biome Indicator feature
Enable XP IndicatortrueWhether to enable XP Indicator feature
Command Suggestion Narrator Format%dx%d %sThe speaking format of the command suggestion, two %d represent the order of focused suggestion and total number of suggestions, %s represents the suggestion content
Use 12 Hour Time FormatfalseWhether to use 12 hour time format when speaking the time
Speak Action Bar MessagestrueWhether to speak the messages updated in action bar, useful when you’re in modded multiplayer servers
Only Speak Action Bar UpdatesfalseOnly speak changed part of action bar message when the message is partially updated, useful for some mods like Hypixel
Speak Harvest Of FishingtrueWhether to speak the harvest of fishing
Always Speak Picked Up ItemsfalseWhether to speak any items you pick up (this will also enable speaking of fishing harvests)
Report Held Items Count When ChangedtrueWhether to report the number of held items when it changed
Enable Menu FixtrueWhether to reset the cursor position when opening a menu (to prevent speak out unnecessary content)
Debug ModetrueDeveloper config, whether to print debug messages into log
Multiple Click Speed (in milliseconds)750The maximum time interval between two keystrokes in multiple click operations like double-click

See also: Feature Description