Custom Dev-tools Objects

[timofey260]

Custom dev tools objects

Summary

This page will try to teach you how to create custom dev-tools objects and make them work as well as show some ways to use already existing dev-tools representations for your needs

this tutorial might suck but i tried

full code will be available

probably need to do

• Create c# project
• Use STRIPPED-Assembly-CSharp version of assembly csharp instead of PUBLIC(replace it in lib folder)

how

To create custom devtools object you need 3 things:

1. PlacedObjectRepresentation class what would be showed when you open devtools
2. UpdatableAndDeletable(or any of its children) class to do stuff on room
3. PlacedObject.Data class to store any data you need

While doing so, we would need 3-4 different hooks:

• On.DevInterface.ObjectsPage.CreateObjRep to display PlacedObjectRepresentation on dev-tools window
• On.Room.Loaded to spawn our object to do stuff
• On.PlacedObject.GenerateEmptyData to make object have data we save and load
  (additionally, On.DevInterface.ObjectsPage.DevObjectGetCategoryFromPlacedType used to specify category on objects menu, or else it goes unsorted)

1. Registering an object type

To create an object, we need to register it in exenum. better to do all the dev-tools specific hooks and stuff in separate static class

namespace dttutor;

internal static class DevtoolsInit //please put all of this bullshit in seperate class for god sake
{
	public static void Init() // call init function from plugin.OnEnable
	{
		myObject = new("My_Object", true); // important to set register argument as true to uh register
	}
	public static PlacedObject.Type myObject; // our own object type

}

On booting up rw we can see that our custom dev-tool object can be accesed in Unsorted tab

Upon clicking, we spawned a handle that we can move around

2. Creating and hooking an object

This handle works great if we don't need to specify anything so let's create an UpdatableAndDeletable object that would be spawned when we load the room and throw us

using UnityEngine;

namespace dttutor;

internal class MyObjectObject : UpdatableAndDeletable
//use CosmeticSprite for drawables
{
	public PlacedObject pObj; // storing object for future usage
	public MyObjectObject(Room room, PlacedObject pObj)
	{
		this.room = room;
		this.pObj = pObj;
	}

	public override void Update(bool eu) //code that runs every tick
	{
		base.Update(eu);
		for (int i = 0; i < room.PlayersInRoom.Count; i++) //looping through each player in room
		{
			Player player = room.PlayersInRoom[i];
			if (Vector2.Distance(pObj.pos, player.bodyChunks[0].pos) < 20f) //if player near our object
			{
				player.bodyChunks[0].vel = new(0, 10); // fling both body chunks up
				player.bodyChunks[1].vel = new(0, 10);
			}
		}
	}
}

Before building code, we should add hook that would actually add object to room
I modified DevtoolsInit class above and added Room_Loaded hook

namespace dttutor;

internal static class DevtoolsInit //please put all of this bullshit in seperate class for god sake
{
	public static void Init() // call init function from plugin.OnEnable
	{
		myObject = new("My_Object", true); // important to set register argument as true to uh register
		On.Room.Loaded += Room_Loaded; // room loaded hook to spawn objects
		
	}
	public static PlacedObject.Type myObject; // our own object type

	private static void Room_Loaded(On.Room.orig_Loaded orig, Room self)
	{
		orig(self);
		for (int i = 0; i < self.roomSettings.placedObjects.Count; i++)
		{
			PlacedObject placedObject = self.roomSettings.placedObjects[i];
			if (placedObject.type == myObject) // if object we have is myObject
			{
				self.AddObject(new MyObjectObject(self, placedObject)); //spawning object if we see it
			}
		}
	}
}

When building and booting up the game we can see that object we placed throws us up

It works, but what if we want to store some data in it? or store more data? Then the next step is to create dev-tools representation for object

3. Creating and hooking representation

To create representation we just create c# class that is based of PlacedObjectRepresentation or its children

using DevInterface;

