Accessibility

From Vintage Story Wiki
Revision as of 21:54, 11 March 2024 by Barrowisp (talk | contribs) (attempt to add localized links for translation)

This page was last verified for Vintage Story version 1.19.4.


Settings menu

Click on an image to open a larger version. See the Settings page for descriptions of every option, or open the menu in-game and hover over each option. Options that seem especially relevant to accessibility are featured below.

Graphics tab

 
Graphics tab of Settings menu
  • Resolution: If the game looks blurry, increasing the percentage on the Resolution slider to 100% might help.
  • Gamma: Increasing the gamma value might improve visibility in darkness.


The Settings page should cover all the features in the Graphics tab in detail.








Mouse tab

 
Mouse tab of Settings menu
  • Mouse sensitivity: Increase to heighten cursor movement, reducing the need to move the mouse/wrist. Decrease to soften cursor movement, allowing easier precision of cursor placement.
  • Mouse wheel sensitivity: Currently no apparent benefit.
  • Item collect mode: Select the "Always" option to reduce the need to use the Shift key.
  • Mouse Controls: Click on a mouse action, and then use the mouse button or keyboard key you would like to perform that mouse action. Additionally, you can rebind keyboard controls to a mouse button in the Controls tab . For multi-button mice, up to 5 additional buttons are supported.






Controls tab

Any key used in the game can be rebound to something different, which may be important for some players: in general, everyone playing the game for extended periods should set the keys to bindings which are comfortable to use -- also, take breaks!

 
Controls tab of Settings menu
  • Mouse modifiers locked to Sneak/Sprint: Several mouse actions in-game require a combination of either the Shift key or the Ctrl key, as well as a mouseclick (left or right mouse button) - for example, placing down buckets requires both Shift and Ctrl. By default, the Shift key is the key used for Sneak , and the Ctrl key is used for Sprint , and if you are happy with those defaults then this setting is probably not going to be relevant to you. But if you want to change Sneak to a different key, then it becomes important: by default (locked), changing the Sneak control has the effect of changing the key which has to be pressed for Shift + mouseclick actions as well. Some people like that (thinking of it as "Sneak + mouseclick"), some people don't like that at all (they want to change the control for Sneak without changing the normal Shift + mouseclick control ...) If you are one of the people who wants to reconfigure Sneak without reconfiguring the Shift key, then unlocking mouse modifiers means you can keep on using Shift as the Shift key for mouseclicks as normal, even though the Sneak key has changed to something different. Or, if you like, you can leave the Sneak key as it is but change only the key used as the Shift key for mouseclicking. The same applies to the Ctrl key and Sprint which are locked together by default - for example, use this setting if you want to change the Sprint key to Q or R (some people find that more comfortable) but keep on using the Ctrl key for Ctrl + mouse clicks.

People who use the mouse in their left hand might like to change these settings to use the right-hand side R Shift and R Ctrl keys on the keyboard for Shift + mouse click and Ctrl + mouse click actions.

  • In the Mouse tab, the mouse buttons can themselves be reconfigured, for example to swap left and right mouse buttons, or assign a keyboard control instead of a mouse button.

Accessibility tab

 
Accessibility tab of Settings menu

Options:

  • Toggle Sprint: Check this box to reduce the need to use the Sprint key . Tap Sprint once while walking to begin running; your character will continue running without keeping the Sprint key pressed, until you stop moving forward. When you move again it will be at a walking pace.
  • View Bobbing: Uncheck this box if you tend to experience motion sickness. With view bobbing enabled, your character's field of view would bounce up and down while (s)he runs.
  • Camera shake strength: When your character's body temperature drops dangerously low, (s)he will begin shivering and the edges of the screen will become frosty. Increasing the Camera shake strength slider should reduce the degree to which the character's view is disrupted. You'll need to use other indicators such as the frosty screen to warn you of low body temperature. Your character will begin losing health points if you don't take steps to raise her/his body temperature.
  • Wireframe thickness: This affects the thickness of the selection box drawn around the block you are looking at. It also affects the colored voxel gridlines seen when knapping, clay-forming, smithing, and chiseling. Some people may find thicker lines easier to see - especially on very high resolution monitors eg. 4k monitors.
  • Wireframe colors: This determines the colors for the voxel wireframe gridlines when knapping, clayforming, or smithing. Changing to Preset 2 or Preset 3 may improve color contrast for various types of colorblindness or color vision anomaly.
  • Glitch strength waviness: Temporal Storms can be disabled entirely through commands . It might be preferable to preserve this feature of the game while removing effects that are uncomfortable. Reducing the Glitch strength waviness slider should make visual distortions during storms more tolerable. Expect the normal colors of the world to become reddish until the storm ends.

