Struggling with API when making a custom editor script

Hi, new Flax user here. I’m struggling with the API for custom editor scripts. I’ve got the initial setup done as described by

I’ve spent hours reading the documentation, but can’t figure out how to do any of the following:

  1. After changes are made that update values in the Properties window (in my case, a Label field), the Properties window is not repainted automatically. I have to click on another actor, then my actor with the custom editor, to get the Properties window to repaint/refresh. I’ve seen the same behaviour in Unity which is solved by calling a Repaint() function. Flax’s GenericEditor class has a Refresh() function that looks like it should do the same thing, but calling Refresh() doesn’t have any effect. What’s the proper way to get the Properties windows to repaint?

  2. Each use of “var button = layout.Button( “SomeLabel” );” creates a button on a new row. How can I create a group of buttons on the same row (in the Properties windows, for a customer editor)?

  3. Is it possible to create a button labeled with an image instead of text (in the Properties windows, for a customer editor)?

I leave here how I have been using custom editor, I hope it answers your questions.

  1. You need to keep a reference for the elements that need to be updated, overriding Refresh method and set there the new value.

  2. You can use HorizontalPanelElement for having more than one element in the same row

  3. Use an ImageElement instead a button , get the GUI Image and use Click action Use BackgroundBrush GUI Button. Updated script.


using FlaxEditor.CustomEditors;
using FlaxEditor.CustomEditors.Dedicated;
using FlaxEditor.CustomEditors.Elements;
using FlaxEngine;

namespace Game
    public class CustomEditor : Script
        // Using ActorEditor for test pruporses and avoid having a Script.
        public class MyScriptEditor : ActorEditor
            private Spline Actor;
            private LabelElement labelThatNeedTextBeUpdated;

            private string GetLabelContent()
                => string.Format("My Custom Editor: {0}", Actor?.Position.ToString());

            public override void Initialize(LayoutElementsContainer layout)
                Actor = (Spline)Values[0];
                labelThatNeedTextBeUpdated = layout.Label(GetLabelContent(), TextAlignment.Center);

                var groupOfButtons = layout.HorizontalPanel();
                var button1 = groupOfButtons.Button("Button 1");
                var button2 = groupOfButtons.Button("Button 2");
                var button3 = groupOfButtons.Button(string.Empty);

                button3.Button.Width = 64;
                button3.Button.Height = 64;
                button3.Button.BackgroundBrush = new SpriteBrush(FlaxEditor.Editor.Instance.Icons.Flax64);
                button3.Button.AnchorPreset = AnchorPresets.TopLeft;

            public override void Refresh()

                if(labelThatNeedTextBeUpdated != null)
                    labelThatNeedTextBeUpdated.Label.Text = GetLabelContent();

This is the result. The label is updated, tested changing the Actor name or moving it gets updated

1 Like

That worked! I got all my questions answered, learned a ton about how Flax works under the hood, and taught myself how to set up a sprite atlas for my button’s sprites.

Thank you very much for the fast reply and especially for the example script.