DS2Revival/mods/common/ini_comment_history.txt
DS2Revival a1e2f8f9b5
Some checks failed
build / build (push) Failing after 1m35s
CI: build on the project's own runner at git.dsii.uk
2026-10-27 22:02:02 -04:00

845 lines
64 KiB
Text

# Comment blocks of mods/common/DS2Revival.ini that some version shipped, one block per paragraph (blank line between).
# Generated by tools/ini_comment_history.py from git history; append only. See there.
; DS2 Revival settings - one file for all of its plugins, in the game's scripts folder.
;
; Every setting is listed here with its default value. Change a value and restart the game; a missing line means the default.
; One [section] per plugin. Delete a plugin's .asi file to turn that plugin off completely; a section without its plugin
; does nothing. Yes/no settings: 1 = on, 0 = off.
; Broken World reads the main game's scripts\DS2Revival.ini (the plugin copies in "Broken World\scripts" follow it).
; Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist; if both
; exist this one wins and the plugin logs that the old file is ignored.
;
; Sections: [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; [Controller] [Input] [Prompts] [Menus] [World] DS2Controller.asi (optional preview, not installed by default)
; [Tactics] DS2Tactics.asi (optional preview, not installed by default)
; ======================================================================================================================
; DS2Multiplayer.asi - online play and LAN without GameSpy
; ======================================================================================================================
; The multiplayer server that replaces the dead GameSpy (host name or IP). 127.0.0.1 = a server on this PC.
; Hosting behind a router without port forwarding: games go through the server.
; auto = only when needed, always = every game, off = never (the host must forward UDP 2302).
; DirectPlay transport. auto = Windows DirectPlay when it is installed, otherwise our replacement (also on Linux/Steam Deck
; under Proton, whose built-in DirectPlay cannot host); native = Windows DirectPlay only; shim = always the replacement.
; Both kinds of player can be in the same game.
; News in the game: where the game's version check goes (its "new patch available" banner becomes the news banner).
; https://dsii.uk = the project site; an http://host:port address for a test server; empty = leave it alone.
; 0 = the version check shows the game's own text instead of the news banner.
; Broken World's News screen (it asks www.gaspowered.com): 1 = show the revival news there too, 0 = leave it.
; Steam copies have no CD key: 1 = give them a per-user identity (never touches the registry's game keys), 0 = off.
; Advanced: a fixed identity number for the virtual CD key. Empty = a random one kept per Windows user.
; Advanced: the product id served to the game.
; Advanced: the distribution id served to the game; it only gates the version check (news banner).
; auto = 1 while NewsUrl is usable, else 0; or a number.
; 1 = when the game looks up its own host name it gets only the main IPv4 address, which stops LAN games failing with
; "name is already in use" on PCs with several network adapters.
; Re-enable the Multiplayer button of the main menu (the Steam build greys it out).
; Fix the START button staying disabled in a fresh session's staging screen.
; Do not ask the Windows Firewall question when hosting (see "Firewall setup.cmd").
; Seconds a direct (IP) connection is tried before it gives up.
; Create the multiplayer server when you enter a lobby, so a fresh session can host.
; Close the lobby screens when you leave a lobby instead of leaving them on screen.
; Warn (and offer Windows' installer) when DirectPlay is missing and the replacement is not in use.
; Offer the game's hidden 8-player modes when hosting (Old School Mode, Couples Mode++); only the host needs this.
; ======================================================================================================================
; DS2Fixes.asi - bug fixes that need no setting; here you can switch single fixes off
; ======================================================================================================================
; The game installs a system-wide keyboard hook that makes typing lag in every other program. 1 = it is not installed.
; The game changes the mouse cursor twice per mouse event (stutter while moving or clicking). 1 = those calls are filtered.
; Rotating the camera with the middle mouse button recentres the cursor every frame; 1 = keep that stable at any frame rate.
; The game's vertex upload (shadows, particles, character meshes) read up to 168 bytes past the end of its data and could
; crash. 1 = fixed.
; The "below minimum specification" box that graphics chips unknown to the game get at the first start. 1 = not shown.
; The Gas Powered Games newsletter form at the first single-player start. 1 = skipped.
; Give back the animation memory (about 7 MB per region) of objects left behind when you leave a region, so long sessions do
; not run out of address space. 1 = on, 0 = off, auto = on for Dungeon Siege II, off for Broken World (not proven there yet).
; How long (seconds) an object must be out of view before its animation memory is released.
; Diagnostic: 1 = count the dormant-animation hook calls and cycles in the log.
; A Documents path with characters the game's code page cannot hold (a Cyrillic or Chinese user name on an English Windows)
; makes the game save into its install folder. 1 = the game is given an ASCII path (a junction in %ProgramData%\DS2Revival).
; A few seconds after the start, check that Documents\My Games\<game> can be written and say why if not (Controlled folder
; access, security software) instead of the game's silent fallback. 1 = on.
; Language packs under a Windows that uses UTF-8 for legacy programs break text, typing and saves.
; auto = code page 1252 only when Windows uses UTF-8 for legacy programs; off or 0 = leave everything alone;
; a number = force that code page (e.g. 1252, or 1251 for a Cyrillic pack).
; ======================================================================================================================
; DS2Widescreen.asi - window, scaling, interface size, anti-aliasing, sharpening, texture filtering, camera, photo mode
; Quick answers: sharpening off = Sharpen=0; anti-aliasing off = AntiAliasing=off; bigger interface = HudScale=2;
; uncapped frame rate = MaxFps=0; the game's own video modes = Mode=off.
; Needs Mode=borderless (the default): MenuScale, HudScale, HudFilter, AntiAliasing, Sharpen, SSAO, [Photo].
; ======================================================================================================================
; How the game's window is made.
; borderless = a frameless window the size of your screen (works with every Steam launch option and the Steam overlay; the
; 800x600 / 1024x768 menus are scaled to fit with black bars); window = the game's normal window; off = leave the game's
; video alone (exclusive fullscreen at its own modes).
; The size the 3D world is rendered at. desktop = your screen's size; or WIDTHxHEIGHT such as 1280x720 (stretched to fit with
; the aspect ratio kept; a smaller size also makes the interface bigger; a size above your screen is refused by the game).
; The frame limiter. refresh = your screen's refresh rate; 0 = no limit; a number = that many frames per second.
; "maxfps=" on the game's command line wins.
; How the 800x600 / 1024x768 menus are enlarged. sharp = whole-number enlargement with hard pixels, then a smooth shrink to
; fit; integer = whole multiples only (black border, perfectly sharp); smooth = the old blurry driver stretch.
; Size of the in-game interface. auto = screen height / 720 (1080p 1.5, 1440p 2, 2160p 3; snapped to a whole number within
; 0.05, off below 1.2); 1 = off; or a number from 1 to 4 such as 1.25 or 2.
; Interface scaling filter at fractional scales. sharp = crisp text; smooth = plain bilinear; point = nearest.
; Anisotropic texture filtering (sharper ground textures at a slant; any mode). 16 = default, capped at what your graphics
; card supports; 0 or 1 = the game's own filtering; 2, 4, 8 = weaker.
; Shifts the texture detail level the graphics card picks (any mode). 0 = the game's own; negative = sharper (and shimmerier).
; The game forgets its "Shaders" video option at every start, so glow, water and shine stay off. fix = read it correctly;
; game = leave the game's behaviour.
; Size of the shadow pictures in pixels (Steam v2.3 only; the game uses 256). game = leave it; 512, 1024, 2048 or 4096 = sharper.
; Multiplayer hero portraits at the top left are black above 1280 pixels wide. 1 = fixed.
; Smooths jagged edges of the 3D world (SMAA 1x; text and interface stay sharp). smaa or off.
; Contrast-adaptive sharpening of the 3D world after anti-aliasing. 0 = off, up to 1 = strongest.
; Experimental ambient occlusion. off, on, or debug-depth / debug-ao (show the depth or the occlusion alone, for testing).
; SSAO sample radius in game units and strength.
; After a failed graphics reset (alt-tab, overlay) retry for 10 seconds instead of ending at once. 0 = the game's behaviour.
; Once per frame check that the plugin's Direct3D hooks are still installed. 0 only for diagnosing.
; Diagnostic: 1 = write cursor-recentring statistics to the log once a second.
; NVIDIA RTX Remix support. auto = the Remix profile when ".trex\NvRemixBridge.exe" is next to the game, else normal;
; remix = force the profile; d3d9 = never. The profile turns off MenuScale filtering, HudScale, AntiAliasing, Sharpen, SSAO,
; Anisotropy, TextureLodBias and Shaders. The next four apply to the Remix profile only.
; Draw a sky in the fog colour so Remix has one.
; Do not draw the shadow pass (Remix would take it for the main camera).
; Build the game's mouse pointer in the game process (Remix shows none).
; A dim directional light in the menus: red,green,blue, or off.
; An empty setting is off (the game's own value).
; Field of view. auto = a wide screen sees more to the sides instead of less above and below; game = the original view;
; or a vertical angle in degrees from 20 to 100, e.g. 55.
; Zoom out further: 1.5 or 2 times the game's limit (at most 4). Fog and view distance move out with the camera.
; Flattest camera angle in degrees (at least 5; the game stops at 32).
; Steepest camera angle in degrees (at most 89; the game stops at 85).
; Zoom per mouse-wheel notch as a fraction of the zoom range (at most 0.9; the game uses 0.25), e.g. 0.1.
; Photo mode: pauses a single-player game (never multiplayer), hides the interface and names, frees the camera limits.
; A key is a name (Insert, Return, Delete, PageUp, PageDown, Home, End, Pause, F1-F12, a letter or digit, ...) or a
; virtual-key number; none = off.
; Toggle photo mode (the same key leaves it; Escape also does). none turns the whole photo mode off.
; In photo mode: save a PNG of the world without the interface into the game's Screenshots folder (needs Mode=borderless).
; In photo mode: detach the camera from the party (W A S D fly, R / F up / down, arrows or the middle button look, wheel =
; forward / back, Shift = fast); the same key brings the party camera back.
; In photo mode, hold: wider / narrower field of view.
; Zoom limit in photo mode, times the game's (1-5).
; Camera angle limits in photo mode, degrees above the ground (MinPitch 5-60, MaxPitch 60-89).
; Field of view limits in degrees (FovMin 10-60, FovMax 60-140) and speed in degrees per second (5-120).
; Free camera speed in metres per second (0.5-60).
; How far the free camera may leave the loaded part of the world (0-500). 0 = from the map.
; 1 = no selection rings and no hover outline in the picture, 0 = keep them.
; ======================================================================================================================
; DS2BrokenWorld.asi - starts Broken World, imports Steam heroes, frame-rate fix
; ======================================================================================================================
; Starting the game starts Broken World when it is installed in the "Broken World" folder (hold Shift for the original game).
; auto = do that; off = never start Broken World.
; Broken World can read heroes made in the Steam game (it refused their file format). 1 = allow.
; Content CRCs (hexadecimal, separated by comma or space) whose heroes are accepted in addition to the known list.
; The default is the Steam game's data.
; Single player only: also list heroes saved with other game data (e.g. old Broken World saves from a retail install).
; Multiplayer and the vault keep the strict list. 0 = off.
; The frame-rate fix for PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V, Docker...). 1 = on.
; Undo a repacker's edits of Broken World's mouse handling (cursor recentring). 1 = on.
; Let Broken World find binkw32.dll and mss32.dll in the main game's system folder when its own is missing. 1 = on.
; The Dungeon Siege 2 folder, if Broken World is not in a "Broken World" folder inside it. Empty = the folder above.
; ======================================================================================================================
; DS2ModLoader.asi - drop-in mods (a "Mods" folder next to DungeonSiege2.exe, one folder per mod)
; ======================================================================================================================
; 0 = load no mods
; The mods folder, relative to the game's folder (or a full path). Each mod is a folder in it.
; 0 = only archives (.ds2res/.ds2map), no loose files (and no glTF files)
; Broken World: also load the main game's Mods folder (before Broken World's own). Which of those mods Broken World takes is
; up to each mod (optional file <mod folder>\modinfo.ini: [Mod] Games=ds2 / bw / both). Without Games=, a main-folder mod
; loads in both games, but in Broken World its loose files whose path Broken World's own archives also hold are skipped.
; glTF models (.glb/.gltf) in mods are used directly (converted at start-up into Mods\.cache when they changed). 0 = ignore.
; ======================================================================================================================
; DS2Controller.asi (optional preview, not installed by default) - gamepad support; the sections do nothing without it
; ======================================================================================================================
; 0 = the plugin does nothing.
; SDL3 gamepad backend: PlayStation 4/5, Switch, Xbox and generic pads, with the real type behind Steam Input.
; XInput stays as the fallback when SDL is off or finds nothing.
; 0 turns off SDL's HIDAPI drivers (raw PlayStation/Switch access); pads then work as plain DirectInput/XInput devices.
; Troubleshooting only: extra SDL hints, ';' separated, e.g. SDL_JOYSTICK_RAWINPUT=0;SDL_JOYSTICK_DIRECTINPUT=0
; Which physical face button confirms: auto (south, but east on Nintendo pads), south, east.
; Short vibration when a radial wheel opens and commits.
; Radial stick deadzone, 0..90 percent.
; Log physical/test button edges for a controller smoke test; normally off.
; Button glyphs and the hint bar while the pad is the active input (Xbox letters, PlayStation symbols, Nintendo letters).
; Menu focus repeat while a direction is held: delay before repeating (150-1500 ms) and interval (60-1000 ms).
; 0 = no stick movement in the world (menus and prompts still work).
; Broken World reads this base-game ini too. 0 turns controller movement off there (verified on by default).
; Movement orders per second (2-10).
; How far ahead of the hero the stick aims, in percent of the view (5-35).
; 1 = A attacks again while held (auto-repeat); 0 = once per press (the native click behaviour).
; 0 lets the hero speak "ok" on every stick move order (the old click-to-move acknowledgement).
; Camera uses proportional time-slicing of the game's bound arrow keys (10..100%).
; Virtual-key numbers: customize these if the game's key bindings differ from the stock Steam configuration (1-255).
; ======================================================================================================================
; DS2Tactics.asi (optional preview, not installed by default) - programmable companion tactics; does nothing without it
; Rule files live in the "Tactics" folder next to this file (copy mods\tactics\presets there). Guide: docs\tactics.md
; ======================================================================================================================
; How often the rules are looked at, in milliseconds (50 or more).
; The rule file to use: its name without ".tactics" in the Tactics folder (e.g. Cautious). Empty = no rules (the game's own
; behaviour). A file named party_<your hero's name>.tactics in the same folder wins for that party.
; 1 = a companion may drink a potion while it is carrying out an order you gave (the order carries on afterwards).
; Client machines: how long (milliseconds, 1000 or more) a player order counts as still running.
; DS2 Revival settings - one file for all of its plugins, in the game's scripts folder.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, delete its .asi file from the scripts folder. A section whose plugin is not installed does nothing.
; * Broken World reads the main game's scripts\DS2Revival.ini. You do not need a second copy in "Broken World\scripts".
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. The installer moves your old values here.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; ======================================================================================================================
; DS2Widescreen.asi - window and resolution, interface size, frame limiter, camera, photo mode
; DS2Graphics.asi - the graphics (GPU) options, section [Graphics] below
; Quick answers: sharpening off = Sharpen=0 [Graphics]; anti-aliasing off = AntiAliasing=off [Graphics]; bigger interface =
; HudScale=2; uncapped frame rate = MaxFps=0; the game's own video modes = Mode=off.
; ======================================================================================================================
; The size the 3D world is rendered at. desktop = your screen's size; or WIDTHxHEIGHT such as 1280x720 (rendered at that size
; and stretched to fit with the aspect ratio kept; a smaller size also makes the interface bigger; a size above your screen is
; refused by the game). It does not change your monitor's video mode.
; The game's frame limiter (not vsync). refresh = your screen's refresh rate; 0 = no limit; a number = that many frames per
; second. "maxfps=" on the game's command line wins.
; How the 800x600 / 1024x768 menus are enlarged (Mode=borderless only). sharp = whole-number enlargement with hard pixels,
; then a smooth shrink to fit; integer = whole multiples only (black border, perfectly sharp); smooth = the old blurry stretch.
; Size of the in-game interface (Mode=borderless only). auto = screen height / 720 (1080p 1.5, 1440p 2, 2160p 3; snapped to
; a whole number within 0.05, off below 1.2); 1 = off; or a number from 1 to 4 such as 1.25 or 2. Decimals are fine.
; Interface scaling filter at fractional scales (Mode=borderless only). sharp = crisp text; smooth = plain bilinear;
; point = nearest.
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the installer moves them. Anti-aliasing, sharpening and SSAO have so far been tested with
; Mode=borderless only.
; Smooths jagged edges of the 3D world (SMAA 1x; text and interface stay sharp): smaa or off.
; Anisotropic texture filtering (sharper ground textures at a slant). 16 = default, capped at what your graphics card
; supports; 0 or 1 = the game's own filtering; 2, 4, 8 = weaker.
; Shifts the texture detail level the graphics card picks. 0 = the game's own; negative = sharper (and shimmerier).
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the installer moves them. DS2Graphics works without DS2Widescreen and in every Mode (borderless,
; window, off); SSAO is still experimental.
; Smooths jagged edges of the 3D world (SMAA 1x; text and interface stay sharp): smaa or off.
; DS2 Revival settings - one file for all of its plugins, in the game's scripts folder.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, delete its .asi file from the scripts folder. A section whose plugin is not installed does nothing.
; * Broken World reads the main game's scripts\DS2Revival.ini. You do not need a second copy in "Broken World\scripts".
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else. Delete
; the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the plugins move them. Anti-aliasing, sharpening and SSAO have so far been tested with
; Mode=borderless only.
; Smooths jagged edges of the 3D world (SMAA 1x; text and interface stay sharp): smaa or off.
; The glow around crystals, lanterns and magic is drawn at 256x256 and looks blocky and shimmery at today's resolutions. A number
; = the same glow drawn at that size (done in memory, no files written): 512 (default), 1024, or 2048; 0 = the game's own glow.
; Replaces the old ModsFinerGlow folder (you can delete it). Only your own screen changes.
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the plugins move them. DS2Graphics works without DS2Widescreen and in every Mode (borderless,
; window, off); SSAO is still experimental.
; Smooths jagged edges of the 3D world (SMAA 1x; text and interface stay sharp): smaa or off.
; DS2 Revival settings - one file for all of its plugins, in the game's scripts folder.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World reads the main game's scripts\DS2Revival.ini. You do not need a second copy in "Broken World\scripts".
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else. Delete
; the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; 1 = on, 0 = off (the same as deleting its .asi; one switch covers Dungeon Siege II and Broken World).
; Players in an online game all need DS2Multiplayer.
; Broken World runs these same plugin files (loaded from this folder by "Broken World\scripts\DS2Revival.asi").
; 1 = on in both games; 0 = off in both (the same as deleting its .asi); ds2 = on in Dungeon Siege II only;
; bw = on in Broken World only. Example: DS2Graphics=ds2 keeps the graphics plugin out of Broken World.
; Players in an online game all need DS2Multiplayer.
; Before starting Broken World, rename the 2018 repack's Resources\Widescreen Fix.ds2res to .off: DS2Widescreen does its job, and
; it changes the game data checksum, so players with and without it could not join each other. 0 = keep it.
; Content CRCs (hexadecimal, separated by comma or space) whose heroes are accepted in addition to the known list.
; The default: the Steam game's data, and Broken World with the 2018 repack's Widescreen Fix.ds2res (75112728).
; DS2 Revival settings - one file for all of its plugins, in the game's scripts folder.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World reads the main game's scripts\DS2Revival.ini. You do not need a second copy in "Broken World\scripts".
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else. Delete
; the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; ======================================================================================================================
; DS2Fixes.asi - bug fixes, all on by default; here you can switch single ones off
; ======================================================================================================================
; Once per frame check that the plugin's Direct3D hooks are still installed. With the native Direct3D 9 driver on AMD cards the
; game dropped them a few frames after the start, so the graphics options silently did nothing. 0 only for diagnosing.
; ======================================================================================================================
; DS2BrokenWorld.asi - starts Broken World, imports Steam heroes and old saves, frame-rate fix, DLL search
; ======================================================================================================================
; Heroes are listed (single player, multiplayer, the vault) when they were made with a known edition of the game, by content id:
; D4EE6791 Steam Dungeon Siege 2 v2.3 D4EE4A9F the GOG exe (fixed files v3)
; 790BFE9F Broken World 75112728 Broken World with the 2018 repack's Widescreen Fix.ds2res
; CA03370A DE60C4EB 1A300219 older Dungeon Siege 2 versions (built into the games) AB123ABC the disc's premade heroes
; The log names the edition ("party made with the GOG exe"). 0 = only what the game itself knows.
; More content CRCs (hexadecimal, separated by comma or space) whose heroes are accepted, e.g. a modded game's id from the log.
; Single player only: also list heroes saved with other game data (a mod, a retail install). The log says "unknown game data,
; accepted in single player". Multiplayer and the vault stay strict for ids not in the table above. 0 = off.
; The game's own exclusive fullscreen (Mode=off, or fullscreen=true on the command line) shows no mouse pointer on Windows 10
; and 11. 1 = the pointer is brought back there (two checks of the game that hide it are skipped in memory, in Dungeon Siege II
; and in Broken World; a Broken World exe that has those two edits already keeps them). Nothing changes in borderless / window.
; When the host's game differs from yours (another DungeonSiege2.exe file, another version) the game used to stay silently
; in the staging area when the host started; 1 = say so and go back to the game list. 0 = the game's own behaviour.
; DS2 Revival settings - one file for all of its plugins, in the game folder next to DungeonSiege2.exe.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World started from the Steam game's "Broken World" folder reads this same file, next to the main game's
; DungeonSiege2.exe: one file for both games, no second copy needed. (A Broken World folder on its own, with no Dungeon
; Siege II around it, keeps its own DS2Revival.ini next to its DungeonSiege2.exe.)
; * Versions 1.2.0 and 1.2.1 kept this file in the "scripts" folder. The first start of a newer version moves it here (your
; values stay). The plugins' log files are in "scripts\logs" (DS2Widescreen.log, ...): send those when you report a problem.
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else. Delete
; the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; Broken World runs these same plugin files (loaded from the main game's scripts folder by "Broken World\scripts\DS2Revival.asi").
; 1 = on in both games; 0 = off in both (the same as deleting its .asi); ds2 = on in Dungeon Siege II only;
; bw = on in Broken World only. Example: DS2Graphics=ds2 keeps the graphics plugin out of Broken World.
; Players in an online game all need DS2Multiplayer.
; Hero portraits at the top left are wrong above 1280 pixels wide: black in Dungeon Siege II multiplayer, dark and garbled in
; Broken World (single player too). 1 = fixed.
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the plugins move them. DS2Graphics works without DS2Widescreen and in every Mode (borderless,
; window, off); SSAO is still experimental.
; Smooths jagged edges of the 3D world (text and interface stay sharp). msaa4+smaa = 4x multisampling plus SMAA: the cleanest
; picture (edges, and the leaf cut-outs that multisampling alone leaves jagged); msaa2 / msaa4 / msaa8 = multisampling only (sharp
; textures, the same kind of anti-aliasing as dgVoodoo's); smaa = SMAA only (cheapest, slightly softer textures); off = none.
; "msaa4+smaa" and the like need no other tool: you do not need dgVoodoo for anti-aliasing. A sample count your graphics card
; does not support is lowered to the best it has, and if none works the plugin falls back to SMAA (the log says which).
; MSAA turns SSAO off (SSAO needs the single-sampled depth), and RevalidateHooks=0 disables MSAA (SMAA is used instead).
; The 3D scenes of the menus (hero selection and creation) are anti-aliased with SMAA before the interface is drawn, so their
; text stays crisp. auto = SMAA unless AntiAliasing=off; smaa = always; off = never.
; DS2 Revival settings - one file for all of its plugins, in the game folder next to DungeonSiege2.exe.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World started from the Steam game's "Broken World" folder reads this same file, next to the main game's
; DungeonSiege2.exe: one file for both games, no second copy needed. (A Broken World folder on its own, with no Dungeon
; Siege II around it, keeps its own DS2Revival.ini next to its DungeonSiege2.exe.)
; * Versions 1.2.0 and 1.2.1 kept this file in the "scripts" folder. The first start of a newer version moves it here (your
; values stay). The plugins' log files are in "scripts\logs" (DS2Widescreen.log, ...): send those when you report a problem.
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else - with
; one exception: when a new version changes the DEFAULT of a setting (1.3: AntiAliasing smaa -> msaa4+smaa), a value that
; is still the old default is changed to the new one, once (the log says so; [Settings] at the end of this file). A value
; you set yourself is never changed. Delete the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; DS2Graphics.asi: the graphics (GPU) options. Older files had these in [Display]; the plugin still reads them there when
; [Graphics] lacks the key, and the plugins move them. DS2Graphics works without DS2Widescreen and in every Mode (borderless,
; window, off); SSAO is still experimental.
; Smooths jagged edges of the 3D world (text and interface stay sharp). msaa4+smaa = 4x multisampling plus SMAA: the cleanest
; picture (edges, and the leaf cut-outs that multisampling alone leaves jagged); msaa2 / msaa4 / msaa8 = multisampling only (sharp
; textures, the same kind of anti-aliasing as dgVoodoo's); smaa = SMAA only (cheapest, slightly softer textures); off = none.
; "msaa4+smaa" and the like need no other tool: you do not need dgVoodoo for anti-aliasing. (A file from 1.2.x that still had
; the old default, smaa, gets msaa4+smaa once at the first start of 1.3; if you prefer smaa, set it again, it stays.) A sample count your graphics card
; does not support is lowered to the best it has, and if none works the plugin falls back to SMAA (the log says which).
; MSAA turns SSAO off (SSAO needs the single-sampled depth), and RevalidateHooks=0 disables MSAA (SMAA is used instead).
; Written by the plugins - do not edit. Which defaults this file has been brought up to. When a version changes the default of a
; setting, a value that is still the old default is changed once, then this number is raised so it is never done again (a file
; without this line is from 1.2.x). Values you set yourself are never touched.
; What fills the side bars around the menus on a wide screen (Mode=borderless only). black = black bars; blur = a dark,
; strongly blurred copy of the menu picture (it moves with the menu); blurlight = a lighter, less dark blur; mirror = the picture
; mirrored outwards, dark. Experimental.
; Single player: when the last conscious hero falls but a level-up (experience arriving after the killing blow) stands them
; up again, the game still showed "Defeat / Respawn" and sent the party back to the start. 1 = the hero simply plays on:
; the pending defeat is cancelled (a death that a level-up undoes is not a defeat). A real defeat is unchanged.
; What fills the side bars around the menus on a wide screen (Mode=borderless only). blur (default) = a dark,
; strongly blurred copy of the menu picture (it moves with the menu); black = black bars; blurlight = a lighter, less dark blur; mirror = the picture
; mirrored outwards, dark.
; Experimental. The game creates a new Direct3D device at every menu <-> world change. If something outside the game (a Steam or
; capture overlay) keeps each old device alive, they pile up (about 15 driver threads and a lot of memory each, see the thread count
; in the log lines "d3dhub: device created") until the game runs out of memory. 1 = keep one device for the whole session: the game's
; request for a new one is answered by resetting the same device (the same call a window resize or alt-tab makes), so nothing is left
; behind; if the reset is refused the game's own new device is used. 0 = the game's behaviour.
; DS2 Revival settings - one file for all of its plugins, in the game folder next to DungeonSiege2.exe.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World started from the Steam game's "Broken World" folder reads this same file, next to the main game's
; DungeonSiege2.exe: one file for both games, no second copy needed. (A Broken World folder on its own, with no Dungeon
; Siege II around it, keeps its own DS2Revival.ini next to its DungeonSiege2.exe.)
; * Versions 1.2.0 and 1.2.1 kept this file in the "scripts" folder. The first start of a newer version moves it here (your
; values stay). The plugins' log files are in "scripts\logs" (DS2Widescreen.log, ...): send those when you report a problem.
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and brings the explanatory
; comments above the settings up to its text (a comment you wrote or changed yourself is kept). It changes no value - with
; one exception: when a new version changes the DEFAULT of a setting (1.3: AntiAliasing smaa -> msaa4+smaa), a value that
; is still the old default is changed to the new one, once (the log says so; [Settings] at the end of this file). A value
; you set yourself is never changed. Delete the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; Written by the plugins - do not edit. Which defaults this file has been brought up to. When a version changes the default of a
; setting, a value that is still the old default is changed once, then this number is raised so it is never done again (a file
; without this line is from 1.2.x). Values you set yourself are never touched. (3: the explanatory comments of older files were
; refreshed once; the plugins keep them current at later starts.)
; DS2 Revival settings - one file for all of its plugins, in the game folder next to DungeonSiege2.exe.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; [Logging] all of them (the log file)
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World started from the Steam game's "Broken World" folder reads this same file, next to the main game's
; DungeonSiege2.exe: one file for both games, no second copy needed. (A Broken World folder on its own, with no Dungeon
; Siege II around it, keeps its own DS2Revival.ini next to its DungeonSiege2.exe.)
; * Versions 1.2.0 and 1.2.1 kept this file in the "scripts" folder. The first start of a newer version moves it here (your
; values stay). The plugins' log file is "scripts\logs\DS2Revival.log": send it when you report a problem ([Logging] below).
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and changes nothing else - with
; one exception: when a new version changes the DEFAULT of a setting (1.3: AntiAliasing smaa -> msaa4+smaa), a value that
; is still the old default is changed to the new one, once (the log says so; [Settings] at the end of this file). A value
; you set yourself is never changed. Delete the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; ======================================================================================================================
; All plugins - the log file
; ======================================================================================================================
; The plugins write ONE log file per game start, "scripts\logs\DS2Revival.log" (Broken World started from the Steam game:
; "DS2Revival.bw.log"), every line tagged with the plugin's name; the last three runs are kept as DS2Revival.1.log ... .3.log.
; By default it holds what helps to find a problem: versions, settings, what went wrong, one line per feature. 1 = also every
; patch address and the fine detail of what the features do while you play (long; only for bug reports when asked).
; DS2 Revival settings - one file for all of its plugins, in the game folder next to DungeonSiege2.exe.
;
; Every setting is listed here with its default value. Change a value and restart the game; a line you remove means the
; default. One [section] per feature group. Yes/no settings: 1 = on, 0 = off.
;
; [Network] [Multiplayer] DS2Multiplayer.asi
; [Fixes] DS2Fixes.asi
; [Display] [Camera] [Photo] DS2Widescreen.asi
; [Graphics] DS2Graphics.asi
; [BrokenWorld] DS2BrokenWorld.asi
; [ModLoader] DS2ModLoader.asi
; [Logging] all of them (the log file)
; (The controller plugin, an optional extra, has its own DS2Controller.ini.)
;
; COMMON MISCONCEPTIONS
; * Deleting a section, a line or this whole file does NOT turn anything off: the plugins then use the defaults listed here.
; To turn a plugin off, set it to 0 under [Plugins] below (or delete its .asi). A section whose plugin is not installed does nothing.
; * Broken World started from the Steam game's "Broken World" folder reads this same file, next to the main game's
; DungeonSiege2.exe: one file for both games, no second copy needed. (A Broken World folder on its own, with no Dungeon
; Siege II around it, keeps its own DS2Revival.ini next to its DungeonSiege2.exe.)
; * Versions 1.2.0 and 1.2.1 kept this file in the "scripts" folder. The first start of a newer version moves it here (your
; values stay). The plugins' log file is "scripts\logs\DS2Revival.log": send it when you report a problem ([Logging] below).
; * Old per-plugin files (DS2Multiplayer.ini, DS2Widescreen.ini, ...) are only used when this file does not exist. If both
; exist this file wins and the plugin says in its log which one it used. When the plugins create this file (the first
; start) they move the values you had changed in the old files here and rename those to .old.
; * This file is created by the plugins at the first start and is not part of the download, so an update never overwrites it.
; A new version adds its new settings to this file (with their comments) at the next start and brings the explanatory
; comments above the settings up to its text (a comment you wrote or changed yourself is kept). It changes no value - with
; one exception: when a new version changes the DEFAULT of a setting (1.3: AntiAliasing smaa -> msaa4+smaa), a value that
; is still the old default is changed to the new one, once (the log says so; [Settings] at the end of this file). A value
; you set yourself is never changed. Delete the file to get the default one back.
; * Mode and Resolution: with the default Mode=borderless the window is as big as your desktop and the game never changes
; your monitor's video mode. Resolution=1280x720 only makes the game render at that size and scale it up to fill the screen.
; * HudScale, HudFilter and MenuScale only apply with Mode=borderless. HudScale accepts decimals (1.5, 1.75), not only 1, 2, 3.
; * MaxFps is the game's frame-rate limiter (the game stops at 75 in a window; "refresh" = your monitor's refresh rate,
; 0 = no limit). It is not vsync, and it does not make the game faster.
; * Sharpen=0 turns the sharpening filter off completely (AntiAliasing=off does the same for anti-aliasing). Sharpen is gentle
; by default (0.2); older versions used 0.4.
; * The [Graphics] options (anti-aliasing, sharpening, anisotropy, Shaders, ShadowSize, FinerGlow) work in every Mode, also the
; game's own fullscreen and window; only the photo-mode picture needs borderless.
; * Broken World uses the same plugins and settings as the main game. Its own old plugin copies in "Broken World\scripts" are
; retired (only DS2Revival.asi is needed there). Old Broken World saves load (AcceptAnySaveSinglePlayer).
; * FastCpuid (Broken World) only matters on PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V,
; Docker, ...); elsewhere it changes nothing, and it is safe to leave on.
; * DirectPlay=auto needs no Windows feature: with Windows DirectPlay missing, the game uses the plugin's own replacement.
; * You do not need port forwarding to host: Relay=auto sends the game through the server only when a joiner cannot
; connect directly. Everyone in an online game needs DS2Multiplayer.
; The round corner radar (minimap) at the screen's full resolution instead of inside the scaled interface (only with HudScale
; above 1): 1 = its lines stay clean while the camera turns; 0 = drawn with the rest of the interface (the old look, shimmers).
; How the native-resolution radar samples its map (RadarNative=1 only). smooth = bilinear (steady, soft lines while the camera turns);
; point = the game's own look (crisp texels, thin lines jump from pixel to pixel when the map rotates).
; The frame-rate fix, part 1 (the common Broken World exe): its copy protection's call table is filled in at start-up and its one
; busy protected function is restored from your Steam DungeonSiege2.exe, so the protection code no longer runs while you play.
; Another exe, or no Steam v2.3 exe found: FastCpuid below does the job. 1 = on.
; The frame-rate fix, part 2, for PCs where Windows runs its hypervisor (Memory Integrity, WSL2, Hyper-V, Docker...): the
; protection's CPU checks are answered from a cache. Not needed when BindSlots worked (the log says so). 1 = on.