namespace dttutor.DevTools
{
	internal class MyObjectRepr : PlacedObjectRepresentation
		// instead of PlacedObjectRepresentation, any other representation class can be used(dnSpy the DevInterface namespace)
	{
		public MyObjectRepr(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
		{
		}
	}
}

After creating representation class, we need to hook On.DevInterface.ObjectsPage.CreateObjRep to change representation of spawned dev-tools objects
i rewrote some of DevtoolsInit code again

using DevInterface;
using RWCustom;
using UnityEngine;

namespace dttutor;

internal static class DevtoolsInit //please put all of this bullshit in seperate class for god sake
{
	public static void Init() // call init function from plugin.OnEnable
	{
		myObject = new("My_Object", true); // important to set register argument as true to uh register
		On.Room.Loaded += Room_Loaded; // room loaded hook to spawn objects
		On.DevInterface.ObjectsPage.CreateObjRep += ObjectsPage_CreateObjRep;
	}
	public static PlacedObject.Type myObject; // our own object type

	private static void Room_Loaded(On.Room.orig_Loaded orig, Room self)
	{
		orig(self);
		for (int i = 0; i < self.roomSettings.placedObjects.Count; i++)
		{
			PlacedObject placedObject = self.roomSettings.placedObjects[i];
			if (placedObject.type == myObject) // if object we have is myObject
			{
				self.AddObject(new MyObjectObject(self, placedObject)); //spawning object if we see it
			}
		}
	}

