Repository files navigation

This library is a collection of visual script custom nodes that anyone can use in their projects.

It's purpose is to make thevisual scripting work flow in Godot easier.

Some nodes from the library in use:

To use the custom nodes in this library you have to copy theaddons folder from this repo into your project.

Then go toProject Setting>Plugins and set the status of theVisualScript Library plugin to activate.

This node is useful for loading all the files in a directory into adictionary. These files can be any files that can be loaded with theResourceLoader. This is useful for loading random scenes or textures for example.

Apply a random texture from theSprites folder to a sprite:

You can contribute in many ways; If you have questions or suggestions, just open an issue here on GitHub. If you have an idea for a node, be sure to first post it in the Node Brainstorming issue (#4), so you can get feedback. After your idea has been approved, follow these steps:

1. Get started by making a fork of this repository and creating a branch for your custom node

2. Create a new Godot project and either copy theaddons folder into it or create a symlink. Theaddons folder is where Godot loads plugins from, so it's name is important.

3. Create a new GDScript in theaddons/vs_custom_nodes directory. Name it by the name of your custom node inCamelCase, which should not include the word "Node" and describe what is does, for exampleEatApples.

4. Now it's time to get started scripting our custom node! All custom nodes should extendVisualScriptCustomNode and have atool keyword at the top.

   

5. There are some getter functions you will need to add to set some parameters. Look at some of the existing nodes to see what you need. Only add functions that are really needed, you don't need a_has_input_sequence_port if it should returnfalse for example.

6. Now comes the most important part of your custom node, the_step function. All the logic happens in here. You can modify theoutput array and theworking_mem to create your functionality.If you want to throw an error, if the inputs are incorrect for example, then you need to return the error as a string. When everything goes all right, return the id of the sequence port which should be called next. If your custom node doesn't have any, just return 0.

7. If you have your custom node all done, you need to register it inaddvsnodes.gd. Add a ppreload statement at the top, aadd_custom_node one in_enter_tree and aremove_custom_node in_exit_tree. Be sure to give it a unique id and the correct category.

8. Now you can test your node by enabling the plugin inProject->Project Settings->Plugins and adding your custom node to a VisualScript.

9. If it works how you want it to, create a pull request and wait for it to be merged.

For help PM me on @steincodes on Twitter and follow me there for more updates on the project.

Keep track in the project board of any updates and plans before starting something.