Minecraft Access

New Features

• Support navigating and narrating on the config menu of the Cloth Config library, this provides support to the config menus of other mods that also use this library. (If you run into a mod's config menu that is built with Cloth that isn't accessible, report it as a bug)
• Add configuration setting to optionally enable fix for mouse simulation issues on MacOS.
• Added an Object Tracker. Find the changelog section on it below or learn more on the docs
• The mod will now announce when the HUD is hidden or shown with the F1 key
• New keybinding Control + Speak Player Status: Speak currently active effects
• Automatically speak gained and lost effects (when configuration option Enable Player Status is on)
• Additional entity poses are reported (E.G. swimming, gliding, sleeping) with a new config value (defaulted to true) to enable this functionality
• End Portal Frame blocks now report wether they have an eye of ender in them or not
• Added narration for titles and subtitles
• Made toasts (advancement, recipe unlock, system, and tutorial messages) narrated by the mod
• Added mod icon to resources so it will be properly displayed in mod management menu
• There is now a message when the credits are opened from the menu or after defeating the Ender Dragon
• Added a new config "Always Speak Picked Up Items" that extends the behavior found in fishing harvests to the rest of the game (defaulted to disabled)
• You can now scroll through old chat messages. View the keybinding docs for the commands
• You can now use alt + 0 or alt + numpad 0 to hear the 10th message on a chat page
• The mod will now say its version when starting up
• Player Status now reports the game mode when pressed
• The selected gamemode on the gamemode switcher (F3+F4) will now be narrated
• The narrator is now enabled by default
• Display Entities are now narrated and trackable in the object tracker (text, item, and block entities)
• Minecraft Access now works on Wayland on Linux without X11
• Minecraft Access now runs on Pojav Launcher on iOS

Feature Updates

• Cloth Config is now used for this mod's config menu, the location of the config menu is unchanged however, and remains in the Access Menu.
• New Features config category that contains on-off switches for some automatic features.
• Locking feature's speak relative distance config is deprecated. It has been replaced by a new setting that affects both the locking feature and the object tracker.
• Enforced client side loading of the mod instead of relying on our own detection
• Updated mod metadata files to properly depend on Architectury API and suggest Jade
• Changed the player warning sound to be less startling and tied to the player's sound source volume
• If numbers ended in .0, they will now be trimmed to exclude it
• Remove formatting codes from all narrations
• Player Status is now no longer available in Creative mode or Spectator mode to match sighted player's view
• Player Warnings no longer trigger in Creative mode or Spectator mode to match sighted player's view
• Some functions will no longer attempt to run if they are not relevant to the current game mode
• Ladders now have a POI group
• Portals now have a POI group
• You will now be able to see when you don't have enough lapis or levels when enchanting
• The XP information is no longer read in creative or spectator mode to match what sighted players see
• The blocks and entities POI range is now 24 blocks by default to better leverage the new object tracker
• Speak relative distance is now on by default to give the player more awareness when dealing with POIs in the object tracker
• Crop growth is now narrated as a percentage instead of ripeness

Others

• Moved docs to GitHub Pages, available at https://docs.mcaccess.org/
• The sound effects overview docs page now contains all sounds currently used by the mod
• The download and faq pages are no longer part of docs and have instead been moved to the landing page
• xdotool is no longer required on Linux
• The accessibility permission is no longer required on MacOS

Bug Fixes