	private static void ObjectsPage_CreateObjRep(On.DevInterface.ObjectsPage.orig_CreateObjRep orig, ObjectsPage self, PlacedObject.Type tp, PlacedObject pObj)
	{
		if (pObj == null && tp == myObject) // init our placedObject. if we want multiple dt objects, instead of second condition better to use list or array contains method
		{
			pObj = new PlacedObject(tp, null)
			{
				pos = self.owner.room.game.cameras[0].pos + Vector2.Lerp(self.owner.mousePos, new Vector2(-683f, 384f), 0.25f) + Custom.DegToVec(UnityEngine.Random.value * 360f) * 0.2f
			};
			self.RoomSettings.placedObjects.Add(pObj);
		}
		PlacedObjectRepresentation placedObjectRepresentation; // creating empty representation
		if (tp == myObject)
		{
			placedObjectRepresentation = new MyObjectRepr(self.owner, tp.ToString() + "_Rep", self, pObj, tp.ToString()); // creating representation of our object
		}// add more if else for different types
		else
		{
			orig(self, tp, pObj); // don't care if it's not myObject
			return;
		}
		if (placedObjectRepresentation != null) //adding it to nodes and subnodes of dev-tools menu
		{
			self.tempNodes.Add(placedObjectRepresentation);
			self.subNodes.Add(placedObjectRepresentation);
		}
	}
}

The representation we currently have is simple handle we can move around(the same it was before)
Let's add another handle to our representation

using DevInterface;

namespace dttutor;

internal class MyObjectRepr : PlacedObjectRepresentation
// instead of PlacedObjectRepresentation, any other representation class can be used(dnSpy the DevInterface namespace)
{
    public Handle secondHandle;

    public MyObjectRepr(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
    {
        secondHandle = new(owner, "handlethesecond", this, new(20, 20));
        // lets see what arguments do
        // 1. owner - just put owner
        // 2. id string - can be anything and used for signal function, more on that later
        // 3. parent node - self explanatory. handle moves with parent node
        // 4. position - based of parent node
        subNodes.Add(secondHandle); // IMPORTANT to add anything to subNodes
    }
}

Upon loading rw we can see that ourdev tools object now has 2 handles

So it works, when we move "main" handle, "second" handle moves with it, but if we move "second" handle, "main" one doesn't move

It's cool and all, but the position of handle doesn't get saved + our game object has no idea about handle existing + they don't look connected at all

Before going to next steps, it's better to remove custom objects from world so they wouldn't cause any crashes or freezes since we're going to make our object require data that file doesn't have

4. Creating and Hooking Save data

Let's fix first issue by creating PlacedObject.Data class to save and load data

using UnityEngine;

namespace dttutor
{
	internal class MyObjectData : PlacedObject.Data
	{
		public Vector2 handlePos; //storing handle pos
		public MyObjectData(PlacedObject owner) : base(owner)
		{
			handlePos = new(20, 20); // default value of handle pos
		}
	}
}

To Save and load data, we need to override FromString and ToString methods

using System.Globalization;
using System.Text.RegularExpressions;
using UnityEngine;

namespace dttutor
{
	internal class MyObjectData : PlacedObject.Data
	{
		public Vector2 handlePos; //storing handle pos
		public MyObjectData(PlacedObject owner) : base(owner)
		{
			handlePos = new(20, 20); // default value of handle pos
		}

		public override void FromString(string s) //when we load data from file
		{
			string[] array = Regex.Split(s, "~");
			handlePos.x = float.Parse(array[0], NumberStyles.Any, CultureInfo.InvariantCulture); // setting pos of handle x and y
			handlePos.y = float.Parse(array[1], NumberStyles.Any, CultureInfo.InvariantCulture);
			unrecognizedAttributes = SaveUtils.PopulateUnrecognizedStringAttrs(array, 2); // all that we don't need
		}

		public override string ToString() //when we save data to file
		{
			string text = string.Format(CultureInfo.InvariantCulture, "{0}~{1}", new object[]
			{
				handlePos.x, handlePos.y
			}); //formatting the data
			text = SaveState.SetCustomData(this, text);
			return SaveUtils.AppendUnrecognizedStringAttrs(text, "~", unrecognizedAttributes);
		}
	}
}

Then we need to add hook that would apply MyObjectData to PlacedObject with type myObject
Again changing DevtoolsInit and adding On.PlacedObject.GenerateEmptyData hook

using DevInterface;
using RWCustom;
using UnityEngine;

namespace dttutor;

internal static class DevtoolsInit //please put all of this bullshit in seperate class for god sake
{
	public static void Init() // call init function from plugin.OnEnable
	{
		myObject = new("My_Object", true); // important to set register argument as true to uh register

		On.Room.Loaded += Room_Loaded; // room loaded hook to spawn objects
		On.DevInterface.ObjectsPage.CreateObjRep += ObjectsPage_CreateObjRep; // creating representation
		On.PlacedObject.GenerateEmptyData += PlacedObject_GenerateEmptyData; // creating data
	}
	public static PlacedObject.Type myObject; // our own object type

	private static void PlacedObject_GenerateEmptyData(On.PlacedObject.orig_GenerateEmptyData orig, PlacedObject self)
	{
		if (self.type == myObject)
		{
			self.data = new MyObjectData(self); // changing data to our own class
		}// add more if else for other types
		else orig(self);
	}

	private static void Room_Loaded(On.Room.orig_Loaded orig, Room self)
	{
		orig(self);
		for (int i = 0; i < self.roomSettings.placedObjects.Count; i++)
		{
			PlacedObject placedObject = self.roomSettings.placedObjects[i];
			if (placedObject.type == myObject) // if object we have is myObject
			{
				self.AddObject(new MyObjectObject(self, placedObject)); //spawning object if we see it
			}
		}
	}

	private static void ObjectsPage_CreateObjRep(On.DevInterface.ObjectsPage.orig_CreateObjRep orig, ObjectsPage self, PlacedObject.Type tp, PlacedObject pObj)
	{
		if (pObj == null && tp == myObject) // init our placedObject. if we want multiple dt objects, instead of second condition better to use list or array contains method
		{
			pObj = new PlacedObject(tp, null)
			{
				pos = self.owner.room.game.cameras[0].pos + Vector2.Lerp(self.owner.mousePos, new Vector2(-683f, 384f), 0.25f) + Custom.DegToVec(UnityEngine.Random.value * 360f) * 0.2f
			};
			self.RoomSettings.placedObjects.Add(pObj);
		}
		PlacedObjectRepresentation placedObjectRepresentation; // creating empty representation
		if (tp == myObject)
		{
			placedObjectRepresentation = new MyObjectRepr(self.owner, tp.ToString() + "_Rep", self, pObj, tp.ToString()); // creating representation of our object
		}// add more if else for different types
		else
		{
			orig(self, tp, pObj); // don't care if it's not myObject
			return;
		}
		if (placedObjectRepresentation != null) //adding it to nodes and subnodes of dev-tools menu
		{
			self.tempNodes.Add(placedObjectRepresentation);
			self.subNodes.Add(placedObjectRepresentation);
		}
	}
}

After that, the last thing we need to do is add the way to update our handlePos with dev-tools object
To do so, we can get data value once we initiated dev-tools object and change it in any other time by overriding Refresh method
Also we can add line between 2 handles

using DevInterface;
using RWCustom;

namespace dttutor;

internal class MyObjectRepr : PlacedObjectRepresentation
// instead of PlacedObjectRepresentation, any other representation class can be used(dnSpy the DevInterface namespace)
{
    public Handle secondHandle;
    public MyObjectData Data => pObj.data as MyObjectData; // getting data of our object
    public MyObjectRepr(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
    {
        secondHandle = new(owner, "handlethesecond", this, Data.handlePos); // setting pos from data
        // lets see what arguments do
        // 1. owner - just put owner
        // 2. id string - can be anything and used for signal function, more on that later
        // 3. parent node - self explanatory. handle moves with parent node
        // 4. position - based of parent node
        subNodes.Add(secondHandle); // IMPORTANT to add anything to subNodes

		fSprites.Add(new("pixel")); // adding line to draw
		owner.placedObjectsContainer.AddChild(fSprites[1]); // adding line to container to draw
		fSprites[1].anchorX = 0f; // changing some fsprite parameters for it to align normally
		fSprites[1].anchorY = 0f;
	}

	public override void Refresh() // overriding refresh method
	{
		base.Refresh();
        Data.handlePos = secondHandle.pos; // using pos instead of AbsPos to keep it relative in constructor

		MoveSprite(1, absPos); // moving sprite to pos of main handle(AbsPos is absolute position of handle on screen)
		fSprites[1].scaleY = secondHandle.pos.magnitude; // changing scale of line
		fSprites[1].rotation = Custom.AimFromOneVectorToAnother(absPos, secondHandle.absPos); // changing rotation of line
	}
}

If you kept placed object saved as file up to this point, you probably unable to enter the world, because placed object tries to get data that doesn't exists
To fix this just remove it from settings file

And here we go. the object representation has line and second handle is stored in settings file when we press save button
By creating save data we're also allowing our game object to use that data, so let's make it throw our player in direction of second handle

using UnityEngine;

namespace dttutor;

internal class MyObjectObject : UpdatableAndDeletable
//use CosmeticSprite for drawables
{
	public PlacedObject pObj; // storing object for future usage
	public MyObjectData Data => pObj.data as MyObjectData;
	public MyObjectObject(Room room, PlacedObject pObj)
	{
		this.room = room;
		this.pObj = pObj;
	}

	public override void Update(bool eu) //code that runs every tick
	{
		base.Update(eu);
		for (int i = 0; i < room.PlayersInRoom.Count; i++) //looping through each player in room
		{
			Player player = room.PlayersInRoom[i];
			if (Vector2.Distance(pObj.pos, player.bodyChunks[0].pos) < 20f) //if player near our object
			{
				player.bodyChunks[0].vel = Data.handlePos / 10f; // fling both body chunks in direction of handle
				player.bodyChunks[1].vel = Data.handlePos / 10f;
				// because of second handle position is relative to main handle we don't need to substract anything
			}
		}
	}
}

5. Custom Panels

What if we wanted to have data that we can't just have as a vector handle?

Panels Allows us to change data by using ui blocks

Let's create panel class inside of our representation and also create a variable that would be changed based on panel buttons

First off, adding new data to our Data class(also make sure again to remove any myObject you created in world)

using System.Globalization;
using System.Text.RegularExpressions;
using UnityEngine;

namespace dttutor
{
	internal class MyObjectData : PlacedObject.Data
	{
		public Vector2 handlePos; //storing handle pos
		public int mode;

		public MyObjectData(PlacedObject owner) : base(owner)
		{
			handlePos = new(20, 20); // default value of handle pos
		}

		public override void FromString(string s) //when we load data from file
		{
			string[] array = Regex.Split(s, "~");
			handlePos.x = float.Parse(array[0], NumberStyles.Any, CultureInfo.InvariantCulture); // setting pos of handle x and y
			handlePos.y = float.Parse(array[1], NumberStyles.Any, CultureInfo.InvariantCulture);
			mode = int.Parse(array[2], NumberStyles.Any, CultureInfo.InvariantCulture); //mode, some custom thing we can change
			unrecognizedAttributes = SaveUtils.PopulateUnrecognizedStringAttrs(array, 3); // all that we don't need
		}

		public override string ToString() //when we save data to file
		{
			string text = string.Format(CultureInfo.InvariantCulture, "{0}~{1}~{2}", new object[]
			{
				handlePos.x, handlePos.y, mode
			}); //formatting the data
			text = SaveState.SetCustomData(this, text);
			return SaveUtils.AppendUnrecognizedStringAttrs(text, "~", unrecognizedAttributes);
		}
	}
}

Then adding panel class and line from main handle to our panel

using DevInterface;
using RWCustom;
using UnityEngine;

namespace dttutor;

internal class MyObjectRepr : PlacedObjectRepresentation
// instead of PlacedObjectRepresentation, any other representation class can be used(dnSpy the DevInterface namespace)
{
    public Handle secondHandle;
    public MyObjectData Data => pObj.data as MyObjectData; // getting data of our object

	public MOPanel controlPanel;
    public MyObjectRepr(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
	{
	    secondHandle = new(owner, "handlethesecond", this, Data.handlePos); // setting pos from data
	    // lets see what arguments do
	    // 1. owner - just put owner
	    // 2. id string - can be anything and used for signal function, more on that later
	    // 3. parent node - self explanatory. handle moves with parent node
	    // 4. position - based of parent node
	    subNodes.Add(secondHandle); // IMPORTANT to add anything to subNodes
	
		controlPanel = new(owner, "MOPanel", this, new(20, 20)); // mind that position of control panel wouldn't be saved cause i didn't wrote that
		subNodes.Add(controlPanel);
	
		fSprites.Add(new("pixel")); // adding line to draw
		owner.placedObjectsContainer.AddChild(fSprites[1]); // adding line to container to draw
		fSprites[1].anchorX = 0f; // changing some fsprite parameters for it to align normally
		fSprites[1].anchorY = 0f;
	
		fSprites.Add(new("pixel")); // adding line to draw for control panel
		owner.placedObjectsContainer.AddChild(fSprites[2]);
		fSprites[2].anchorX = 0f;
		fSprites[2].anchorY = 0f;
	}

	public override void Refresh() // overriding refresh method
	{
		base.Refresh();
	    Data.handlePos = secondHandle.pos; // using pos instead of AbsPos to keep it relative in constructor
	
		MoveSprite(1, absPos); // moving sprite to pos of main handle(AbsPos is absolute position of handle on screen)
		fSprites[1].scaleY = secondHandle.pos.magnitude; // changing scale of line
		fSprites[1].rotation = Custom.AimFromOneVectorToAnother(absPos, secondHandle.absPos); // changing rotation of line
	
		MoveSprite(2, absPos); // moving sprite to pos of main handle to control panel
		fSprites[2].scaleY = controlPanel.pos.magnitude;
		fSprites[2].rotation = Custom.AimFromOneVectorToAnother(absPos, controlPanel.absPos);
	}

	public class MOPanel : Panel
	{
		public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos, Vector2 size, string title) : base(owner, IDstring, parentNode, pos, size, title)
		{
		}
		public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos) : this(owner, IDstring, parentNode, pos, new(100, 40), "My Panel")
			// creating default constructor
		{
			subNodes.Add(new Button(owner, "Ibutton", this, new(5, 5), 90, "da button")); // creating new button
			// keep in mind the button id
			// button height is 15 pixels
		}

	}
}

Now we need a way to change Data.mode somehow with panel

Signals

Signals are used to check specific actions of buttons and sliders. All we need to do is implement IDevUISignals interface on our panel
We have the Signal method that activates when button pressed

this is current panel class

public class MOPanel : Panel, IDevUISignals
{
	public MyObjectData Data => parentNode.Data; // our data
	public new MyObjectRepr parentNode => base.parentNode as MyObjectRepr; // overriding parent node for convenience
	public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos, Vector2 size, string title) : base(owner, IDstring, parentNode, pos, size, title)
	{
	}
	public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos) : this(owner, IDstring, parentNode, pos, new(100, 40), "My Panel")
		// creating default constructor
	{
		subNodes.Add(new Button(owner, "Ibutton", this, new(5, 5), 90, Data.mode.ToString())); // creating new button
		// keep in mind the button id
		// button height is 20 pixels
	}

