Godot-Auto-Export-Version

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

Godot-Auto-Export-Version

★ 73 Open GitHub ↗

Plugin for Godot that automatically updates your version every time you export the project.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# <img src="Media/Icon.png" width="64" height="64"> Godot Auto Export Version

Ever wanted to display the current version of your game somewhere? You did, but you don't have idea what to display or you forget to update it every time? This plugin is for you.

Every time you export the project, `application/config/version` project setting will be updated. Use this setting anywhere to display the version. Now your version automatically updates and you don't need to remember to update your scenes.

## Plugin setup

After you enable the plugin, go to Project Settings and configure it at `addons/ExportAutoVersion` section (advanced mode).
- `Version Store Location` - Defines where the version will be stored. By default the version is stored in a project setting, but can be also in a script file that you can preload.
- `Version File Path` - If you use the script store option, this defines where the script will be located.
- `Version Setting Name` - If you use Project Settings store option, the version will be stored under this setting.
- `Version Config File` - Script for version configuration. It extends `VersionProvider.gd`. The file is automatically created when you enable the addon for the first time, modify this setting to move the file somewhere else.

The last thing to do is to implement `get_version()` method in the version config file (`res://auto_export_version_config_file.gd` by default). It should return a String from some external source that contains your current version. A few "version providers" are included by default:
- Git version (`get_git_commit_count()`) - If your project is inside git repository, the plugin will fetch the number of commits and use it as current version.
- Git branch version (`get_git_branch_name()`) - If your project is inside git repository, the plugin will fetch the current branch's name.
- Git hash version (`get_git_commit_hash()`) -  If your project is inside git repository, the plugin will fetch the latest commit's hash.
- Profile version (`get_export_preset_version()`) - If you have export presets that contain some version string (e.g. for Android), this will fetch the version from that profile. Normally it's not possible to display this version in the project, hence the plugin is useful.
- Android version (`get_export_preset_android_version_code()`, `get_export_preset_android_version_name()`) - same as above, but specialized for Android. Instead of version field, it uses both version code and version name and you can customize what format is used to display it.

To use any of these providers just uncomment the line starting with `#`. All of them are methods that return a String, so you can combine them to your liking. Or you can write a custom one (also if you have some good idea, you can open an issue and it might be officially included with this plugin; the plugin originally started with only 2 providers).

## How to use the version

After each project export, the plugin will update the version project setting, or `version.gd` file depending on configuration.

Example for using the setting:
```GDScript
extends Label

func _ready():
	text = "v%s" % ProjectSettings.get_setting("application/config/version")
```
Attach it to any Label and it will display the current version and auto-update after each project export. Now you can forget about it, because it's all automatic.

![](https://raw.githubusercontent.com/KoBeWi/Godot-Auto-Export-Version/master/Media/ReadmeV3.png)

If you use the script version location, the code will be instead:
```GDScript
extends Label

func _ready():
	text = "v%s" % load("res://version.gd").VERSION
```

If you want to print/update the current version without exporting the project, you can use the option in Project -> Tools menu called 'Print and Update Current Version'. This will display the version and update it as if the export was started. The option is also available in the Command Palette.

Special thanks to [@Kubulambula](https://github.com/Kubulambula) for refactoring the plugin and porting it to Godot 4.0.

## Localization

The addon supports translations and will automatically use the editor's language, if available. Currently only Polish translation is available. To make a new translation use the Template.pot file found in the addon's folder and feel free to open a pull request.

___
You can find all my addons on my [profile page](https://github.com/KoBeWi).

Godot-Auto-Export-Version

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README