Sound tab

 
Sound tab of Settings menu

The sound levels for various types of sound can be set individually.












Interface tab

 
Interface tab of Settings menu
  • GUI scale: Increasing this slider will make the text larger in most places. However, the field for text might not always be large enough for the selected font size. Experiment to find a text large enough for you to see that is still small enough to fit in its field.
  • Block info overlay: This is a tremendously useful feature, identifying the block/entity your mouse is aimed at. In addition to the name of the item, other useful hints might be included. If it obscures your view, hold Ctrl and press B to toggle the overlay off.
  • Coordinate overlay:
  • Minimap: By default in a Standard playstyle world, a minimap will be visible in the top-right corner of your screen. Press M to show/hide the world map. Press F6 to show/hide the minimap. It's always oriented with north upwards.



Debug tab

Only visible if you check the Developer Mode box in the Interface tab.

Mods

The modding community for Vintage Story has produced several excellent mods that might help with one or more Accessibility issues. Examples of useful mods are listed under the Visual , Dexterity and Auditory headings below.

General guidance for using mods:

  • It's generally safe to add/remove mods even after playing a world for awhile. But best practice includes creating a backup before changing mods. If a mod adds blocks, items, entities, or new worldgen, a backup may be more important.
  • Mods are compatible with specific game versions. If you update the game, check your favorite mods to see if they have also been updated (which is up to the individual mod authors). A mod that hasn't been specifically updated for your current game version can often still work or mostly work. Again, create a backup of your world before experimenting.
  • Code mods - especially if not updated for the current game version or only recently updated - can cause issues or crashes (either directly, or more subtly if they prevent another game system from working properly). Check client-main.txt and server-main.txt logs for reported errors. Report issues to the mod author rather than to Vintage Story staff.
  • In single player games, mods are installed by downloading them and then dragging the zip file into to your VintagestoryData Mods folder. On a Windows PC, the Mods folder is found at %appdata%\VintagestoryData\Mods by default. The mod database has a '1-click install' feature that puts the zip file directly into the Mods folder rather than the Downloads folder; this only applies to the most-recently-published version of the mod, though.
  • When you join a multiplayer server, the required mods are automatically downloaded to a specific subfolder for that server, within your single-player mod folder. To also use one of your single-player client-side mods in multiplayer, copy-paste it into that server's subfolder. Several accessibility mods are client-side only, meaning that you can use them even on multiplayer servers without causing problems. Some mods would require the server admins to install them.
  • The mod landscape is ever-changing; a mod perfect for your issue might exist yet not be mentioned below, or a mod you relied on might be incompatible with the latest version of the game. If you find a mod that you think deserves to be noted on this Accessibility page, make a comment in the #wiki-and-translations channel of the Vintage Story Discord server. If you use an outdated mod without problems, consider making a comment on that's mod's page of the mod database, so other potential users can see the encouraging news.

Visual

Gamma

The Graphics tab of the Settings menu has a slider for Gamma, which might improve ability to see in some situations.

World map

The map prior to version 1.19 was colorful and could be used to locate resources when familiar with their appearance from a birds-eye view. The classic world map visuals can be restored in a singleplayer world using the command /worldconfig colorAccurateWorldmap true in the chat overlay; then exit and re-launch that world for the change to take effect.

In a multiplayer world, the classic world map can only be restored by someone with admin privileges editing the serverconfig file or running a similar command.

  • enables for all players on the server: /worldconfigcreate bool colorAccurateWorldmap true
  • enables for individual players: /player [playername] privilege grant colorAccurateWorldmap

Restart the server for changes to take effect.

GUI scale

The scale of the GUI - which also includes the size of items in the hotbar, and the size of the mouse pointer - can be adjusted in Settings / Interface.

Note: it is possible to make the GUI so large that the Interface tab is off the screen, when you next visit Settings, especially from the main menu. If this occurs, the guiScale number can be adjusted by editing the clientsettings.json file in a text editor. Find this file in the %appdata%\Roaming\VintagestoryData folder. The default is "guiScale": 1.0, -- be sure to include the comma at the end of the line!

