Updated version number and changelog

Removed unnecessary/unused return value in critter_mod_skill function
Merge pull request #611 from sfall-team/dependabot/bundler/docs/faraday-2.14.1
2026-07-27 16:52:34 -07:00 · 2026-02-11 22:07:01 +08:00 · 2026-02-11 22:05:58 +08:00 · 2026-02-10 06:22:44 +08:00 · 2026-02-09 22:08:17 +00:00 · 2026-01-27 16:37:08 +08:00
348 changed files with 2244 additions and 1392 deletions
@@ -22,11 +22,11 @@ on:
 jobs:
 Build:
  name:    sfall
-  runs-on: windows-2019
+  runs-on: windows-2022
  steps:

  - name: Clone sfall
-    uses: actions/checkout@v4
+    uses: actions/checkout@v6

  # Action is used twice for self-testing only
  # DevXP build results are intentionally *not* included in artifact
@@ -55,8 +55,8 @@ jobs:
    shell: bash

  - name: Upload artifacts
-    uses: actions/upload-artifact@v4
+    uses: actions/upload-artifact@v6
    with:
     name:           sfall-build
     path:           sfall-build
-     retention-days: 14
+     retention-days: 30
@@ -7,19 +7,19 @@ on:

 jobs:
  deploy:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
      - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6

      - name: Setup Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
        with:
          python-version: '3.x'

      - name: Install dependencies
        run: |
-          sudo apt -y -qq install bundler python3-pip
+          sudo apt update && sudo apt -y -qq install bundler python3-pip
          pip3 install ruamel.yaml --user

      - name: Build
@@ -1,5 +1,65 @@
 # Changelog

