godot 4.0 tool_button

Toolbuttonplugin for Godot 4.0 -V1.4

编辑按钮一行代码： @tool代码零行。

只需安装，然后选择任何节点：

• 公共方法将在编辑面板的底部列出。
• 还将显示带有0个参数的信号。

有关更高级的功能，请阅读下面。

入门

• 启用插件。
• 将@tool添加到脚本的顶部。
• 添加_get_tool_buttons() -> Array方法。
• 数组项目可以是：
  • 方法"my_method"的名称
  • 方法本身my_method
  • BOND method.bind(true, "ok" 1.0)
  • 匿名方法func(): print("Hey!")
  • 带有名称func press_me(): print("You pressed me!")
  • 信号的名称"my_signal"
  • 信号本身my_signal
  • 带有信号和参数的数组["my_signal", [true, "ok"]]
  • 带有微调控制的字典： {call=method.bind(true), text="My Method", tint=Color.RED}
  • 具有以上任何一个["my_method", method2.bind(1.0), "a_signal", {text="X", call=reset}]数组

高级示例

要指定在检查器上方显示的按钮，请添加_get_tool_buttons func。

与Strings ：

@tool
extends Node

func _get_tool_buttons() :
	return [ boost_score, remove_player ]

func boost_score() :
	Player.score += 100

func remove_player() :
	Player.queue_free()

和/或Callable s

 # WARNING, some stuff won't work: If you get *"Cannot access member without instance"*: https://github.com/godotengine/godot/issues/56780
@tool
extends Node

func _get_tool_buttons() :
	return [
		func add_score() : score += 10 ,
		func reset_health() : health = 0
	]

和/或Dictionarys

@tool
extends Node

signal reset()

func _get_tool_buttons() : return [
	" boost_score " ,
	{ call = " boost_score " , args = [ 100 ] , tint = Color.DEEP_SKY_BLUE } ,
	{ call = " emit_signal " , args = [ " reset " ] , text = " Reset " , tint = Color.TOMATO } ,
	{
		call = func() : print( " My Health: " , health),
		text = " Print Health " ,
		tint = func() : return Color(health * . 1 , 0.0 , 0.0 )
		lock = func() : return health == 100
	}
]

func boost_score(x = 10 ) :
	Player.score += x

call是强制性的。他人是可选的。

钥匙	desc	默认
称呼	打电话的方法。	-
args	一系列论点要通过。 （鼠标按钮以查看Args。）	-
文本	按钮标签。	-
着色	按钮颜色。	颜色。白色
图标	按钮图标。	-
平坦的	按钮是平坦的样式。	错误的
暗示	提示鼠标的文本。	-
打印	打印方法调用？	真的
对齐	按钮对齐。	BoxContainer.Alignment_Center
锁	禁用按钮？	错误的
update_filesystem	告诉Godot编辑恢复文件系统。	错误的

资源示例

对于_get_tool_buttons来说，要在需要静态的Resource上工作。

@tool
extends Resource
class_name MyResource

# STATIC
static func _get_tool_buttons() :
	return [ " my_button " ]

# LOCAL
export(String) var my_name : String = " "

func my_button() :
	print(my_name)

信号

signal my_signal()
signal my_arg_signal(x, y)

func _get_tool_buttons() :
	return [
		my_signal,
		[ my_arg_signal, [ true , " okay " ]]
	] 

多按钮支持

您可以在同一行上有多个按钮。
它们都可以立即根据切换（默认值）或单独调用。

 func _get_tool_buttons():
	return [
		[msg, msg.bind("yes"), msg.bind("no")],
	]

func msg(msg := "Default Message"):
	print("Got: ", msg)

func doit():
	pass

更改

1.4

• 添加了信号支持。
• 在同一行中增加了对多个按钮的支持。
• 添加了自动生成的按钮，以测试公共方法。
• 添加了自动生成的按钮，以测试无参数信号。
• 自动色调方法按钮蓝色和信号按钮黄色。
• 很多修理。

1.3

• 添加@SELECT_AND_EDIT::file_path ， @EDIT_RESOURCE::file_path ， @SELECT_FILE::file_path 。

1.2

• 添加了“打印元”按钮，该按钮将在对象中打印所有元数据。

1.1

• 更新为Godot 4.0.alpha2
• 添加了Callable支持call text icon tint lock ： { text="Callable", call=func(): print("From Callable with love") }
• disabled更改为lock
• 底部按钮按字母顺序排序。