Allow editor plugins to modify run arguments

Author: dsnopek

doc/classes/EditorPlugin.xml

@@ -362,6 +362,20 @@
 				Remember that you have to manage the visibility of all your editor controls manually.
 			</description>
 		</method>
+		<method name="_run_scene" qualifiers="virtual">
+			<return type="PackedStringArray" />
+			<param index="0" name="scene" type="String" />
+			<param index="1" name="args" type="PackedStringArray" />
+			<description>
+				This function will be called when the project or individual scene is about to be played in the editor. The [param args] to run Godot are passed in, and will be replaced by the return value.
+				[codeblock]
+				func _run_scene(scene, args):
+					args.push_back("--an-extra-argument")
+					return args
+				[/codeblock]
+				[b]Note:[/b] Text that is printed in this method will not be visible in the editor Output panel unless [member EditorSettings.run/output/always_clear_output_on_play] is [code]false[/code].
+			</description>
+		</method>
 		<method name="_save_external_data" qualifiers="virtual">
 			<return type="void" />
 			<description>

editor/editor_node.cpp

@@ -7044,6 +7044,13 @@ bool EditorNode::call_build() {
 	return builds_successful;
 }
 
+void EditorNode::call_run_scene(const String &p_scene, Vector<String> &p_args) {
+	for (int i = 0; i < editor_data.get_editor_plugin_count(); i++) {
+		EditorPlugin *plugin = editor_data.get_editor_plugin(i);
+		plugin->run_scene(p_scene, p_args);
+	}
+}
+
 void EditorNode::_inherit_imported(const String &p_action) {
 	open_imported->hide();
 	load_scene(open_import_request, true, true);

editor/editor_node.h

@@ -728,6 +728,7 @@ class EditorNode : public Node {
 	void _on_plugin_ready(Object *p_script, const String &p_activate_name);
 
 	bool call_build();
+	void call_run_scene(const String &p_scene, Vector<String> &p_args);
 
 	// This is a very naive estimation, but we need something now. Will be reworked later.
 	bool is_editor_ready() const { return is_inside_tree() && !waiting_for_first_scan; }

editor/plugins/editor_plugin.cpp

@@ -531,6 +531,13 @@ bool EditorPlugin::build() {
 	return success;
 }
 
+void EditorPlugin::run_scene(const String &p_scene, Vector<String> &p_args) {
+	Vector<String> new_args = p_args;
+	if (GDVIRTUAL_CALL(_run_scene, p_scene, p_args, new_args)) {
+		p_args = new_args;
+	}
+}
+
 void EditorPlugin::queue_save_layout() {
 	EditorNode::get_singleton()->save_editor_layout_delayed();
 }
@@ -665,6 +672,7 @@ void EditorPlugin::_bind_methods() {
 	GDVIRTUAL_BIND(_set_window_layout, "configuration");
 	GDVIRTUAL_BIND(_get_window_layout, "configuration");
 	GDVIRTUAL_BIND(_build);
+	GDVIRTUAL_BIND(_run_scene, "scene", "args");
 	GDVIRTUAL_BIND(_enable_plugin);
 	GDVIRTUAL_BIND(_disable_plugin);
 

editor/plugins/editor_plugin.h

@@ -133,6 +133,7 @@ class EditorPlugin : public Node {
 	GDVIRTUAL1(_set_window_layout, Ref<ConfigFile>)
 	GDVIRTUAL1(_get_window_layout, Ref<ConfigFile>)
 	GDVIRTUAL0R(bool, _build)
+	GDVIRTUAL2RC(Vector<String>, _run_scene, String, Vector<String>)
 	GDVIRTUAL0(_enable_plugin)
 	GDVIRTUAL0(_disable_plugin)
 
@@ -202,6 +203,7 @@ class EditorPlugin : public Node {
 	virtual void get_window_layout(Ref<ConfigFile> p_layout);
 	virtual void edited_scene_changed() {} // if changes are pending in editor, apply them
 	virtual bool build(); // builds with external tools. Returns true if safe to continue running scene.
+	virtual void run_scene(const String &p_scene, Vector<String> &p_args);
 
 	EditorInterface *get_editor_interface();
 	ScriptCreateDialog *get_script_create_dialog();

editor/run/editor_run_bar.cpp

@@ -315,8 +315,11 @@ void EditorRunBar::_run_scene(const String &p_scene_path, const Vector<String> &
 		return;
 	}
 
+	Vector<String> args = p_run_args;
+	EditorNode::get_singleton()->call_run_scene(run_filename, args);
+
 	EditorDebuggerNode::get_singleton()->start();
-	Error error = editor_run.run(run_filename, write_movie_file, p_run_args);
+	Error error = editor_run.run(run_filename, write_movie_file, args);
 	if (error != OK) {
 		EditorDebuggerNode::get_singleton()->stop();
 		EditorNode::get_singleton()->show_accept(TTR("Could not start subprocess(es)!"), TTR("OK"));