update images and related information
|
Before Width: | Height: | Size: 2.2 KiB |
|
After Width: | Height: | Size: 1.8 KiB |
|
Before Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 9.2 KiB |
|
Before Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 9.6 KiB |
|
Before Width: | Height: | Size: 1.8 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
Before Width: | Height: | Size: 1.6 KiB |
|
After Width: | Height: | Size: 3.4 KiB |
|
Before Width: | Height: | Size: 7.9 KiB |
|
After Width: | Height: | Size: 6.1 KiB |
|
Before Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
Before Width: | Height: | Size: 5.9 KiB |
|
After Width: | Height: | Size: 6.2 KiB |
|
Before Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 9.4 KiB |
@@ -15,7 +15,7 @@ The preferred way to find Godot plugins is to use the
|
||||
browsed online, it's more convenient to use it directly from the editor.
|
||||
To do so, click the **AssetLib** tab at the top of the editor:
|
||||
|
||||
.. image:: img/installing_plugins_assetlib_tab.png
|
||||
.. image:: img/installing_plugins_assetlib_tab.webp
|
||||
|
||||
You can also find assets on code hosting websites such as GitHub.
|
||||
|
||||
@@ -58,11 +58,10 @@ Enabling a plugin
|
||||
|
||||
To enable the freshly installed plugin, open **Project > Project Settings** at
|
||||
the top of the editor then go the **Plugins** tab. If the plugin was packaged
|
||||
correctly, you should see it in the list of plugins. Click on the gray
|
||||
**Inactive** text and choose **Active** to enable the plugin. The word
|
||||
**Active** will display in green to confirm the plugin was enabled.
|
||||
correctly, you should see it in the list of plugins. Click on the
|
||||
**Enable** checkbox to enable the plugin.
|
||||
|
||||
.. image:: img/installing_plugins_project_settings.png
|
||||
.. image:: img/installing_plugins_project_settings.webp
|
||||
|
||||
|
||||
You can use the plugin immediately after enabling it; there's no need to restart
|
||||
|
||||
@@ -32,11 +32,11 @@ placing them where they need to be.
|
||||
|
||||
In the main toolbar, click the ``Project`` dropdown. Then click
|
||||
``Project Settings...``. Go to the ``Plugins`` tab and then click
|
||||
on the ``Create`` button in the top-right.
|
||||
on the ``Create New Plugin`` button in the top-right.
|
||||
|
||||
You will see the dialog appear, like so:
|
||||
|
||||
.. image:: img/making_plugins-create_plugin_dialog.png
|
||||
.. image:: img/making_plugins-create_plugin_dialog.webp
|
||||
|
||||
The placeholder text in each field describes how it affects the plugin's
|
||||
creation of the files and the config file's values.
|
||||
@@ -75,7 +75,7 @@ To continue with the example, use the following values:
|
||||
|
||||
You should end up with a directory structure like this:
|
||||
|
||||
.. image:: img/making_plugins-my_custom_mode_folder.png
|
||||
.. image:: img/making_plugins-my_custom_mode_folder.webp
|
||||
|
||||
``plugin.cfg`` is an INI file with metadata about your plugin.
|
||||
The name and description help people understand what it does.
|
||||
@@ -209,7 +209,7 @@ That's it for our basic button. You can save this as ``my_button.gd`` inside the
|
||||
plugin folder. You'll also need a 16×16 icon to show in the scene tree. If you
|
||||
don't have one, you can grab the default one from the engine and save it in your
|
||||
`addons/my_custom_node` folder as `icon.png`, or use the default Godot logo
|
||||
(`preload("res://icon.png")`). You can also use SVG icons if desired.
|
||||
(`preload("res://icon.svg")`).
|
||||
|
||||
.. image:: img/making_plugins-custom_node_icon.png
|
||||
|
||||
@@ -265,13 +265,13 @@ With that done, the plugin should already be available in the plugin list in the
|
||||
|
||||
Then try it out by adding your new node:
|
||||
|
||||
.. image:: img/making_plugins-custom_node_create.png
|
||||
.. image:: img/making_plugins-custom_node_create.webp
|
||||
|
||||
When you add the node, you can see that it already has the script you created
|
||||
attached to it. Set a text to the button, save and run the scene. When you
|
||||
click the button, you can see some text in the console:
|
||||
|
||||
.. image:: img/making_plugins-custom_node_console.png
|
||||
.. image:: img/making_plugins-custom_node_console.webp
|
||||
|
||||
A custom dock
|
||||
^^^^^^^^^^^^^
|
||||
@@ -319,7 +319,7 @@ The name of the root node will also be the name that appears on the dock tab,
|
||||
so be sure to give it a short and descriptive name.
|
||||
Also, don't forget to add some text to your button.
|
||||
|
||||
.. image:: img/making_plugins-my_custom_dock_scene.png
|
||||
.. image:: img/making_plugins-my_custom_dock_scene.webp
|
||||
|
||||
Save this scene as ``my_dock.tscn``. Now, we need to grab the scene we created
|
||||
then add it as a dock in the editor. For this, you can rely on the function
|
||||
@@ -394,16 +394,16 @@ Checking the results
|
||||
|
||||
It's now time to check the results of your work. Open the **Project
|
||||
Settings** and click on the **Plugins** tab. Your plugin should be the only one
|
||||
on the list. If it is not showing, click on the **Update** button in the
|
||||
top-right corner.
|
||||
on the list.
|
||||
|
||||
.. image:: img/making_plugins-project_settings.png
|
||||
.. image:: img/making_plugins-project_settings.webp
|
||||
|
||||
You can see the plugin is inactive on the **Status** column; click on the status
|
||||
to select **Active**. The dock should become visible before you even close
|
||||
You can see the plugin is not enabled.
|
||||
Click the **Enable** checkbox to activate the plugin.
|
||||
The dock should become visible before you even close
|
||||
the settings window. You should now have a custom dock:
|
||||
|
||||
.. image:: img/making_plugins-custom_dock.png
|
||||
.. image:: img/making_plugins-custom_dock.webp
|
||||
|
||||
Going beyond
|
||||
~~~~~~~~~~~~
|
||||
|
||||