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> [count] 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

General

eif_ping

  Checks whether SN2EntityItemFramework commands are working.

eif_help

  Lists available framework commands.

eif_dump

  Dumps registered entities and items to the UE4SS log.

eif_settings

  Prints active framework settings.

Entities

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.

Items

eif_item_list

  Lists registered item definitions.

eif_item_give <itemID> [count]

  Grants a framework-side item token.

eif_item_recipe <itemID>

  Prints recipe metadata for a registered framework item.