Area 51/Mudlet File Locations

From Mudlet
Jump to navigation Jump to search

Staging area for changes to Mudlet File Locations - to be migrated once the corresponding release ships.

Mudlet.ini settings

Mudlet stores most preferences in a per-user Mudlet.ini file inside the config directory shown above (e.g. ~/.config/mudlet/Mudlet.ini on Linux/macOS, %userprofile%\.config\mudlet\Mudlet.ini on Windows). Almost all of these are managed for you through Profile Preferences - the table below documents only the advanced settings that have no UI and must be edited in the file directly.

Edit Mudlet.ini while Mudlet is closed, otherwise your changes may be overwritten on exit.

Key Description Type Default Valid values Available since
highDpiScaleFactorRoundingPolicy Controls how Qt rounds fractional display scale factors (e.g. Windows display scaling at 125%, 150%, 175%). Mudlet 4.19 used Qt 5, which rounded by default; Mudlet 5+ uses Qt 6, which passes fractional scales through unchanged - this can make widgets appear larger than they did in 4.19. Set this to restore the older sizing if you prefer it. The setting has no effect on macOS and is ignored if the QT_SCALE_FACTOR_ROUNDING_POLICY environment variable is set. Values are case-insensitive. string PassThrough PassThrough, Round, RoundPreferFloor, Ceil, Floor 4.21

How each value behaves at common Windows scaling levels:

Value 125% (1.25x) 150% (1.5x) 175% (1.75x)
PassThrough (default) 1.25x 1.5x 1.75x
Round 1x 2x 2x
RoundPreferFloor 1x 1x 2x
Ceil 2x 2x 2x
Floor 1x 1x 1x

Example: to make a Windows machine at 125% display scaling render Mudlet at 100% (matching 4.19 behavior), add the following to Mudlet.ini and restart Mudlet:

highDpiScaleFactorRoundingPolicy=Round

See also