Lyaaaaaaaaaaaaaaa / godot-console

In-game console for Godot 3.

Godot Console

In-game console for Godot, which could be easily extended with new commands.

• Godot Console
  • Features
  • Installation
    • Via GIT (preferred)
    • Via Editor AssetLib
  • Example usage
  • Contributors
  • License

Features:

• Creating custom commands with add_command.

• Autocomplete with TAB keyboard key.

• Writing to console using write and write_line methods. You can also use BB codes.

  (Is also printed to engine output)

• Session command history (using UP and DOWN keyboard arrows).

• Flexible types:

  • Engine types
  • Extra types
  • Custom types

• FuncRef support with Godot >=3.2 (can be used as a command target).

Installation:

Via GIT (preferred):

1. Clone this project or download latest release.
2. Copy ./godot/addons/quentincaffeino-console into your projects addons folder.

So you will have this structure:

res://
├── addons
│   ├── quentincaffeino-console
│   ├── ...

3. Open Project > Project Settings > Plugins, search for quentincaffeino-console and check the Enable checkbox.
4. You can activate the console with ` while running your game (can be changed, see quentincaffeino_console_toggle action).

Via Editor AssetLib:

1. Open AssetLib.
2. Search for Console, category is Scripts; Open it and click Donwload and then Install.
3. Click install. Package installer will copy filestructure as-is so you will have this directories in your project: godot/addons/quentincaffeino-console.
4. Create addons folder if you haven't already and move quentincaffeino-console there so you will have this structure:

res://
├── addons
│   ├── quentincaffeino-console
│   ├── ...

5. Open Project > Project Settings > Plugins, search for quentincaffeino-console and check the Enable checkbox.
6. You can activate the console with ` while running your game (can be changed, see quentincaffeino_console_toggle action).

Example usage:

Usage we will get:

$ sayHello "Adam Smith"
Hello Adam Smith!

Function that will be called by our command:

func print_hello(name = ''):
	Console.write_line('Hello ' + name + '!')

Registering command:

func _ready():
	# 1. argument is command name
	# 2. arg. is target (target could be a funcref)
	# 3. arg. is target name (name is not required if it is the same as first arg or target is a funcref)
	Console.add_command('sayHello', self, 'print_hello')\
		.set_description('Prints "Hello %name%!"')\
		.add_argument('name', TYPE_STRING)\
		.register()

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Sergei ZH 💻 💬 📖 🤔 👀	Michael Brune ️️️️♿️ 🐛	Michael Aganier 🐛	hpn332 🐛	Danil 🐛	Paul Hocker 🐛	Samantha Clarke 🐛	Hugo Locurcio ️️️️♿️
Dmitry Derbin 💬	VitexHD 🐛	hilfazer 💻	Crazy Chenz 💻	Marcus Schütte 💻	Kimmo Salmela 💻	GuillaumeCailhe 🐛 🤔 💬	Josh DeGraw 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

License

Licensed under the MIT license, see LICENSE.md for more information.