BioScan Target Finder

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

Why did I create this mod

The game tracks how many BioScans you've completed, but not which species you still need. That's easy to manage at first, but finding the last few missing scans can become a tedious hunt. BioScan Target Finder points you to the nearest valid flora or fauna specimen that can still advance your progress, making completion much less frustrating.

• []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 BioScan: <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 BioScan: markers when a save is loaded.[/]

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

  How It Works

  • []The feature starts OFF whenever a save is loaded.[/]

    []Press F7 to locate the nearest unscanned organic specimen that can still contribute to bioscan progress.[/]

    []A gold tracking ping appears, showing the target's name and distance.[/]

    []Travel to the marked location and scan the specimen with the bioscanner.[/]

    []Once scanned, the ping is removed automatically and the feature returns to OFF.[/]

    []Press F7 again to locate the nearest eligible specimen from your new position.[/]

    []Repeat as needed.[/]

  Tip: Pressing F7 while a target is already marked will remove the active ping and turn the feature OFF. The mod never automatically selects a new target; a new search only occurs when F7 is pressed.

  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

  └── 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 BioScan: 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 = "BioScan: "

  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 BioScan: marker indicates whether the feature is active.[/]

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