	public void Signal(DevUISignalType type, DevUINode sender, string message)
	{
		switch (sender.IDstring)
		{
			case "Ibutton": // id of our button gets called
				//executing something
				Data.mode = (Data.mode + 1) % 5; // changing mode between 1-4
				(subNodes[0] as Button).Text = Data.mode.ToString();
				break;
			// a little bit weird to use switch case for only one button but it'll be fine once more buttons would be added
		}
	}
}

now when spawning our object we can see that panel appeared too

When pressing button we can see that our number goes up to 4 and then back to 0
All the data gets saved and loaded just fine

Panels have a lot of potential. Since panels are uiNodes, that means that you can put panels inside of panels inside of panels and etc
Only the panel with IDevUISignals actually recieve all the signals which is good for panels in panels

Panel in panel

Let's create another Panel class near our normal panel and make so you can open and close our new panel when pressing a button
for sake of convenience we will call panel that spawns panel a "Parent" panel and pannel that gets spawned as "Child" parent

public class MOPanel : Panel, IDevUISignals
{
	public MyObjectData Data => parentNode.Data; // our data
	public new MyObjectRepr parentNode => base.parentNode as MyObjectRepr; // overriding parent node for convenience

	public ChildPanel childPanel;
	public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos, Vector2 size, string title) : base(owner, IDstring, parentNode, pos, size, title)
	{
	}
	public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos) : this(owner, IDstring, parentNode, pos, new(100, 60), "My Panel")
		// creating default constructor
	{
		subNodes.Add(new Button(owner, "Ibutton", this, new(5, 5), 90, Data.mode.ToString())); // creating new button
																							   // keep in mind the button id
																							   // button height is 15 pixels
		subNodes.Add(new Button(owner, "IOpen", this, new(5, 25), 90, "open panel")); // creating button to open child
		
	}

	public void Signal(DevUISignalType type, DevUINode sender, string message)
	{
		switch (sender.IDstring)
		{
			case "Ibutton": // id of our button gets called
				//executing something
				Data.mode = (Data.mode + 1) % 5; // changing mode between 1-4
				(subNodes[0] as Button).Text = Data.mode.ToString();
				break;
			case "IOpen" when childPanel == null: // opening panel if one isn't opened yet
				childPanel = new(owner, "Cpanel", this, new(20, 20));
				subNodes.Add(childPanel);
				break;
			case "IClose" when childPanel != null: // if child panel wants to be closed
				childPanel.ClearSprites(); // removing all sprites panel created
				subNodes.Remove(childPanel); // stoping panel from being updated
				childPanel = null; // removing panel out of existance
				break;

		}
	}
}
public class ChildPanel : Panel
{
	public ChildPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos) : base(owner, IDstring, parentNode, pos, new(100, 40), "Child Panel")
	{
		subNodes.Add(new Button(owner, "IClose", this, new(5, 5), 90, "close"));
		// button to close this panel, signal would go to first parent node that has IDevUISignals
	}
}