Windows Magnifier

If using the Windows Magnifier to enlarge parts of the screen, note that the mouse pointer (and therefore the ability to control the Magnifier) will disappear during normal gameplay. To make the mouse pointer visible again, hold down the Alt key.

Audio handbook

Guides from the in-game Survival Handbook are read aloud here: Vintage Story Handbook.

Individual item/block pages are not included.

Visual mods

Epilepsy and other motion sensitivity
Some mods give greater control over visual effects such as lightning flashes and the screen warping during Temporal Storms or drunkenness.


Color vision deficiency
Some mods help players to distinguish the block selection box (the outline around the currently looked at block)

  • Better Outline mod [1] can change the color of the block selection box, or add glow effects etc., to make it more visible.


Light
Some mods give greater control over the lighting levels.


Resources visibility
Some mods make key resources easier to distinguish from their surroundings.


Map

Dexterity and repetitive actions

Key mapping

See Controls tab.

Hardware

While Vintage Story has no native controller support, some people use Steam to add controller support, and others use third party apps (like Antimicro). Controller Compatibility has an example. Others get Vintage Story to work on a Steam Deck.

An ergonomic mouse might be helpful - but minimizing repetitive stress also includes considerations of posture, taking breaks, and more.

Dexterity Mods

Several mods modify one or more aspects of the game to reduce repetitive motions.

Crafting


Movement


Map


Resources

Auditory

The Sound tab in the Settings menu lets you adjust "ambient sound" volume separately from weather volume and music.
See Considerations in the Notes section .

Hardware

Headphones are useful for identifying the source of a sound, which can help you avoid danger or find resources. Game version 1.19 includes a new 'Directional Audio' option, designed to make sound location sound more precise with headphones: we suggest try both with it on and off and see which you prefer.

Assets

You can replace audio files individually.

  • AppData\Roaming\Vintagestory\assets\game\sounds primarily sounds related to the player
  • AppData\Roaming\Vintagestory\assets\survival\sounds sounds related to creatures, processes, and weather, including thunder
  • AppData\Roaming\Vintagestory\assets\assets\game\music a few music files
  • AppData\Roaming\Vintagestory\assets\survival\music most music files
  • AppData\Roaming\Vintagestory\assets\creative\music a few music files

Auditory Mods

Some mods give greater control over the volume levels of sounds that may be disturbing.

Some mods give visual alternatives to auditory cues.

Other accessibility issues

One of the dev team members created tutorial videos that might be of help to people with dyslexia, low literacy, or dislike of reading. Vintage Story Bit-By-Bit - How to Handbook on YouTube

History

  • A few Accessibility features were added in version 1.19.0: "Added Accessibility tab. Moved View Bobbing and Toggle Sprint settings there. Added 2 new accessibility settings: Camera shake strength and Wireframe thickness.
    • Tweak: Added ability to adjust temporal instability waviness in the new Accessibility tab
    • Tweak: Added experimental minbrightness client config, potential use for YouTubers/streamers to prevent pitch-black areas." Official Devlog
    • Feature: In the Accessibility settings tab, knapping, clayforming, smithing voxel wireframe colors are now configurable between different presets. In addition to the standard setting, two alternative presets for these colors are provided, chosen for better contrast for players with certain types of color blindness (color vision anomaly) Official Devlog
    • Feature: Re-bindable mouse buttons Official Devlog

Notes

  • Tyron gave permission for this page to include brief descriptions of mod functionality. In general, this wiki is only for vanilla content.[1]

Audio considerations

  • Bees are an important resource that can be difficult to find. The most-recommended technique is to increase the Ambient Sound slider and decrease the Weather Sound and Music sliders while hunting for beehives.
  • Wolves are a dangerous enemy that can often be avoided due to their periodic howls announcing their location.
  • Bears growl but usually the player is within attack range when that happens.
  • Low Temporal Stability triggers ominous music. The player should take action to reduce the stability drain and restore stability soon.

Speculation needing testing:

  • If you simply delete an audio file, the game might crash.
  • When you update to the next game version, you might lose the changes made.

Gallery

 
Accessibility tab of Settings menu










See also

References

  1. Comment in the #wiki-and-translations channel of the official Discord: https://discord.com/channels/302152934249070593/420476226420080670/1208117493772849272