SN2 Entity And Item Framework

SN2 Entity/Item Framework is a UE4SS dependency mod for Subnautica 2 that lets modders register, spawn, and test reusable entity and item definitions through Lua.

This is not a single creature or item mod. It is a framework intended for other modders to build on.

The framework adds:

• []RegisterEntity(definition)[/]

  []RegisterItem(definition)[/]

  []Entity registry[/]

  []Item registry[/]

  []Console tools[/]

  []Example entity definitions[/]

  []Example item definitions[/]

  []Framework-side entity health/state tracking[/]

  []Framework-side item grant tokens[/]

  []Recipe metadata support[/]

  []SN2ModSettings support[/]

  []SN2CommandsEnablerMod-compatible console unlock hooks[/]

Example entity:

RegisterEntity({ ID = "my_mod_big_fish", DisplayName = "Big Fish", BaseActorPath = "/Game/Creatures/Peeper/BP_Peeper. BP_Peeper_C", Scale = 3. 0, MaxHealth = 300 })Example item:

RegisterItem({ ID = "my_mod_super_battery", DisplayName = "Super Battery", BaseItemPath = "/Game/Items/Battery/BP_Battery. BP_Battery_C", StackSize = 4, Metadata = { Energy = 500 } })Included commands:

eif_ping eif_help eif_dump eif_entity_list eif_entity_spawn <entityID> eif_entity_damage <instanceID> <amount> eif_entity_kill <instanceID> eif_item_list eif_item_give <itemID> eif_item_recipe <itemID>What it can do:

• []Register entity definitions[/]

  []Register item definitions[/]

  []Spawn entities using existing actor paths or cooked Blueprint paths[/]

  []Scale/configure spawned entities[/]

  []Track framework-side entity health and state[/]

  []Store item metadata[/]

  []Store recipe metadata[/]

  []Create framework-side item tokens[/]

  []Provide console tools for testing[/]

  []Provide SN2ModSettings configuration support[/]

What it cannot fully do yet:

• []Create brand-new native creature models without cooked assets[/]

  []Add fully native inventory items automatically[/]

  []Inject new recipes into the real crafting UI[/]

  []Add PDA/scanner entries into the official UI[/]

  []Create full native creature AI behavior trees[/]

  []Guarantee multiplayer replication[/]

  []Replace the need for cooked assets when making real custom models[/]

This framework is best understood as a modder tool and dependency layer for experimenting with entities/items while the Subnautica 2 UE4SS modding scene discovers more stable hooks.

Requires UE4SS.

Console Commands

Checks whether SN2EntityItemFramework commands are working.

Lists available framework commands.

Dumps registered entities and items to the UE4SS log.

eif_settings

Prints active framework settings.

eif_entity_list

Lists registered entity definitions.

eif_entity_spawn <entityID>

Spawns a registered entity near the player.

eif_entity_damage <instanceID> <amount>

Damages a spawned framework entity instance.

eif_entity_kill <instanceID>

Kills a spawned framework entity instance.

eif_item_list

Lists registered item definitions.

eif_item_give <itemID>

Grants a framework-side item token.

eif_item_recipe <itemID>

Prints recipe metadata for a registered framework item.