• Fix mouse simulation issues on MacOS
• Fixed hotbar items not being spoken on the NeoForge platform
• Added back doors as POI objects
• Baby entities are now reported (even when they're not animals)
• Leashed entities are now reported (even when they're not animals)
• Entities no longer have to be tamed to be considered as sitting by the mod.
• If a number was at least plus or minus 10 million (like coordinates), it was improperly truncated
• All spoken numbers now correctly only narrate out to the first number after the decimal point if they are a decimal
• 12:00 AM is now correctly narrated when listening to the time with 12 hour format instead of 00:00 AM
• Fence gates will now narrate when open
• The checkbox widget is now narrated as "checkbox checked" or "checkbox unchecked", instead of "button"
• The mod will now narrate the new selected item in your hotbar, even if the previous slot you were on matches
• The mod will no longer apply mouse simulation while typing or while in the keybinds controls menu
• The log4j.xml dev configuration file will no longer be bundled in the production mod jar
• When using RIGHT ALT + CAMERA CONTROLS to snap to cardinal directions, the mod will no longer additionally move the camera in the direction of the pressed camera controls key
• Fixed enchanting table UI reading wrong enchantments
• Flite is no longer required to be installed on Linux
• The accessibility onboarding screen no longer speaks using the vanilla Minecraft voice instead of Minecraft Access
• Features are now initialized each time you join a world, meaning many issues can be resolved by rejoining the world
• Optimized the title screen by skipping all invalid in-game specific functions when you aren't in a world
• Narration of messages other than the initial initializing message are now suppressed when the game is not in focus
• Resolves a bug where the advancements key could remain bound preventing usage of the camera controls
• Mouse click positions should no longer be slightly off in MacOS
• Third-party mods like Jade that use narrateMessage will now speak with Minecraft Access instead of the vanilla narrator voice

Object tracker

Gives the player a better idea of what is around them and allows for controlling what other POI features like locking target. Keybinds:

• PGUP: previous object
• PGDOWN: next object
• CTRL + PGUP: previous group
• CTRL + PGDOWN: next group
• HOME: narrate current object
• END: target nearest object

Minecraft 1.21.5

This is the first release to support Minecraft 1.21.5

New Features

• Speak current perspective when switched to #314
• Blocks and entities can now be narrated with Jade, providing much more detailed information.
• Add basic aim assist for bows (temporarily lock onto the nearest hostile mob when drawing a bow, play sounds indicating how much the bow has been drawn and if the target can be shot)
• Implement support for running the mod on MacOS
• Each function in the access menu can now be bound as a key on your keyboard (all unbound by default aside from narrate target)
• HealthNHunger is now player status
• Made the readout of player status more concise which also delivers values faster
• This includes new information like air, frost exposure, armor, and absorption hearts
• Added a warning for when frost exposure gets above a configurable value (default 30%)
• Hold Alt+R to hear only conditional information like air and frost exposure
• Renamed enableHealthNHunger in the config to enablePlayerStatus (THIS IS A BREAKING CHANGE)

Feature Updates

• Vault and Trial Spawner are added as POI blocks #306
• Remove Position Narrator Format config since it seems duplicate with single number narrating formats
• The narration menu function key key is now deprecated, and has been replaced by the narrate target key as each thing can be bound independently
• The narrator menu was renamed to the access menu to avoid confusion with the existing narrator feature in Microsoft products
• BREAKING CHANGES: Rename Narrator Menu aka F4 Menu to Access Menu
• Access Menu: Access Menu functions can be triggered with Alt + upper number keys
• Your pets, other's pets, bosses, players, and vehicles now have their own sounds
• Dropped item detection also now extends to projectiles on the ground which can be picked up like arrows and tridents
• Air is now measured roughly in seconds remaining, as it is not clear how fast air ticks down for blind players usually
• The default air threshold is now 5 seconds of air remaining, which is roughly the same overall percentage (30%) air remaining
• The mod now announces the biome you entered when you join a world instead of the xp level.

Bug Fixes

• Let Enable Facing Direction config controls auto direction speaking in Camera Controls #327
• Make the Look Straight Back key combination (left alt + numpad 5) works again #328
• You can now hold down keys without them speaking their output over and over
• Fixed smithing table slots being mislabeled
• Some neutral mobs are now recognized as hostile when angry like wolves, instead of always being passive
• Fix equipment narration triggering even if entity doesn't have equipment
• When the locked on block is destroyed, it will automatically be unlocked

Others

• Added an error message when trying to run the mod server-side

Translation Changes

• Weblate is now used for translations.
• Removed coppied strings that were already in use in vanilla, mainly the seperate color strings that Minecraft access had which vanilla translation already provides.

Support 1.21.4

This mod doesn't yet support new features such as crafter and pale garden, but at least you can play the latest version now! Compatibility for 1.21.4:

• Minecraft: 1.21.4 (read setup guide))
• Fabric Loader: >=0.16.9 (download Fabric Loader)
• NeoForge: 21.4.33-beta (download NeoForge installer)
• Java: >=21 (download x64 Windows installer, download page for all Operating Systems)

New Features

• Speak current perspective when switched to #314
• Blocks and entities can now be narrated with Jade, providing much more detailed information.
• Add basic aim assist for bows (temporarily lock onto the nearest hostile mob when drawing a bow, play sounds indicating how much the bow has been drawn and if the target can be shot)
• Implement mouse simulation on MacOS
• Implement speech support on MacOS with queuing and interruption support
• Add a speech settings config menu with a speech rate option for changing the speech rate on MacOS
• Warn the user if Minecraft has not been granted the accessibility permission, which is needed for mouse simulation to work
• Each function in the access menu can now be bound as a key on your keyboard (all unbound by default aside from narrate target)
• HealthNHunger is now player status
• Made the readout of player status more concise which also delivers values faster
• This includes new information like air, frost exposure, armor, and absorption hearts
• Added a warning for when frost exposure gets above a configurable value (default 30%)
• Hold Alt+R to hear only conditional information like air and frost exposure
• Renamed enableHealthNHunger in the config to enablePlayerStatus (THIS IS A BREAKING CHANGE)

Feature Updates

• Vault and Trial Spawner are added as POI blocks #306
• Remove Position Narrator Format config since it seems duplicate with single number narrating formats
• The narration menu function key key is now deprecated, and has been replaced by the narrate target key as each thing can be bound independently
• The narrator menu was renamed to the access menu to avoid confusion with the existing narrator feature in Microsoft products
• BREAKING CHANGES: Rename Narrator Menu aka F4 Menu to Access Menu
• Access Menu: Access Menu functions can be triggered with Alt + upper number keys
• Your pets, other's pets, bosses, players, and vehicles now have their own sounds
• Dropped item detection also now extends to projectiles on the ground which can be picked up like arrows and tridents
• Air is now measured roughly in seconds remaining, as it is not clear how fast air ticks down for blind players usually
• The default air threshold is now 5 seconds of air remaining, which is roughly the same overall percentage (30%) air remaining
• The mod now announces the biome you entered when you join a world instead of the xp level.

Bug Fixes

• Let Enable Facing Direction config controls auto direction speaking in Camera Controls #327
• Make the Look Straight Back key combination (left alt + numpad 5) works again #328
• You can now hold down keys without them speaking their output over and over
• Fixed smithing table slots being mislabele
• Some neutral mobs are now recognized as hostile when angry like wolves, instead of always being passive
• Fix equipment narration triggering even if entity doesn't have equipment
• When the locked on block is destroyed, it will automatically be unlocked

Translation Changes

• Add four items for speaking perspectives I18N PR 37
• Add translation identifiers for the speech settings and speech rate buttons in the configuration menu
• Add a translation identifier for the warning about the accessibility permission not being granted on MacOS
• Changed narrator menu strings to access menu
• Added new strings for all the additional access functions you can bind
• Added 2 new keys for the smithing table and removed the now unused one
• Change air related I18N text for Health And Hunger changes
• Weblate is now used for translations.
• Renamed strings from HealthNHunger to Player Status
• Reordered existing strings like player_status.formatted
• Added new strings to allow for conditional information to be optionally included for frost and air
• Added high frost exposure warning string
• Removed coppied strings that were already in use in vanilla, mainly the seperate color strings that Minecraft access had which vanilla translation already provides.
• GUI slot directions are now dynamically translated, instead of being stored on world load
• Show craftable and show all strings are now translated by the vanilla game in the recipe book instead of being hard coded
• The message that your screen reader was refreshed successfully can now be translated into other languages

Others

• Updated modpack setup instructions to describe when users might want or need a screenreader such as NVDA or JAWS.
• Added an error message when trying to run the mod server-side

Support 1.21.4

This mod doesn't yet support new features such as crafter and pale garden, but at least you can play the latest version now! Compatibility for 1.21.4:

• Minecraft: 1.21.4 (read setup guide))
• Fabric Loader: >=0.16.9 (download Fabric Loader)
• NeoForge: 21.4.33-beta (download NeoForge installer)
• Java: >=21 (download x64 Windows installer, download page for all Operating Systems)