When loading into the game we can see that our panel now has a second button, called "open panel"
If we press a button, child panel appears that we can close by pressing "close" button

Sliders

Sliders are used for number input
To create slider, we need to create Slider class and override 2 methods: NubDragged and Refresh
NubDragged method changes value if we dragged the slider nub
Refresh method does refresh stuff and applies data value to slider

Let's change that we can pick mode by using both slider and button

public class MOSlider : Slider
{
	public MOSlider(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos, string title, bool inheritButton, float titleWidth) : base(owner, IDstring, parentNode, pos, title, inheritButton, titleWidth)
	{
	}

	public override void NubDragged(float nubPos)
	{
		string idstring = this.IDstring;
		if (idstring != null && idstring == "ValSlider") // better to move first condition to outer scope if multiple sliders presented
		{
			(parentNode as MOPanel).Data.mode = (int)(nubPos * 4); // changing mode if nub dragged
			((parentNode as MOPanel).subNodes[0] as Button).Text = (parentNode as MOPanel).Data.mode.ToString(); // changing text of button
		}
		Refresh();
	}

	public override void Refresh()
	{
		base.Refresh();
		if (IDstring == "ValSlider")
		{
			float num = (parentNode as MOPanel).Data.mode / 4f; // loading mode
			NumberText = ((int)(num * 25)).ToString() + "% "; // changing text
			RefreshNubPos(num); // changing nub pos
		}
	}
}