+## 4.4.9
+* Fixed the edge-scrolling speed when using the game speed tweak
+* Fixed incorrect unarmed damage being displayed in the inventory under specific conditions
+* Fixed a crash bug in the tweak that replaces death animations on critters with single-frame variants on map load
+* Improved the functionality of **Fallout1Behavior** to set the correct initial in-game time
+* Changed **ProcessorIdle** to be enabled by default
+* Changed **SingleCore** to be disabled by default as its usage is questionable on newer systems
+* Added a fix for script execution issues when calling `critter_mod_skill` in a loop
+* Added options to the **tweaks ini file** to override the PID of the mirrored shades and the stat they affect when equipped
+
+## 4.4.8
+* HRP: Fixed a crash and a visual glitch in the interface bar at ultrawide resolutions
+* HRP: Fixed splash screen display when the file is packed in an uncompressed **.dat** file
+* Fixed incorrect mnemonic names in script dumps generated by the script decompiler (`int2ssl.exe` in the **modders pack**)
+* Added a fix for a crash when an encounter between two groups fighting each other fails to spawn one group
+* Added a fix to use the `art\splash\` directory as the fallback for loading splash screens for non-English languages
+* Added a fix for the game not applying the mouse sensitivity setting correctly in certain cases
+* Added a fix for file seeking in uncompressed **.dat** files
+* Added an option to disable the engine's processing of Arroyo-related events
+* Added support for switching to alternate keyboard character codes (from Crafty)
+
+## 4.4.7
+* Fixed potential undefined behavior in **FullItemDescInBarter**
+* Fixed the behavior of `break` statement in script compiler and decompiler (`compile.exe` and `int2ssl.exe` in the **modders pack**)
+* Improved the fix for removing floating text messages on the map when moving to another map or elevation
+* Improved the error handling for missing main **.dat** files
+* Removed glass glare from the **'Use Inventory Item On'** window to match other game interfaces
+* Added a fix for a crash when a critter with a powered melee/unarmed weapon runs out of ammo and there is ammo nearby
+* Added a fix to prevent a potential crash when using skills on non-critter objects
+* Added a fix for the duplicate click sound for the 'Done' button in the **'Move Items'** and **'Set Timer'** windows
+* Added a few fixes for slightly misaligned buttons in the pipboy, character screen, and barter screen
+* Added missing sounds to the 'Done' and 'Cancel' buttons in the 'Custom' disposition of the combat control panel
+* Added lowercase `a` as a hotkey for the 'Take All' button (previously only uppercase `A`)
+
+## 4.4.6.1
+* The compatibility mode check now targets only unsupported Windows versions
+* Changed the way **ProcessorIdle** works to prevent conflicts with **CPU_USAGE_FIX** option in `f2_res.ini`
+* Added a fix to prevent out-of-bounds selection in the file list when loading a character file
+* Added a fix to remove visible newline control characters `\n` when examining items in the barter screen
+
+## 4.4.6
+* Fixed a bug introduced in 4.3.1 that broke the debug message about a missing critter art file
+* Fixed an issue where an item with a unique ID in the inventory had its ID reset by a non-unique item
+* Restored the position of the ammo bar when **ALTERNATE_AMMO_METRE=0** in `f2_res.ini`
+* Improved the fix for the display issue in the pipboy when the automap list is too long
+* Improved the compatibility mode check for newer Windows
+* Changed **PipBoyAvailableAtGameStart** option and `set_pipboy_available` script function to no longer modify the vault suit movie state
+* Added a fix for the main menu music not stopping when replaying the intro
+* Added a fix for display issues when highlighting a multiline dialogue option
+* Added a fix for the incorrect message being displayed when attempting to repair a dead robot
+* Added a fix for the duplicate click sound when selecting a location in the Status section of the pipboy
+* Added a fix for extra hidden buttons below the location list in the Status section of the pipboy
+* Added a fix for map lighting from **Night Vision** perk not updating when loading a saved game
+* Added a fix for an animation glitch when death animations and combat start simultaneously
+* Added a fix to prevent the game from hanging when reloading a weapon overloaded with ammo via the interface bar
+* Added a few fixes for issues related to weapons with negative ammo
+* Added a tweak to replace death animations on critters with single-frame variants on map load
+* Added more options for tweaking some engine perks to the **perks ini file**
+* Reduced the green tone of the message window on the interface bar for text clarity
+
 ## 4.4.5.1
 * HRP: Fixed the behavior of **IFACE_BAR_WIDTH** for a modified `fallout2.exe` with Chinese/Japanese support
 * Fixed a bug in **XPTable** that caused leveling issues with **Here and Now** perk
@@ -9,7 +69,7 @@
 * Fixed a bug introduced in 4.2.9 that caused `game_loaded` script function to always return 1 when called from normal scripts
 * Fixed a bug introduced in 4.4.4 that caused the information card for the **hero appearance mod** not to refresh properly
 * Fixed a crash bug in **AutoSearchSFX** when an **ACM** file has a name longer than 12 characters
-* Fixed an issue with sfall not resetting data properly after attempting to load a corrupted saved game
+* Fixed an issue where sfall did not reset data properly after attempting to load a corrupted saved game
 * Fixed the inconsistent behavior of the escaped percent sign `%` in `sprintf` and `string_format` script functions
 * Fixed `show/hide_iface_tag` script functions to prevent unnecessary toggling of tags
 * Fixed `using_skill` script function returning garbage values when the arguments are not the player and Sneak skill
@@ -160,7 +220,7 @@
 * New script function: `get_terrain_name`

 ## 4.3.5
-* HRP: Fixed movie subtitles not showing up when setting **MOVIE_SIZE=1** with certain combinations of screen and movie aspect ratios
+* HRP: Fixed movie subtitles not showing up when **MOVIE_SIZE=1** with certain combinations of screen and movie aspect ratios
 * HRP: Disabled **IFACE_BAR_WIDTH** and **SCALE_BUTTONS_AND_TEXT_MENU** for a modified `fallout2.exe` with Chinese/Japanese support to prevent garbled text
 * HRP: Added support for **SPLASH_SCRN_TIME** option in `f2_res.ini`
 * Fixed the handling of obsolete script functions that are still recognized by script compiler and decompiler
@@ -170,7 +230,7 @@
 * Removed **ComputeSprayMod** from `ddraw.ini`. Now **ComputeSpray_\*** options no longer require a master switch
 * Added a fix for a crash when the player equips a weapon overloaded with ammo
 * Added a fix for being able to use the **'Push'** action on members of the player's team in combat when they are knocked down
-* Added missing sounds for the markers on the world map interface (similar to Fallout 1, from Ghosthack)
+* Added missing sounds to the markers on the world map interface (similar to Fallout 1, from Ghosthack)

 ## 4.3.4
 * HRP: Fixed a few issues with the main menu
@@ -182,7 +242,7 @@
 ## 4.3.3.1
 * HRP: Fixed a possible crash in combat when enabling **EXTRA_WIN_MSG_CHECKS**
 * HRP: Fixed broke console messages when enabling **ConsoleOutputPath**
-* HRP: Fixed the main menu still being stretched when setting **MAIN_MENU_SIZE=0**
+* HRP: Fixed the main menu still being stretched when **MAIN_MENU_SIZE=0**
 * Fixed a bug introduced in 4.3.1 that caused the game to print an incorrect item name in some cases
 * Fixed screenshots for **DX9** graphics modes. Now the screenshots are saved in **PNG** format when in **DX9** mode
 * Improved the functionality of **AllowDShowMovies**. Now you can take screenshots and press any key to skip **AVI** movies
@@ -218,7 +278,7 @@

 ## 4.3.1
 * Fixed the Jet addiction not being removed when using the antidote in some cases
-* Fixed the key repeat delay and rate when enabling the game speed tweak
+* Fixed the key repeat delay and rate when using the game speed tweak
 * Fixed a possible crash at the end of the playback of alternative sound files
 * Fixed a rounding error in Glovz's damage formula
 * Fixed and improved **NPC combat control mod** and the behavior of **SpeedInterfaceCounterAnims=3**
@@ -247,7 +307,7 @@
 * Added support for using the newline control character `\n` in the object description in `pro_*.msg` files
 * Added support for the new **'Healing Item'** flag to item protos. Now AI will also use items with this flag for healing in combat
 * Added support for the new **'Cannot Use'** flag to the misc flags of item objects. This flag makes a weapon object unusable in combat
-* Added missing sounds for the buttons on the world map interface (similar to Fallout 1 behavior)
+* Added missing sounds to the buttons on the world map interface (similar to Fallout 1 behavior)
 * Added 5 `metarule3` macros for controlling the save slot with scripts to `sfall.h` in the **modders pack**
 * New script functions: `set_scr_name`, `obj_is_openable`
 * Updated **NPC armor appearance mod** in the **modders pack** to prevent NPCs from equipping **unusable** weapons
@@ -287,7 +347,7 @@
 * Added a fix to prevent the player name from being displayed at the bottom of the dialog review window when the text is longer than one screen
 * Added a fix for the in-game quest list not being in the same order as in `quests.txt`
 * Added a fix for multihex critters hitting themselves when they miss an attack with ranged weapons
-* Added a fix to the placement of multihex critters in the player's party when entering a map or elevation
+* Added a fix for the placement of multihex critters in the player's party when entering a map or elevation
 * Added a fix to the starting position of the player's marker on the world map when starting a new game
 * Added a fix for AI not checking the safety of weapons based on the selected attack mode
 * Added a fix for the incorrect check and AP cost when AI reloads a weapon
@@ -297,7 +357,7 @@
 * Added a tweak to prevent NPC aggression when non-hostile NPCs accidentally hit the player or members of the player's team
 * Added a tweak to play the **'magic hands'** animation when using an item on an object. This also prevents a few issues with scripted animations not playing
 * Added a tweak to remove the unspent skill points limit
-* Added an option to disable the special handling of city areas 45 and 46 in the engine when visiting Area 45
+* Added an option to disable the engine's special handling of city areas 45 and 46 when visiting Area 45
 * Added a new value to **AIDrugUsePerfFix** to allow NPCs to use only the drugs listed in `chem_primary_desire` and healing drugs
 * Added support for loading premade character **GCD/BIO** files from the `premade\<language>\` directory for non-English languages
 * Added support for loading fonts from the `fonts\<language>\` directory for non-English languages
@@ -380,7 +440,7 @@
 * Fixed the default values for **Movie1 - Movie17** options
 * Fixed the playback of additional movies defined in **Movie18 - Movie32** options
 * Fixed **OverrideMusicDir=2** not overriding the music path properly
-* Fixed incorrect Melee Damage stat value being displayed when setting **BonusHtHDamageFix=1** and **DisplayBonusDamage=0**
+* Fixed incorrect Melee Damage stat value being displayed when **BonusHtHDamageFix=1** and **DisplayBonusDamage=0**
 * Fixed `attack_complex script` function not setting result flags correctly for the attacker and the target
 * Fixed and improved **SFX** and speech playback for alternative sound files
 * Fixed and improved the behavior of nested timer events in global scripts
@@ -659,7 +719,7 @@
 * Added a fix to prevent the reserved object IDs of the player and party members from being generated for other objects
 * Added a fix for the display issue in the pipboy when the automap list is too long
 * Added a fix for the `start` procedure not being called correctly if the required standard script procedure is missing (from Crafty)
-* Added an option to disable the special handling of map IDs 19 and 37 in the engine when entering the maps
+* Added an option to disable the engine's special handling of map IDs 19 and 37 when entering those maps
 * Added support for the new **'automap=yes/no'** parameter to `maps.txt`. This parameter overrides the hardcoded values for displaying the map in the pipboy automaps for the first 160 maps
 * Added a new **'picking up item'** event to `HOOK_INVENTORYMOVE` hook script
 * Added files for using 32-bit images for talking heads to the **modders pack**
@@ -684,7 +744,7 @@
 * Added a fix for the reserved item FRM being displayed in the top-left corner when in the loot/barter screens
 * Added a fix for the active effects of drugs not being saved properly
 * Added a fix for NPC stuck in a loop of reloading melee/unarmed weapons when out of ammo
-* Added a fix for critters not being healed over time when entering the map if **'dead_bodies_age=No'** is set in `maps.txt`
+* Added a fix for critters not being healed over time when entering a map with **'dead_bodies_age=No'** set in `maps.txt`
 * Added a fix for corpses being removed early after returning to the map
 * Added a fix for the removal of party member's corpse. Now items in party member's inventory are not removed along with the corpse
 * Added an option to change the timer for deleting corpses on a map after you leave
@@ -807,7 +867,7 @@ Various bug fixes and features based on the work by Mr.Stalin:
 Original engine bug fixes and various features based on the work by Mr.Stalin:
 * Implemented a **code injection system for game hooks**. In previous versions, the code of game hooks was always executed even if there is no corresponding hook script. Now the code of a game hook only gets injected into the game when the corresponding hook script exists
 * Code refactoring for some hook scripts
-* Fixed an issue with file IDs of additional game msg files being shifted when a file in **ExtraGameMsgFileList** is missing
+* Fixed an issue where the file IDs of additional game msg files were shifted when a file in **ExtraGameMsgFileList** was missing
 * Fixed `obj_can_see_obj` script function not checking if source and target objects are on the same elevation before calling `HOOK_WITHINPERCEPTION` hook script
 * Improved the functionality of **ExtraGameMsgFileList** to allow manually assigning numbers to specific msg files
 * Improved the functionality of `HOOK_AMMOCOST` hook script when **CheckWeaponAmmoCost** is enabled
@@ -887,7 +947,7 @@ Original engine bug fixes and various features based on the work by Mr.Stalin:
 ## 4.0
 * The build environment is now **Visual Studio 2015**, and Win XP SP2 and Win 2000 are no longer supported
 * Extensive code reorganizing/rewrite was made in the effort to tidy up sfall code base accumulated over the years and make it easier to read, understand, and extend. Main code was split into separate **'modules'**. Code for interacting with Fallout 2 engine was moved and expanded to allow for engine manipulations without using too much Assembly code
-* Fixed an issue with the game being rendered before the **hero appearance mod** is loaded
+* Fixed an issue where the game was rendered before the **hero appearance mod** was loaded
 * **Item highlighting mod** is moved from sfall into a separate script (`gl_highlighting.int`) and extended with new options
 * **NPC combat control mod** is moved from sfall into a separate script (`gl_partycontrol.int`)
 * Related options of **item highlighting** and **NPC combat control** mods were moved from `ddraw.ini` into a separate `sfall-mods.ini`
@@ -929,7 +989,7 @@ Original engine bug fixes and various features based on the work by Crafty:

 Original engine bug fixes and various features based on the work by Crafty:
 * Added a fix for a crash when clicking on empty space in the inventory list opened by **'Use Inventory Item On'** (backpack) action icon
-* Added a fix for negative SPECIAL values in character creation
+* Added a fix for negative SPECIAL values in the character creation
 * Added a fix for the game hanging in an endless loop in combat mode when calling `anim` script functions inside `damage_p_proc`
 * Added 3 new arguments to `HOOK_BARTERPRICE` hook script

@@ -1040,7 +1100,7 @@ Original engine bug fixes and various features based on the work by Crafty:
 * Added a fix for the original engine issue that caused party members to have incorrect stats when they level up while on drugs
 * Added a fix for the unlimited ammo exploit
 * Added a fix for negative values in Skilldex window
-* Added a fix for the clickability issue in the pipboy and an exploit that allows resting in places where you shouldn't be able to
+* Added a fix for the clickability issue in the pipboy and an exploit that allows resting in restricted areas
 * Added a fix to prevent **'Too Many Items'** bug from corrupting save files
 * Added a fix for the exploit that you can gain stats from more than two doses of a specific chem after save/load
 * Added a fix for the original engine issues with reverse order of items in memory relative to visual order in the inventory list
@@ -1,8 +1,8 @@
 # sfall

 [![License](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Dev Build](https://github.com/phobos2077/sfall/actions/workflows/build.yml/badge.svg?branch=develop)](https://github.com/phobos2077/sfall/actions/workflows/build.yml)
-[![GitHub Pages](https://github.com/phobos2077/sfall/actions/workflows/gh-pages.yml/badge.svg)](https://github.com/phobos2077/sfall/actions/workflows/gh-pages.yml)
+[![Dev Build](https://github.com/sfall-team/sfall/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/phobos2077/sfall/actions/workflows/build.yml)
+[![GitHub Pages](https://github.com/sfall-team/sfall/actions/workflows/gh-pages.yml/badge.svg)](https://github.com/phobos2077/sfall/actions/workflows/gh-pages.yml)

 A set of engine modifications for the classic game Fallout 2 in the form of a DLL, which modifies executable in memory without changing anything in EXE file itself.

@@ -46,7 +46,7 @@ You need to set DLL overrides for `ddraw.dll` to __"native, builtin"__ in `winec

 ### Prerequisites:

-* Visual Studio 2015 with **Windows XP support for C++** component. If you're using Visual Studio 2017/2019/2022, make sure to install **VS 2015 C++ build tools (v140)**.
+* Visual Studio 2015 with **"Windows XP support for C++"** component. If you're using Visual Studio 2017/2019/2022, make sure to install **"VC++ 2015.3 v14.00 (v140) toolset for desktop"** component as well.
 * [DirectX SDK (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=6812). You will also need `ddraw.lib` from DXSDK February 2010 and `dinput.lib` from DXSDK August 2007. Both files can be found in the [DirectX SDK Collection repo](https://github.com/NovaRain/DXSDK_Collection).
 * [DirectX Runtime (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109). You can also install it from DirectX SDK installer.

@@ -56,6 +56,19 @@ You need to set DLL overrides for `ddraw.dll` to __"native, builtin"__ in `winec
 2. Open the solution file and build with the **ReleaseXP** configuration (this is the one used for sfall releases).
 3. If everything is set up correctly, you should have a new sfall `ddraw.dll` in your Fallout 2 directory.

+### Minimalist Setup:
+
+If you don't need a full-fledged IDE, you can use Visual Studio Build Tools instead. Taking [Visual Studio 2017 Build Tools](https://aka.ms/vs/15/release/vs_buildtools.exe) for example:
+1. Install using the command line:
+   ```
+   vs_BuildTools.exe --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.140 --add Microsoft.VisualStudio.Component.WinXP --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.WinXP --passive
+   ```
+2. Set up a `postbuild.cmd` using the template from the repo.
+3. Use MSBuild in **x86 Native Tools Command Prompt** to build sfall:
+   ```
+   MSBuild.exe ddraw.sln /t:Clean;Build /p:Configuration=ReleaseXP /p:Platform=Win32
+   ```
+
 ## Additional info

 * [Changelog](CHANGELOG.md)
@@ -85,6 +85,17 @@ runs:
          echo "dir=$(cygpath --windows "$DXSDK_DIR/DXSDK_Jun2010/")" >> $GITHUB_OUTPUT
   shell: bash

+ # Install VS 2015 C++ build tools and WinXP Support components via Chocolatey
+ - name:  Prepare VS 2015 C++ build tools
+   id:    vs2015_tools
+   run:   |
+          echo "::group::Prepare VS 2015 C++ build tools"
+
+          choco install visualstudio2017buildtools --package-parameters "--add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.140 --add Microsoft.VisualStudio.Component.WinXP --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.WinXP --passive"
+
+          echo "::endgroup::"
+   shell: bash
+
 # MSBuild is not in PATH on Windows machines
 # Using $GITHUB_OUTPUT to make sure workflow environment remains unchanged
 - name:  Prepare MSBuild
@@ -2,11 +2,17 @@

 ;When adding extra perks to a mod, it's advisable to use the fake perk scripting functions rather than make
 ; modifications in this file, as some perks have hardcoded effects which may catch you out
+;Set the bonus value to 0 in the 'PerksTweak' section for perks to get around this problem

-;Since traits need to be picked before any scripts run, they have an additional NoHardcode option in this file which can
-; be used to remove their hardcoded effects, and add new stat/skill effects
+;Since traits need to be picked before any scripts run, they have an additional 'NoHardcode' option in this file
+; which can be used to remove their hardcoded effects, and add new stat/skill effects

+;##############################################################################
 [PerksTweak]
+;Changes the light level bonus for 'Night Vision' perk (ID 9)
+;valid range: 0..100, 20 - default bonus
+NightVisionBonus=20
+
 ;Changes the Outdoorsman skill bonus for 'Survivalist' perk (ID 16)
 ;125 - maximum bonus, 25 - default bonus
 SurvivalistBonus=25
@@ -15,6 +21,20 @@ SurvivalistBonus=25
 ;25 - default bonus
 MasterTraderBonus=25

+;Changes the skill point bonus for 'Educated' perk (ID 18)
+;125 - maximum bonus, 2 - default bonus
+EducatedBonus=2
+
+;Changes the hit point bonuses for 'Healer' perk (ID 19)
+;999 - maximum bonus, 4 - default bonus
+HealerMinBonus=4
+;999 - maximum bonus, 10 - default bonus
+HealerMaxBonus=10
+
+;Changes the hit point bonus for 'Lifegiver' perk (ID 28)
+;125 - maximum bonus, 4 - default bonus
+LifegiverBonus=4
+
 ;Changes the Science and Repair skill bonus for 'Mr.Fixit' perk (ID 31)
 ;125 - maximum bonus, 10 - default bonus
 MrFixitBonus=10
@@ -64,6 +84,10 @@ VaultCityInoculationsRadBonus=10
 ;valid range: -12..20, 3 - default bonus
 CautiousNatureBonus=3

+;Changes the percentage bonus for 'Comprehension' perk (ID 81)
+;50 - default bonus
+ComprehensionBonus=50
+
 ;Changes the damage bonus per level for 'Demolition Expert' perk (ID 82)
 ;999 - maximum bonus, 10 - default bonus
 DemolitionExpertBonus=10
@@ -77,8 +101,9 @@ GamblerBonus=20
 HarmlessBonus=20

 ;Changes the damage bonus and the Doctor skill bonus for 'Living Anatomy' perk (ID 97)
-;125 - maximum bonus, 5 - default bonus, 10 - default skill bonus
+;125 - maximum bonus, 5 - default damage bonus
 LivingAnatomyBonus=5
+;125 - maximum bonus, 10 - default skill bonus
 LivingAnatomyDoctorBonus=10

 ;Changes the Speech and Barter skill bonus for 'Negotiator' perk (ID 99)
@@ -154,7 +179,6 @@ Enable=0
 ;Skill3-Skill5: The skill to be modified (or -1 for none)
 ;Skill3Mod-Skill5Mod: The increased/decreased value to the modified skill

-;##############################################################################
 ;This is a modification to vanilla perk 0
 [0]
 Name=Example
@@ -1,4 +1,13 @@
 [sfall]
+;Table for overriding ASCII codes for keyboard character input when entering the player's name and saved game descriptions
+;Only character codes in the ASCII range 33-126 can be overridden
+;Character codes that do not need to be overridden can be omitted by using commas as delimiters
+;You must also set a key for switching layouts using the XltKey option in ddraw.ini
+;Default character code table for the English layout (letter codes only)
+;XltTable=,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,,,,,,,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,,,,
+
+;##############################################################################
+
 SaveInCombat=Cannot save at this time.
 KarmaGain=You gained %d karma.
 KarmaLoss=You lost %d karma.
@@ -2,7 +2,6 @@

 [Main]

-
 [Items]
 ;Override the PIDs of the standard healing drugs that AI will use in combat
 ;Set to -1 if you don't want AI to identify this item as a healing drug
@@ -11,3 +10,10 @@
 STIMPAK=40
 SUPER_STIMPAK=144
 HEALING_POWDER=273
+
+;Overrides the PID of the item that grants a +1 stat bonus when placed in an active item slot
+;Default is 433. Set to -1 to prevent any item from granting the bonus
+MIRROR_SHADES_PID=433
+;The SPECIAL stat number (0..6) to which the bonus is applied
+;Default is 3 (Charisma). Set to -1 to disable the item's effect
+MIRROR_SHADES_STAT=3
@@ -1,9 +1,12 @@
 sfall's main configuration options appear in ddraw.ini, but there are several other configuration files that it can read in for modding purposes.

-Books.ini: Lets you override/add books to the game (associated object PIDs, skills and text messages)
+Books.ini: Lets you override/add books to the game (associated object PIDs, skills, and text messages)
+Drugs.ini: Lets you override/add drugs to the game (associated object PIDs, addiction duration, and text messages)
 Perks.ini: Lets you override the name/description/frm image/other stats of perks and traits
-Elevators.ini: Lets you override which elevators lead where
+Elevators.ini: Lets you override which elevators lead to where
 CriticalOverrides.ini: Lets you make modifications to the critical hit tables
 Translations.ini: Contains some text strings which sfall displays, to allow their translation
 Skills.ini: Lets you change the formula used for calculating skills
 Stats.ini: Lets you change the formula used to calculate the derived stats
+Tweaks.ini: Lets you override a few object PIDs used in the engine
+Unarmed.ini: Lets you configure the requirements and effects of unarmed attacks
@@ -1,5 +1,5 @@
 ;sfall configuration settings
-;v4.4.5.1
+;v4.4.9

 [Main]
 ;Set to 1 to enable the built-in High Resolution Patch mode that is similar to the hi-res patch by Mash
@@ -7,7 +7,7 @@
 HiResMode=1

 ;Set to 1 if you want to use command line arguments to tell sfall to use another ini file
-;This option is always enabled in 4.3.3/3.8.33 or later. The information is left for reference only
+;This option is always enabled in 4.3.3/3.8.33 or later and cannot be disabled (kept for reference only)
 UseCommandLine=0

 ;Uncomment and point to a file to get alternate translations for some sfall messages
@@ -156,7 +156,7 @@ AllowSoundForFloats=0
 ;This does not effect the play_sfall_sound and stop_sfall_sound script functions
 AllowDShowSound=0

-;Set to 1 to override the default music path with data\sound\music\ if music_path is not present in the cfg
+;Set to 1 to override the default music path with data\sound\music\ if music_path is not present in fallout2.cfg
 ;Set to 2 to overwrite all occurrences of the music path
 OverrideMusicDir=1

@@ -228,7 +228,7 @@ SpeedKey9=0x00

 ;A key to hold down to move the window around when using DX9 graphics mode 5
 ;Set to 0 if you don't want to use a modifier key, or a DX scancode otherwise
-;Set to -1 for either ctrl key, -2 for either alt key or -3 for either shift key
+;Set to -1 for either Ctrl key, -2 for either Alt key, or -3 for either Shift key
 WindowScrollKey=0

 ;A key to press to reload your currently equipped weapon or use the active item
@@ -254,12 +254,17 @@ ItemMoveSkipDragKey=29
 ;Requires sfall debugging mode and FalloutDebug.exe from the modders pack
 DebugEditorKey=0

+;A key to press to switch the keyboard layout (uses character codes from the XltTable option in Translations.ini)
+;Set to 1 for Num Lock, 2 for Caps Lock, 3 for Scroll Lock, or 0 to disable
+XltKey=0
+
 ;XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 [Misc]
 ;Changes some of Fallout 2 engine functions to Fallout 1 behavior:
-;- disables playing the final movie/credits after the endgame slideshow
-;- disables halving the weight for power armor items
-;- endgame_movie script function plays movie 10 or 11 based on the player's gender before the credits
+;- the final movie/credits are not played after the endgame slideshow
+;- the weight of power armor items is not halved
+;- the endgame_movie script function plays movie 10 or 11 based on the player's gender before the credits
+;- the initial in-game time is set to 7:21
 Fallout1Behavior=0

 ;Time limit in years. Must be between -3 and 13
@@ -310,7 +315,7 @@ UseFileSystemOverride=0
 ;Set to 1 to change the order of how the engine loads game data
 ;Old: patchXXX.dat > critter_patches > critter_dat > f2_res_patches > f2_res_dat > master_patches > master_dat
 ;New: master_patches > critter_patches > [ExtraPatches] > patchXXX.dat > sfall.dat > critter_dat > f2_res_patches > f2_res_dat > master_dat
-;This option is always enabled in 4.3/3.8.30 or later. The information is left for reference only
+;This option is always enabled in 4.3/3.8.30 or later and cannot be disabled (kept for reference only)
 DataLoadOrderPatch=1

 ;Set to 1 to load alternative dialog msg files from text\<language>\dialog_female\ for female PC
@@ -361,8 +366,8 @@ Movie17=credits.mve
 ;LocalMapXLimit=480
 ;LocalMapYLimit=400

-;Set to 1 if you want the pipboy to be available at the start of the game
-;Set to 2 to make the pipboy available by only skipping the vault suit movie check
+;Set to 1 to make the pipboy and the vault suit available when the game starts
+;Set to 2 to make only the pipboy available
 PipBoyAvailableAtGameStart=0

 ;Set to 1 to double the number of available kill types
@@ -401,7 +406,7 @@ ViewXPos=-1
 ViewYPos=-1

 ;Set to 1 to force Fallout not to use multiple processor cores even if they are available
-SingleCore=1
+SingleCore=0

 ;Set to 1 to override the art_cache_size setting in fallout2.cfg
 OverrideArtCacheSize=0
@@ -418,7 +423,7 @@ SaveInCombatFix=1
 ;Set to 1 to enable additional weapon animation codes from 'o' to 't'
 ;The 4 byte value at 0x39 of weapon protos may range from 0 to 15 rather than 0 to 10
 ;Since the letters 'n' and 'r' are in use for other animations, an animation code of 11 corresponds to 's' and 15 to 't'
-;This option is always enabled in 4.4.1/3.8.41 or later. The information is left for reference only
+;This option is always enabled in 4.4.1/3.8.41 or later and cannot be disabled (kept for reference only)
 AdditionalWeaponAnims=1

 ;Uncomment these lines to modify the default modifiers for aimed shots at specific bodyparts
@@ -455,11 +460,8 @@ PlayIdleAnimOnReload=0
 ;Default is 6. Set to 0 for a 12-hour timer
 CorpseDeleteTime=6

-;Set a number of milliseconds to idle each input loop
-;Set to -1 to disable
-;Set to 0 to idle only if other processes are waiting for processor time (WinXP/2000: if processes have equal priority)
-;Set to 1 (or some higher number if needed) to prevent 100% CPU use. The maximum is 50
-ProcessorIdle=-1
+;Set to 1 to allow the game to go idle during each input loop, preventing 100% CPU usage
+ProcessorIdle=1

 ;Set to 1 if using the hero appearance mod
 ;Set to 2 for backward compatibility with scripts that manually fix obj_art_fid/art_change_fid_num script functions for dude_obj
@@ -481,7 +483,7 @@ NPCsTryToSpendExtraAP=0
 AllowLargeTiles=0

 ;Set to 1 to boost the maximum number of tile FRMs from 4096 to 16383
-;This option is always enabled in 4.3.7/3.8.37 or later. The information is left for reference only
+;This option is always enabled in 4.3.7/3.8.37 or later and cannot be disabled (kept for reference only)
 MoreTiles=1

 ;Change the Skilldex cursor FRM numbers
@@ -786,15 +788,25 @@ PartyMemberSkillFix=0
 ;Set to -1 to disable the special death message when the global variable is set
 SpecialDeathGVAR=491

-;Set to 1 to disable the special handling of map IDs 19 and 37 in the engine when entering the maps
+;Set to 1 to disable the engine's special handling of map IDs 19 and 37 when entering those maps
 ;Note that enabling this option will break the map changes in Modoc and Vault 15 in Fallout 2
 DisableSpecialMapIDs=0

-;Set to 1 to disable the special handling of city areas 45 and 46 in the engine when visiting Area 45:
+;Set to 1 to disable the engine's special handling of city areas 45 and 46 when visiting Area 45:
 ;Area 45 automatically disappears from the world map, and Area 46 appears on the world map
 ;Note that enabling this option will break the location change of the 'Fake Vault 13' in Fallout 2
 DisableSpecialAreas=0

+;Set to 1 to disable the engine's processing of events related to Arroyo (areas 0 and 22)
+;This also disables the playback of Hakunin dream sequences and the processing of global variables:
+;GVAR_ENEMY_ARROYO (7), GVAR_TOWN_REP_ARROYO (47), GVAR_FALLOUT_2 (494)
+DisableArroyoEvents=0
+
+;Set to 1 to fix the issue with the division operator treating negative integers as unsigned
+;Note: To perform the unsigned integer division, use the new 'div' operator
+;This option is always enabled in 4.3.5/3.8.35 or later and cannot be disabled (kept for reference only)
+DivisionOperatorFix=1
+
 ;XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 ; Configuration ini files
 ;XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
@@ -1,3 +1,6 @@
 These are some example mods I've put together. Each uses sfall features in a simple way, generally involving a single global script. The uncompiled versions of each script is included.

-Further good examples of sfall scripts are available from Nirran's site: http://www.nirran.com/
+Further good examples of sfall scripts are available from:
+* FO2tweaks: https://github.com/BGforgeNet/FO2tweaks
+* EcCo Gameplay Overhaul: https://github.com/phobos2077/fo2_ecco
+* Nirran's site: http://www.nirran.com/
@@ -348,6 +348,10 @@ There are several changes in this version of sslc which may result in problems f

 ### Changelog

+**sfall 4.4.7:**
+- fixed leftover stack data caused by the `break` statement
+- added Linux & WebAssembly builds
+
 **sfall 4.4.4:**
 - fixed stringified procedure names shifting when the same name is called more than once
 - syntax improvements:
@@ -174,7 +174,7 @@
    detail: void set_available_skill_points(int value)
    opcode: 0x8244
  - name: get_available_skill_points
-    detail: int get_available_skill_points()
+    detail: int get_available_skill_points
    opcode: 0x8245

  - name: set_skill_max
@@ -239,10 +239,10 @@
    detail: void set_shader_texture(int ID, string param, int texID)
    opcode: 0x81b2
  - name: get_screen_width
-    detail: int get_screen_width()
+    detail: int get_screen_width
    opcode: 0x8220
  - name: get_screen_height
-    detail: int get_screen_height()
+    detail: int get_screen_height
    opcode: 0x8221
  - name: set_palette
    detail: void set_palette(string path)
@@ -352,11 +352,11 @@
    opcode: 0x81be
    doc: Used to change the title of the "select a perk" box, or by using "" it will be set back to the default.
  - name: hide_real_perks
-    detail: void hide_real_perks()
+    detail: void hide_real_perks
    opcode: 0x81bf
    doc: Prevent the "select a perk" box from displaying any of the original 119 perks.
  - name: show_real_perks
-    detail: void show_real_perks()
+    detail: void show_real_perks
    opcode: 0x81c0
    doc: Reverts the effect os `hide_real_perks`.
  - name: perk_add_mode
@@ -364,7 +364,7 @@
    opcode: 0x81c3
    doc: Modifies what happens when a fake perk is selected from the perks dialog. It is treated as a set of flags - if bit 1 is set then it is added to the player's traits, if bit 2 is set it is added to the player's perks, and if bit 3 is set it is removed from the list of selectable perks. The default is 0x2.
  - name: clear_selectable_perks
-    detail: void clear_selectable_perks()
+    detail: void clear_selectable_perks
    opcode: 0x81c4
    doc: Restores the "select a perk" box to its default state.

@@ -492,10 +492,10 @@
    detail: void set_map_enter_position(int tile, int elevation, int rotation)
    doc: Overrides the players entry position when entering the map through exit grids. Setting the tile to 0 will put the player on the start hex (default tile and elevation) of the map. Works only in `map_enter_p_proc` procedure.
  - name: get_map_enter_position
-    detail: array get_map_enter_position()
+    detail: array get_map_enter_position
    doc: "Returns an array of the player's position data (index: 0 - tile, 1 - elevation, 2 - rotation) when entering the map through exit grids. If entering from the world map, the tile value will be -1. Should be called in `map_enter_p_proc` procedure to get the correct position data."
  - name: exec_map_update_scripts
-    detail: void exec_map_update_scripts()
+    detail: void exec_map_update_scripts
    doc: Executes `map_update_p_proc` for all objects on map and global/hook scripts as well.
    macro: sfall.h
  - name: set_terrain_name
@@ -538,10 +538,10 @@
  doc: The mapper manual lists the functions `world_map_x_pos` and `world_map_y_pos`, which supposedly return the player's x and y positions on the world map. `get_world_map_x/y_pos` are included here anyway, because I was unable to get those original functions to work, or even to find any evidence that they existed in game.
  items:
  - name: get_world_map_x_pos
-    detail: int get_world_map_x_pos()
+    detail: int get_world_map_x_pos
    opcode: 0x8173
  - name: get_world_map_y_pos
-    detail: int get_world_map_y_pos()
+    detail: int get_world_map_y_pos
    opcode: 0x8174
  - name: set_world_map_pos
    detail: void set_world_map_pos(int x, int y)
@@ -551,7 +551,7 @@
 - name: Audio
  items:
  - name: eax_available
-    detail: int eax_available()
+    detail: int eax_available
    opcode: 0x81a3
    doc: Obsolete since sfall 2.1a. Always returns 0.
  - name: set_eax_environment
@@ -565,7 +565,7 @@
    doc: |
      Used to play `mp3/wav/wma` files. The path given is relative to the Fallout folder. Specify mode as 1 to loop the file continuously, 2 to replace the current background game music with playing the specified file in loop mode, or 0 to play the file once. If you don't wish to loop, `play_sfall_sound` returns 0. If you do loop, it returns an ID which can be passed back to `stop_sfall_sound` when you want to stop the effect. All sounds effects will be stopped on game reload, looping or not. Does not require `AllowDShowSound` to be set to 1 in `ddraw.ini`.

-      Starting from sfall 4.2.8/3.8.28, you can pass a value in the `mode` argument for a reduced sound volume. To set the volume, You need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in range from 0 to 32767 (the value 32767 is mute), and `Y` is the playback mode.
+      Starting from sfall 4.2.8/3.8.28, you can pass a value in the `mode` argument for a reduced sound volume. To set the volume, you need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in range from 0 to 32767 (the value 32767 is mute), and `Y` is the playback mode.
  - name: stop_sfall_sound
    detail: void stop_sfall_sound(int soundID)
    opcode: 0x822c
@@ -593,13 +593,13 @@
  parent: Sfall
  items:
  - name: sfall_ver_major
-    detail: int sfall_ver_major()
+    detail: int sfall_ver_major
    opcode: 0x8210
  - name: sfall_ver_minor
-    detail: int sfall_ver_minor()
+    detail: int sfall_ver_minor
    opcode: 0x8211
  - name: sfall_ver_build
-    detail: int sfall_ver_build()
+    detail: int sfall_ver_build
    opcode: 0x8212

 - name: Math
@@ -674,13 +674,13 @@
    detail: void tap_key(int dxScancode)
    opcode: 0x8162
  - name: get_mouse_x
-    detail: int get_mouse_x()
+    detail: int get_mouse_x
    opcode: 0x821c
  - name: get_mouse_y
-    detail: int get_mouse_y()
+    detail: int get_mouse_y
    opcode: 0x821d
  - name: get_mouse_buttons
-    detail: int get_mouse_buttons()
+    detail: int get_mouse_buttons
    doc: Returns the number of the mouse button that is currently pressed (1 - left, 2 - right, 3 - left+right, 4 - middle, 0 otherwise).
    opcode: 0x821e

@@ -822,7 +822,7 @@
    detail: void refresh_pc_art
    opcode: 0x8227
  - name: art_cache_clear
-    detail: void art_cache_clear()
+    detail: void art_cache_clear
    doc: Clears the cache of FRM image files loaded into memory.
    macro: sfall.h

@@ -855,7 +855,7 @@
    doc: Returns an array of all objects at given tile. It will include any hidden, dead or system objects (like cursor), so make sure to check properly when iterating.
    opcode: 0x8270
  - name: tile_refresh_display
-    detail: void tile_refresh_display()
+    detail: void tile_refresh_display
    doc: Redraws the game scene (tiles, walls, objects, etc.).
  - name: obj_blocking_tile
    detail: ObjectPtr obj_blocking_tile(int tileNum, int elevation, int blockingType)
@@ -889,9 +889,9 @@
 - name: Other
  items:
  - name: input_funcs_available
-    detail: int input_funcs_available()
+    detail: int input_funcs_available
    opcode: 0x816b
-    doc: The input functions are only available if the user has the input hook turned on in `ddraw.ini`. Use `input_funcs_available` to check.
+    doc: (DEPRECATED) The input functions are only available if the user has the input hook turned on in `ddraw.ini`. Use `input_funcs_available` to check.
  - name: get_year
    detail: int get_year
    opcode: 0x8163
@@ -940,15 +940,15 @@
  - name: inc_npc_level
    detail: void inc_npc_level(int party_member_pid)
    opcode: 0x81a5
-    doc: Takes a party member PID or an NPC name (deprecated, for compatibility with sfall 4.1.5/3.8.15 or earlier) as an argument. The NPC must be in your party. This function ignores player level requirements and the minimum 3 player level delay between NPC level gains. It also ignores the random element, regardless of sfall's `NPCAutoLevel` setting.
+    doc: Takes a party member PID or an NPC name (deprecated, for compatibility with sfall 4.1.5/3.8.15 or earlier) as an argument. The NPC must be in your party. This function ignores player level requirements and the minimum 3 player level delay between NPC level gains. It also ignores the random element, regardless of sfall's `NPCAutoLevel` or `PartyMemberNonRandomLevelUp` setting.
  - name: get_npc_level
    detail: int get_npc_level(string npc)
    opcode: 0x8241
  - name: get_viewport_x
-    detail: int get_viewport_x()
+    detail: int get_viewport_x
    opcode: 0x81a6
  - name: get_viewport_y
-    detail: int get_viewport_y()
+    detail: int get_viewport_y
    opcode: 0x81a7
  - name: set_viewport_x
    detail: void set_viewport_x(int view_x)
@@ -966,7 +966,7 @@
    opcode: 0x81e6
    doc: Alters the AC bonus you receive per unused action point at the end of your turn in combat. To allow for fractional values, the value given if divided by 4. (Hence the default value is 4 and not 1.)
  - name: get_unspent_ap_bonus
-    detail: int get_unspent_ap_bonus()
+    detail: int get_unspent_ap_bonus
    doc: Gets the AC bonus you receive per unused action point at the end of your turn in combat. To allow for fractional values, the value given if divided by 4. (Hence the default value is 4 and not 1.)
    opcode: 0x81e7
  - name: set_unspent_ap_perk_bonus
@@ -974,14 +974,14 @@
    opcode: 0x81e8
    doc: Similar to `set_unspent_ap_bonus`, but effects the extra AC granted by the H2H Evade perk. (The default value of this is also 4, equivalent to doubling the original bonus.
  - name: get_unspent_ap_perk_bonus
-    detail: int get_unspent_ap_perk_bonus()
+    detail: int get_unspent_ap_perk_bonus
    opcode: 0x81e9
    doc: Similar to `get_unspent_ap_bonus`, but accounts for the extra AC granted by the H2H Evade perk. (The default value of this is also 4, equivalent to doubling the original bonus.

  - name: nb_create_char
-    detail: int nb_create_char()
+    detail: int nb_create_char
    opcode: 0x81f6
-    doc: "`nb_*` functions are reserved for the brotherhood tactical training mod, and should be avoided. Not implemented, always returns 0."
+    doc: (DEPRECATED) Reserved for the brotherhood tactical training mod, and should be avoided. Not implemented, always returns 0.

  - name: get_proto_data
    detail: int get_proto_data(int pid, int offset)
@@ -996,16 +996,16 @@
    detail: void hero_select_win(int)
    opcode: 0x8213
  - name: stop_game
-    detail: void stop_game()
+    detail: void stop_game
    opcode: 0x8222
  - name: resume_game
-    detail: void resume_game()
+    detail: void resume_game
    opcode: 0x8223
  - name: create_message_window
    detail: void create_message_window(string message)
    opcode: 0x8224
  - name: get_light_level
-    detail: int get_light_level()
+    detail: int get_light_level
    opcode: 0x8226
    doc: Returns ambient light level in range 0..65536. The value returned by get_light_level may not exactly match that set by `set_light_level`, as `set_light_level` applies modifiers from the Night Vision perk.

@@ -1019,16 +1019,16 @@
    detail: void set_inven_ap_cost(int cost)
    opcode: 0x824d
  - name: game_loaded
-    detail: int game_loaded()
+    detail: int game_loaded
    doc: Returns 1 the first time it is called after a new game or game load, and 0 any time after. It works on an individual basis for each script, so one script wont interfere with others. Its primary use is for global scripts, so that they know when to call `set_global_script_repeat`, but it can be called from normal scripts too.
    opcode: 0x8164

  - name: get_game_mode
-    detail: int get_game_mode()
+    detail: int get_game_mode
    doc: A more flexible version of in_world_map. It will return a set of flags indicating which mode the game is currently in. These flags are the same as those used in the `set_shader_mode function`.
    opcode: 0x81af
  - name: get_uptime
-    detail: int get_uptime()
+    detail: int get_uptime
    doc: Just a wrapper around the windows GetTickCount() function. It's useful for making time fade effects in shaders, since they already have access to the current tick count.
    opcode: 0x81b3

@@ -1186,7 +1186,7 @@
    doc: Sets the text messages and colors for custom notification boxes to the interface without the need to add messages to `intrface.msg` and set up the font colors in `ddraw.ini`. Tag value is the same as used in `show_iface_tag`, `hide_iface_tag`, and `is_iface_tag_active`. The valid range is from 5 to (4 + the value of BoxBarCount in `ddraw.ini`) or the number of the last custom box added using the `add_iface_tag` function. The text is limited to 19 characters.
    macro: sfall.h
  - name: add_iface_tag
-    detail: void add_iface_tag()
+    detail: void add_iface_tag
    doc: Adds one custom box to the current boxes, and returns the number of the added tag (-1 if the tags limit is exceeded. The maximum number of boxes is limited to 126 tags.
    macro: sfall.h

@@ -1207,15 +1207,15 @@
  parent: Hooks # normal page
  items:
  - name: init_hook
-    detail: int init_hook()
+    detail: int init_hook
    doc: The hook script equivalent of `game_loaded`; it returns 1 when the script is loaded for the first time or when the player reloads the game, and 0 otherwise.
    opcode: 0x81ea
  - name: get_sfall_arg
-    detail: mixed get_sfall_arg()
+    detail: mixed get_sfall_arg
    doc: Gets the next argument from sfall. Each time it's called it returns the next argument, or otherwise it returns 0 if there are no more arguments left. You can arbitrarily get the value of any argument using the `sfall_func1("get_sfall_arg_at", argNum)` function.
    opcode: 0x81e4
  - name: get_sfall_args
-    detail: int get_sfall_args()
+    detail: int get_sfall_args
    doc: Returns all hook arguments as a new temp array.
    opcode: 0x823c
  - name: get_sfall_arg_at
@@ -1573,7 +1573,9 @@
  - name: set_global_script_type
    detail: void set_global_script_type(int type)
    opcode: 0x819b
-    doc: Only has an effect on the script it is called from. Every global script needs its own `game_loaded` block to correctly set up the script type.
+    doc: |
+      Only has an effect on the script it is called from. Every global script needs its own `game_loaded` block to correctly set up the script type.
+      - (DEPRECATED) Using type 1 requires the input wrapper to be enabled. Use `available_global_script_types` to check what is available.
  - name: available_global_script_types
    detail: int available_global_script_types
    opcode: 0x819c
@@ -1581,7 +1583,7 @@
 - name: Combat
  items:
  - name: attack_is_aimed
-    detail: bool attack_is_aimed()
+    detail: bool attack_is_aimed
    doc: Returns 1 if the aimed attack mode is selected, 0 otherwise.
    macro: sfall.h

@@ -1654,7 +1656,7 @@
  - name: set_spray_settings
    detail: void set_spray_settings(int centerMult, int centerDiv, int targetMult, int targetDiv)
    doc: |
-      Allows changing the multipliers and divisors for the bullet distribution of burst attacks dynamically. All settings are automatically reset to default values (**ComputeSpray_\*** settings in ddraw.ini) after each attack action
+      Allows changing the multipliers and divisors for the bullet distribution of burst attacks dynamically. All settings are automatically reset to default values (i.e. **ComputeSpray_\*** settings in ddraw.ini) after each attack action
      - Should be called before the calculation of the bullet distribution (e.g. in `HOOK_TOHIT` or `HOOK_AMMOCOST`)
      - `centerDiv/targetDiv`: the minimum value of divisor is 1
      - `centerMult/targetMult`: multiplier values are capped at divisor values
@@ -1662,7 +1664,7 @@
    macro: sfall.h

  - name: get_combat_free_move
-    detail: int get_combat_free_move()
+    detail: int get_combat_free_move
    doc: Returns available "bonus move" points of the current critter's turn. For NPCs, this is always 0 unless changed by `set_combat_free_move`
    macro: sfall.h

@@ -1681,7 +1683,7 @@
    opcode: 0x81b6
    doc: Changes the current town index for the player's car.
  - name: car_gas_amount
-    detail: int car_gas_amount()
+    detail: int car_gas_amount
    doc: |
      Returns the current amount of fuel in player's car (between 0 and 80000).
      To change fuel amount, use vanilla function: `metarule(METARULE_GIVE_CAR_GAS, amount)` - `amount` can be positive or negative.
@@ -1772,7 +1774,7 @@
      macro: sfall.h

    - name: get_window_under_mouse
-      detail: int get_window_under_mouse()
+      detail: int get_window_under_mouse
      opcode: 0x821f
      doc: "Returns the internal ID of the top-most window under mouse cursor."
    - name: create_win
@@ -1833,7 +1835,7 @@
  parent: Interface
  items:
  - name: outlined_object
-    detail: ObjectPtr outlined_object()
+    detail: ObjectPtr outlined_object
    doc: Returns an object that is currently highlighted by hovering the mouse above it.
    macro: sfall.h
  - name: get_outline
@@ -1852,7 +1854,7 @@
  parent: Interface
  items:
  - name: intface_is_hidden
-    detail: bool intface_is_hidden()
+    detail: bool intface_is_hidden
    macro: sfall.h
    doc: Returns 1 if interface is currently hidden, 0 otherwise.
  - name: intface_redraw
@@ -1863,11 +1865,11 @@
      - redraws main game interface, useful to reflect changes after directly changing current player weapons or stats
      - `winType`: the type number of the interface window (see `WINTYPE_*` constants in **sfall.h**). Pass `-1` to redraw all interface windows.
  - name: intface_hide
-    detail: void intface_hide()
+    detail: void intface_hide
    doc: Hides main interface.
    macro: sfall.h
  - name: intface_show
-    detail: void intface_show()
+    detail: void intface_show
    doc: Shows main interface.
    macro: sfall.h

@@ -1875,7 +1877,7 @@
  parent: Interface
  items:
  - name: display_stats
-    detail: void display_stats()
+    detail: void display_stats
    doc: |
      - Updates player's stats in the inventory display window or on the character screen.
      - NOTE: works only when the interface window is opened
@@ -1899,7 +1901,7 @@
  parent: Interface
  items:
  - name: get_cursor_mode
-    detail: int get_cursor_mode()
+    detail: int get_cursor_mode
    doc: 'Returns the current cursor mode. Values: 0 - movement cursor, 1 - command cursor, 2 - targeting cursor, 4 to 10 are Skilldex skills (yellow targeting cursor).'
    macro: sfall.h
  - name: set_cursor_mode
@@ -1991,7 +1993,7 @@
    doc: Take control of a given critter. Passing value 0 will reset control back to "real" dude.
    macro: sfall.h
  - name: real_dude_obj
-    detail: ObjectPtr real_dude_obj()
+    detail: ObjectPtr real_dude_obj
    doc: Returns the initial `dude_obj` after `set_dude_obj` was used.
    macro: sfall.h

@@ -2016,11 +2018,11 @@
    opcode: 0x8275

  - name: loot_obj
-    detail: ObjectPtr loot_obj()
+    detail: ObjectPtr loot_obj
    doc: Returns a pointer to the target object (container or critter) of the loot screen.
    macro: sfall.h
  - name: dialog_obj
-    detail: ObjectPtr dialog_obj()
+    detail: ObjectPtr dialog_obj
    doc: Returns a pointer to the object (critter) the player is having a conversation or bartering with.
    macro: sfall.h

@@ -382,7 +382,7 @@
    ```

 - name: WithinPerception
-  id: HOOK_WITHINPRECEPTION
+  id: HOOK_WITHINPERCEPTION
  doc: |
    Runs when checking if one critter sees another critter. This is used in different situations like combat AI. You can override the result.

@@ -477,7 +477,7 @@
    ```

 - name: CombatTurn
-  id: HOOK_COMBATURN
+  id: HOOK_COMBATTURN
  doc: |
    Runs before and after each turn in combat (for both PC and NPC).

--- a/Show More
+++ b/Show More