Nodebox

A UGC (User-Generated-Content) Node Graph Library for S&Box

Description

Nodebox is a reimagining of Wiremod gates from Garry's Mod made in S&Box

⚠️ The project is in it's infancy, expect bugs and constant breaking changes ⚠️

Inspired by Unreal Engine'sBlueprints and Resonite's Protoflux

• The Nodes themselves are separate from any visual/interactive parts
• There should be wrappers for them, which provide different visualization/interactions/functionality, etc.
  • Currently, only Node3D exists, which displays the inner Node via a WorldPanel (1 Node = 1 WorldPanel)
• Each Node type and their Pins have some simple metadata attached to it (Name, Desc, etc.)

Todo

• Wire3D - Wire 3D wrapper (like Node3D)
• Colors for Wire3Ds (or Wire in general)
• A Node type collection
  • Search functionality
• A tool to drag around, copy, select and delete Node3Ds, connect/disconnect pins
• Read/Write for Component Property values
• A Pin type, that acts as a "pulse", which makes Nodes work more like UE Blueprints (or Resonite's "Discrete" nodes)
• Implement a Node variant code generator tool (for Nodes like Add<T> (where T is float, double, VectorN, ...))
• Figure out networking
• Collapse/Uncollapse (Pack/Unpack in Protoflux) node graphs into GameObjects
• And, ofcourse, more Nodes 🛠️

Setup

Nodebox is an S&Box library (for now..?) , but it's not published yet.

To install it (clone it):

1. Open the <project>/Libraries/ folder (or create one if it's missing)
2. Open a cmd/shell and run git clone git@github.com:Manonox/Nodebox.git
3. Profit

Usage

Creating node graphs via a tool

Put the Node3dTool component on your first person camera

• Q(menu) opens the Node spawn menu
• R(reload) opens the context menu on GameObjects
  • (Property List / Destroy / Duplicate)
• Left Mouse Button(attack1)
  • Hold to drag Nodes
  • Click pins to create Wires
  • Double click while holding a Wire to spawn a Constant<T> or a Display node
• Right Mouse Button(attack2)
  • Drag left/right while holding a Node to rotate it on the Z axis(yaw)
  • Click pins to disconnect all Wires (if holding a Wire cancels/destroys it)

Generated node graph example:

Place the GameTime->Square->Display combo with Node3D wrappers in the world

protectedoverridevoidOnStart(){varnodes=newList<Node>(){newNodebox.Nodes.GameTime(),newNodebox.Nodes.Square<float>(),newNodebox.Nodes.Display(),};vargos=nodes.Enumerate().Select((pair)=>{var(index,x)=pair;vargo=Node3D.Wrap(x);go.WorldPosition=newVector3(80f,-index*30f,50f);go.WorldRotation=Rotation.FromYaw(180f);returngo;}).ToList();Wire3D.Connect(gos[0],0,gos[1],0);Wire3D.Connect(gos[1],0,gos[2],0);}