And add slider to our panel's constructor

public MOPanel(DevUI owner, string IDstring, DevUINode parentNode, Vector2 pos) : this(owner, IDstring, parentNode, pos, new(200, 60), "My Panel")
	// creating default constructor
{
	subNodes.Add(new Button(owner, "Ibutton", this, new(5, 5), 90, Data.mode.ToString())); // creating new button
																						   // keep in mind the button id
																						   // button height is 15 pixels
	subNodes.Add(new Button(owner, "IOpen", this, new(5, 25), 90, "open panel")); // creating button to open child
	subNodes.Add(new MOSlider(owner, "ValSlider", this, new(5, 45), "Slider", false, 35));
	// 1. owner, leave as owner
	// 2. id string, used by slider to input values
	// 3. parent node - self explanatory.
	// 4. pos - position on panel from bottom right corner
	// 5. title - slider text
	// 6. inherit button - whenever slider should have inherit button
	// 7. title width
}

When we spawn our object we can see that slider appeared and we can move it to change mode
Slider is fixed to 5 different positions because we make it do so

Slider position gets saved because of Data.mode gets saved

Custom category

If we have created a lot of dev-tools objects, it would be better to create custom category for all of them

To add custom category we need to hook On.DevInterface.ObjectsPage.DevObjectGetCategoryFromPlacedType
Again we can add hook to DevtoolsInit

