BioScan Target Finder

BioScan Target Finder helps you track down biological scans you are still missing.

Features

• Finds the nearest loaded flora or fauna specimen that can still advance scan completion.[/*]

• Places a native tracking ping directly on the selected target.[/*]

• Uses a distinctive amber/gold marker labeled Scan: <species>[/*]

• Tracks moving fauna using the game’s native ping system.[/*]

• Filters invalid and out-of-bound targets.[/*]

• Preserves personal pings, Beacons, Habitat Beacons, bases, vehicles, Lifepods, Blackboxes, and other game markers.[/*]

• Automatically removes the marker when the selected species is scanned.[/*]

• Removes saved Scan: markers when a save is loaded.[/*]

• Provides optional coordinate and diagnostic logging.[/*]

How It Works

The feature begins OFF whenever a save is loaded.

Any previous saved marker is removed after the ping system finishes loading. 

The mod does not automatically search for a new target.

Press F7 While OFF

The mod:

• Removes any recognized stale markers created by earlier versions.[/*]

• Searches actors currently loaded through world streaming.[/*]

• Keeps only valid Organic scan targets that can still provide completion progress.[/*]

• Select the nearest eligible specimen.[/*]

• Places a gold tracking ping on the target.[/*]

• Returns to an idle state until the next F7 press or the target is scanned.[/*]

Press F7 While ON: The active scan marker is removed and the feature returns to OFF.

Scan the Selected Targets

The marker is removed automatically and the feature returns to OFF.

The mod will not search for another target until F7 is pressed again.

Installation

Requirement: A working UE4SS installation with Lua mod support for Subnautica 2.

Manual Installation

• Download and extract the archive.[/*]

• Confirm that the final folder structure is:[/*]

 ue4ss

└── Mods

    └── BioScanTargetFinder

        ├── enabled.txt

        └── Scripts

            └── main.lua

• Start the game and load a save.[/*]

• Press F7 when ready to search.[/*]

 The mod performs no automatic target search when loading a save.

Uninstallation

Before removing the mod:

• Load your save.[/*]

• Press F7 if a gold Scan: marker is active.[/*]

• Save the game.[/*]

• Delete: Mods/BioScanTargetFinder[/*]

 Removing the mod while its marker is active may leave that marker stored in the save.

Configuration

All configuration is stored near the top of: Mods/BioScanTargetFinder/Scripts/main.lua

Trigger Key: TRIGGER_KEY = Key.F7

The default ping color is amber/gold:

PING_COLOR_ENABLED = true

PING_COLOR = { R = 1.00, G = 0.55, B = 0.00, A = 1.00 }

Each color channel accepts a value from: 0.0  to  1.0

Ping Label: PING_DISPLAY_PREFIX = "Scan: "

Logging is disabled by default:

LOGGING_ENABLED = false

DEBUG_LOGGING = false

Set LOGGING_ENABLED to true to write target coordinates, survey totals, and cleanup results to: UE4SS.log

Important Limitations

• There is a brief loading hitch (~1 sec) when toggling trigger key since the mod synchronously evaluates every loaded actor.[/*]

• The mod can only find flora and fauna currently loaded through world streaming.[/*]

• It cannot search unloaded regions of the map.[/*]

• Logged fauna coordinates are only a snapshot, although the ping tracks the creature.[/*]

• The nearest loaded specimen may still be far from the player.[/*]

• Some areas may contain no loaded instance of the missing species.[/*]

• The mod does not display on-screen status messages.[/*]

• Multiplayer is untested and not likely to be included. [/*]

• "Nearest” is straight-line 3D distance, not navigable path distance. [/*]

• The appearance or disappearance of the gold Scan: marker indicates whether the feature is active.[/*]

• Only Organic targeted (Flora, Fauna). Inorganic or Tech not targeted.[/*]

• Future game updates may change functions or classes used by UE4SS mods.[/*]

Compatibility

BioScan Target Finder changes only its own biological target-marker behavior.

It does not alter:

• Scanner range[/*]

• Bioscanner range[/*]

• Scan requirements[/*]

• Scan progress[/*]

• Flora or fauna spawning[/*]

• Personal player pings[/*]

• Standard Beacons[/*]

• Base or vehicle markers[/*]

• Story and location markers[/*]

• Save-game progression[/*]

Other mods that modify the ping system, scan database, or Organic scan classification may conflict.

Troubleshooting

F7 Does Not Create a Marker

Possible causes:

• No incomplete Organic specimen is currently loaded. Move to another area and try again.[/*]

• The remaining species exist in an unloaded region.[/*]

• All loaded candidates were rejected as invalid or outside the playable area.[/*]

• UE4SS did not load the mod.[/*]

Enable logging: LOGGING_ENABLED = true then check: UE4SS.log

The Mod Does Not Appear in the UE4SS Log

Confirm that this file exists: Mods/BioScanTargetFinder/enabled.txt

Also confirm that main.lua is located inside: Mods/BioScanTargetFinder/Scripts

A Marker Remains After Uninstalling

Reinstall the mod, load the affected save, allow the mod to remove the saved marker, save the game, and then uninstall the mod again.

Credits

Created using UE4SS and reflected Subnautica 2 SDK data.

Manual installation only.