A lightweight SFSE configuration bridge for context-aware spacesuit, helmet, and boostpack visibility.
Starfield Adaptive Gear lets the game's native condition system decide when the player's equipped spacesuit, helmet, and boostpack should be visible. The SFSE plugin in this repository reads a simple INI file once during startup and passes those settings to the condition records supplied with the Nexus release.
The mod changes appearance only. It never equips or unequips an item, removes protection, changes resistances, or writes configuration data into a save game.
- Independent visibility rules for the spacesuit and helmet
- Rules for ships, settlements, combat, and breathable wilderness
- Automatic safety override in vacuum and hazardous environments
- Optional boostpack behavior that follows spacesuit visibility
- Native condition evaluation with no polling loop
- No hooks, detours, combat sinks, or per-frame work
- Plain-text INI configuration
Rules are evaluated from top to bottom. A higher-priority context prevents lower-priority rules from taking over.
| Priority | Context | Behavior |
|---|---|---|
| 1 | Unsafe environment | Gear is always shown; this safety rule cannot be disabled |
| 2 | Combat or searching | Uses the corresponding combat setting |
| 3 | Aboard a ship | Uses the ship setting |
| 4 | Settlement | Uses the settlement setting |
| 5 | Breathable wilderness | Uses the wilderness setting |
The helmet is never shown without the spacesuit. By default, the boostpack also follows spacesuit visibility so it cannot appear to float on its own.
| Context | Spacesuit | Helmet |
|---|---|---|
| Aboard a ship | Hidden | Hidden |
| In a settlement | Hidden | Hidden |
| In combat/searching | Visible | Visible |
| Breathable wilderness | Visible | Hidden |
| Unsafe environment | Always visible | Always visible |
The default file is located at:
Data/SFSE/Plugins/StarfieldAdaptiveGear.ini
Use 0 for hidden and 1 for visible. Edit the file before launching the
game; settings are read once at startup.
[General]
Enabled=1
[Spacesuit]
ShowOnShip=0
ShowInSettlement=0
ShowInCombat=1
ShowInBreathableWilderness=1
[Helmet]
ShowOnShip=0
ShowInSettlement=0
ShowInCombat=1
ShowInBreathableWilderness=0
[Boostpack]
FollowSpacesuit=1- Starfield 1.16.244 (Steam)
- Starfield Script Extender 0.2.21
- Address Library for SFSE Plugins
- The
StarfieldAdaptiveGear.esmincluded in the Nexus release
Important
This source repository contains only the SFSE component. The required ESM and ready-to-install package are distributed on Nexus Mods and are intentionally not committed here.
Install the complete release from Nexus Mods with a mod manager, enable
StarfieldAdaptiveGear.esm, and launch Starfield through SFSE. Both components
are required:
StarfieldAdaptiveGear.esmcontains the native Starfield condition records.StarfieldAdaptiveGear.dllreads the INI and supplies the configured values.
If the DLL is absent, the ESM falls back to its packaged defaults. If the ESM is absent or disabled, the DLL logs an error and makes no engine changes.
The Nexus ESM overrides these vanilla Condition Forms:
ActorShouldShowSpacesuitActorShouldShowSpacesuitHelmetActorShouldShowSpacesuitPack
Any mod overriding the same records will conflict. The ESM loaded later in the plugin load order wins. The SFSE component itself installs no hooks and does not modify save data.
- Windows 10 or 11
- Visual Studio 2022 with the Desktop development with C++ workload
- XMake 3.0 or newer
- Git with submodule support
Clone recursively so the pinned CommonLibSF dependency is available:
git clone --recurse-submodules https://github.com/choboworks/Starfield-Adaptive-Gear.git
cd Starfield-Adaptive-Gear
xmake f -m releasedbg
xmakeThe build places the DLL and default INI in:
build/package/Data/SFSE/Plugins/
The ESM is not built or distributed by this repository.
.
├── lib/commonlibsf/ # Pinned Git submodule
├── package/Data/SFSE/Plugins/ # Default INI
├── src/ # SFSE plugin source
├── xmake.lua # Build definition
└── README.md
Bug reports and focused pull requests are welcome. Please read CONTRIBUTING.md before contributing. For security-sensitive issues, follow SECURITY.md.
Copyright © 2026 ChoboWorks. The original SFSE component is available under the GNU General Public License v3.0 or later. CommonLibSF is used under its own GPL terms and modding exceptions. See LICENSE, NOTICE.md, and THIRD_PARTY_NOTICES.md.
Starfield and related names are trademarks of Bethesda Softworks LLC. This project is community-made and is not affiliated with or endorsed by Bethesda.