public static void Init() // call init function from plugin.OnEnable
{
	myObject = new("My_Object", true); // important to set register argument as true to uh register

	myCategory = new("My_Category", true); // creating custom category
	CategoryItems = new PlacedObject.Type[] {myObject}; // adding myobject to type list

	On.Room.Loaded += Room_Loaded; // room loaded hook to spawn objects
	On.DevInterface.ObjectsPage.CreateObjRep += ObjectsPage_CreateObjRep; // creating representation
	On.PlacedObject.GenerateEmptyData += PlacedObject_GenerateEmptyData; // creating data
	On.DevInterface.ObjectsPage.DevObjectGetCategoryFromPlacedType += ObjectsPage_DevObjectGetCategoryFromPlacedType; // creating category
}
public static PlacedObject.Type myObject; // our own object type

public static PlacedObject.Type[] CategoryItems; //much easier to manage if we use array instead of picking types manually
public static ObjectsPage.DevObjectCategories myCategory; // custom category for all that bs

private static ObjectsPage.DevObjectCategories ObjectsPage_DevObjectGetCategoryFromPlacedType(On.DevInterface.ObjectsPage.orig_DevObjectGetCategoryFromPlacedType orig, ObjectsPage self, PlacedObject.Type type)
{
	if (CategoryItems.Contains(type)) // if our object is in array
	{
		return myCategory; // add it to category
	}
	return orig(self, type);
}

