tutorials/scripting/gdscript/gdscript_exports

[giscus[bot]]

tutorials/scripting/gdscript/gdscript_exports

In Godot, class members can be exported. This means their value gets saved along with the resource (such as the scene) they're attached to. They will also be available for editing in the property e...

https://docs.godotengine.org/en/latest/tutorials/scripting/gdscript/gdscript_exports.html

[Lazy-Rabbit-2001]

What about @export_custom?

[Calinou]

Pull request opened:

• Document @export_custom and additional range hints in GDScript exports godot-docs#9993

[berarma]

There's no mention that a description text can be added to exported vars starting the preceding line with ##.

## This is my description text
@export var a: int

[Calinou]

Pull request opened:

• Mention documentation comments in GDScript basics godot-docs#10097

[RensTillmann]

What if you want to listen to a value being changed for exported properties, for instance a bool value changing from true to false. And preferably outside of _process()? Is it possible?

[Kartopod]

You can make a setter on the property. Note that you would need to make the script @tool for this.

@tool

signal my_property_changed(new_value: bool)
@export var my_property: bool:
	set(value):
		my_property_changed.emit(value)

Also note that you may need to reload the scene/editor for this to take effect.

[dillydadally]

What about if you only want to specify a min or a max to a value instead of a range? For example, if I am exporting a variable called max_health, I want to set the min to 1 (as 0 for max health makes no sense), but I don't want to provide an upper limit. How would I do that?

It seems like an @export_min and @export_max might be nice or a keyword you can use in the @export_range (note that INF won't work for ints I believe).

[Calinou]

If you specify or_greater and/or or_less at the end of the hint string, values won't be limited for the upper/lower bound. The upper/lower bound you specify will only be used for the slider display, not for numeric input or dragging the number (unless you drag the slider directly).

[dillydadally]

Great idea! Still not a perfect solution but a much better one that I thought existed at present!