Wet System - Custom Decorative Objects

WET System Framework is a modding framework for Subnautica 2 that allows anyone to add custom decorative objects and meshes to the game without writing code.

Using simple .wet.json files placed in the ~mods folder, modders can create new placeable decorations that automatically appear in a dedicated in-game menu (UI is WIP).

Installation

You need UE4SS

Place "WetSystem" inside: Subnautica2\Subnautica2\Content\Paks\LogicMods
Place "WetScript" inside: Subnautica2\Subnautica2\Binaries\Win64\ue4ss\Mods

THE WETSCRIPT PART CAN'T BE UPLOADED. CURSE FORGE LIMITS THE UPLOAD. I'M SPEAKING WITH SUPPORT, SO IT DOESN'T WORK FOR NOW

Be careful to have "WetScript : 1" (if not add it) inside ue4ss\Mods\mods.txt

If, in the menu, you see "Wet System" below the logo, that's good!

In-Game Placement Menu

Press F9 to open the WET Framework object menu.

From there, you can browse and place any registered custom object.

Controls

Current controls:

• Left Click – Place object
• F – Move selected object
• X – Remove selected object
• Top/Down Arrow – Change select object to place
• Left/Right Arrow – Change Variant of the selected object (if available)

Features

Custom Decorative Objects

Create new decorative items by defining them in a .wet.json file.

Supported features include:

• Custom meshes
• Custom thumbnails (UI is WIP)
• Categories
• Placement settings
• Custom transforms
• Surface snapping
• Multiple appearance variants

Multiplayer has not been tested yet.

Planned Features

Short Term

• Placeable blueprints
• Interactive objects (lights, switches, etc.)
• Objects with inventories (storage containers and similar)

Long Term

• Integration with the in-game constructor (if technically possible)
• No longer use UE4SS
• Custom foundations
• Custom vehicles

For Mod Authors
Creating Custom Objects

Objects are defined through .wet.json files placed inside the ~mods directory.

A basic object can define:

• Name
• Description
• Category
• Mesh
• Thumbnail
• Transform settings
• Placement behavior

bedsideTable.wet.json:

{
  "id": "wet_cozy_bedside_table",
  "version": "1.0.0",

  "category": "Furniture",
  "name": "Bedside Table",
  "description": "A wooden bedside table",

  "staticMesh": "/Game/Mods/WetCozyPack/BedsideTable/SM_Bedside_Table.SM_Bedside_Table",

  "thumbnail": "/Game/Mods/WetCozyPack/BedsideTable/TX_Bedside_Table_Thumb.TX_Bedside_Table_Thumb",

  "transform": {
    "scale":    { "x": 1.0,  "y": 1.0,  "z": 1.0 },
    "offset":   { "x": 0.0,  "y": 0.0,  "z": 0.0 },
    "rotation": { "pitch": 0.0, "yaw": 0.0, "roll": 0.0 }
  },

  "placement": {
    "snapping": "surface",
    "boxExtents": { "x": 35.0, "y": 4.0, "z": 55.0 },
    "allowedSurfaces": 7,
    "interactDistance": 350.0
  },
}

Variant Support

Objects can contain multiple variants.

Variants allow a single object entry to provide multiple appearances, meshes, or material combinations.

While placing an object, use the Left Arrow and Right Arrow keys to cycle through available variants.

Examples:

• Multiple poster designs
• Different furniture styles
• Alternate material presets
• Color variations

{
  "id": "wet_poster",
  "name": "Poster Frame",
  "description": "A decorative poster for your base.",
  "category": "Posters",

  "thumbnail": "/Game/Utility/Editor/IconBaker/IconTextures/IconBaker_BasePieces/T_PowerGridCapacitor_Icon.T_PowerGridCapacitor_Icon",

  "transform": {
    "scale": { "x": 1.0, "y": 1.0, "z": 1.0 }
  },

  "placement": {
    "_comment_snapping": "surface = snap to any surface.  Freeform = float in front of camera.",
    "snapping": "surface",
    "_comment_boxExtents": "Half-extents in cm: x=half-width  y=half-depth (into wall)  z=half-height.",
    "boxExtents": { "x": 35.0, "y": 4.0, "z": 55.0 },
    "_comment_allowedSurfaces": "Bitmask: 1=floor  2=wall  4=ceiling  7=all.",
    "allowedSurfaces": 7,
    "interactDistance": 350.0
  },

  "isLocked": false,

  "_comment_variants": "Each entry is a selectable appearance for this item. Switch with Left/Right arrow keys while placing. Only variantName, staticMesh, and materials are variant-specific; everything else (placement, transform, category) is shared.",
  "variants": [
    {
      "variantName": "Empty Frame",
      "staticMesh": "/Game/Art/Items/Posterframe/Mesh/SM_PosterFrame_01_Vertical_A.SM_PosterFrame_01_Vertical_A"
    },
    {
      "variantName": "Keep Calm",
      "staticMesh": "/Game/Art/Items/Posterframe/Mesh/SM_PosterFrame_01_Vertical_A.SM_PosterFrame_01_Vertical_A",
      "materials": [
        null,
        null,
        null,
        "/Game/Art/Environment/Set/Alterra/Props/Posters/Materials/MI_Alterra_PosterKitty_01a.MI_Alterra_PosterKitty_01a"
      ]
    }
  ]
}

Notes

This framework is currently focused on decorative objects.

Interactive gameplay functionality is still under development and will be expanded in future releases.

Feedback, bug reports, and example object packs are always welcome.

There is no danger for save file!

License

This project is proprietary software.

Usage is permitted for personal gameplay and for creating content packs compatible with the framework.

Modification, redistribution, reverse engineering, or reuse of the framework code is prohibited without explicit permission from the author.