Now all objects we put in CategoryItems will be displayed in our own category

Other classes

For adding more new objects you should also change 3 other hooks i mentioned before
If you want to use different classes you should change data class too

GridRectObjectRepresentation

GridRectObjectRepresentation is used for rectangles
It is important to use PlacedObject.GridRectObjectData as data class or inherit from it

Representation contains 2 handles and a rect sprite that can be dragged like windows select

using DevInterface;

namespace dttutor;

internal class GridRect : GridRectObjectRepresentation
{
	public GridRect(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
	{
		// GridRectObjectRepresentation already uses 5 sprites so if new fsprites should be added as fsprite[6], fsprite[7] etc
	}

	public class GridrectData : PlacedObject.GridRectObjectData
	{
		public GridrectData(PlacedObject owner) : base(owner)
		{
			// handlePos is already exists in data
			// Data.Rect is also very useful
		}
	}
	/*
	//to get it as rect, use
	 		
	IntRect rect = Data.Rect;
	rect.bottom *= 20;
	rect.top *= 20;
	rect.left *= 20;
	rect.right *= 20;
	rect.right++;
	rect.top++;

	// to check if it touches vector use rect.ToFloatRect().Vector2Inside(__vector__)
	*/
}

ResizeableObjectRepresentation

ResizeableObjectRepresentation is just 2 handles connected with a line
Ring can be enabled as on the image

using DevInterface;

namespace dttutor
{
	internal class ResizeableObject : ResizeableObjectRepresentation
	{
		public ResizeableObject(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name, bool showRing) : base(owner, IDstring, parentNode, pObj, name, showRing)
		{
		}
		public ResizeableObject(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : this(owner, IDstring, parentNode, pObj, name, true)
		{
			// show ring does exactly what you think it does
		}

		public class ROData : PlacedObject.ResizableObjectData
		{
			public ROData(PlacedObject owner) : base(owner)
			{
				//Rad gets the radius
				//handlePos for handle pos
			}
		}
	}
}

TileObjectRepresentation

TileObjectRepresentation is just a handle
PlacedObject.Data is used as data
Nothing special

using DevInterface;

namespace dttutor
{
	internal class TileObject : TileObjectRepresentation
	{
		public TileObject(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
		{
		}
	}
}

QuadObjectRepresentation

QuadObjectRepresentation is 4 handles, used for decals and other stuff

using DevInterface;

namespace dttutor
{
	internal class QuadObject : QuadObjectRepresentation
	{
		public QuadObject(DevUI owner, string IDstring, DevUINode parentNode, PlacedObject pObj, string name) : base(owner, IDstring, parentNode, pObj, name)
		{
		}
		public class QOData : PlacedObject.QuadObjectData
		{
			public QOData(PlacedObject owner) : base(owner)
			{
				// handles - collection of points
			}
		}
	}
}

Useful stuff

allstuff.zip - All that i've shown here

this page might require some fixes