Bug Fixes

• Fix binding sprint to the R key isn't work #310
• Fix can't speak music discs name in inventory screen #311
• Improve vertical facing direction speaking #313
• Now the two methods of look straight up/down work like what manual says (single . and 0, or hold Right Alt then press Up nad Down) . #321

Others

• Game version upgrade to 1.21.1
• Add Braille Bennett's modpack to good resource page
• Update Windows Setup guide to catch up mod changes

For additional information about this release, please check this GitHub release page.

Feature Updates

• Added better naming for unknown (modded) item groups in GUIs

Bug Fixes

• Fixed detection of unknown (modded) item groups in GUIs
• Fix the problem that camera look straight up/down keys don't work #298
• Fix the problem that mod keybindings aren't shown in settings menu

Others

• Update good resource page to include TrueBlindGaming tutorial videos, update beginner guide
• Switch from MinecraftForge to NeoForge from now on

For additional information about this release, please check this GitHub release page.

New Features

• Speak variant of dog, cat, axolotl
• Speak animals and monsters currently wearing equipment
• Speak enchant cost in anvil #277
• Speak hovered tooltip when Inventory Control feature is disabled #281

Bug Fixes

• Fix broken logic after upgrading to 1.20.6

Translation Changes

• Add Italian translation thanks to Discord user @vabax_yt
• New field: entity wearing equipment format
• New field: animal variant format
• New field: variant of dog, cat, axolotl

