HUD/notification icons need RequestStreamedTextureDict + busy-wait before drawing, or the icon is blank

Context

Icon texture dictionaries (hud_textures, menu_textures, etc.) are not guaranteed resident. Drawing an icon or firing a toast that references one before the dict streams in renders a blank icon.

The pattern

if DoesStreamedTextureDictExist(dict) then
  RequestStreamedTextureDict(dict, true)
  while not HasStreamedTextureDictLoaded(dict) do Wait(0) end
end
-- now safe to reference the dict (toast icon, sprite, etc.)

Trap

RequestStreamedTextureDict is async; you must busy-wait on HasStreamedTextureDictLoaded. jo_libs guards the request behind DoesStreamedTextureDictExist to avoid requesting a non-existent dict.

Verified

notification/client.lua:7-16, used before the toast at :76.

Tags: streaming, texture-dict, requeststreamedtexturedict, notification, icon, hud
Category: natives
Source: jo_libs-fleet
Created: 2026-05-31T09:41:26.633Z