Others

• Remove architectury-api denpendence
• Remove fabric-api dependence for Fabric
• New guide page: Good Resources

Compatibility

• Minecraft: 1.20.6 (read setup guide)
• Java: >=21 (download x64 Windows installer, download page for all Operating Systems)
• Fabric Loader: >=0.15.11 (download Fabric Loader)

Forge version still can't work

We are facing a weird mixin (remap?) error that the forge build jar file will cause the game crush, we are trying to find the solution. If you know someone can help us, please reach out in issue page or Discord server.

Feature Changes

• Now the Read Crosshair feature will only play the position sound cue once when player looks at different sides of same block.
• When locking on an entity, POI Locking feature will always try to target at a valid position that you can interact with, thus you can attack a monster even it expose small part of its body to you.
• Now POI Locking feature will never let you make eye contact with an Enderman.
• Boat, mine cart, slime, magma cube, and ancient debris can be scanned and locked with POI feature now. #157 #203 #215

Bug Fixes

• Fix the bug that looking at fluid will make Read Crosshair spam. #262

For additional information about this release, please check this GitHub release page.

Bug Fixes

• Fix the bug that locking on Entity will immediately unlock #248
• Fix the bug that mod's INFO log will be logged twice in console and log files #247
• Fix the bug that speaking recipes in Inventory Screen will cause the game crush. #251

For additional information about this release, please check this GitHub release page.

Feature Changes

• Add a new config "Speak Focused Slot Changes" with default "true" value for "Inventory Controls" feature. Close this config if you hear the mod is continuously repeating changes of item name. #242

Changelog is here