https://github.com/christinec-dev/gdscriptcodeupgrader

Code Upgrader is a tool designed to help upgrade your GDScript code from Godot 3 to Godot 4. This plugin automates the process of updating deprecated methods, properties, and syntax, ensuring your projects are compatible with the latest version of Godot.
https://github.com/christinec-dev/gdscriptcodeupgrader

code converter godot godot-engine plugin

Last synced: 3 months ago
JSON representation

Code Upgrader is a tool designed to help upgrade your GDScript code from Godot 3 to Godot 4. This plugin automates the process of updating deprecated methods, properties, and syntax, ensuring your projects are compatible with the latest version of Godot.

• Host: GitHub
• URL: https://github.com/christinec-dev/gdscriptcodeupgrader
• Owner: christinec-dev
• License: mit
• Created: 2024-08-09T08:19:20.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-08-21T13:27:40.000Z (9 months ago)
• Last Synced: 2025-01-31T04:24:37.435Z (3 months ago)
• Topics: code, converter, godot, godot-engine, plugin
• Language: GDScript
• Homepage: https://christinecdevs.site
• Size: 817 KB
• Stars: 12
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Code Upgrader Plugin

Code Upgrader is a tool designed to help upgrade your GDScript code from Godot 3 to Godot 4. This plugin automates the process of updating deprecated methods, properties, and syntax, ensuring your projects are compatible with the latest version of Godot.

## Notice 

This plugin is a work-in-progress tool.

Please know that I might not have picked up all the changes, as there are a lot, so if you find ones that I haven’t added, you can let me know and I will implement those fixes into the plugin! 

Join my Discord if you want to give feedback on this plugin or to help me update it: https://discord.gg/FnD8355w

### Next Steps

- Do more focused testing on all the individual Nodes, especially for the TileMapLayer node, to see where I can add more conversions.

- Continuously test the updated functions with a variety of code snippets to ensure that all transformations are applied correctly and do not interfere with each other or modify unintended parts of the code.

- Optimize the performance, especially if applied to large bodies of code, and optimize or refactor as necessary to ensure efficiency.

## Links

- [Wiki](https://github.com/christinec-dev/GDScriptCodeUpgrader/wiki/Tutorial)

- [AssetLib Download](https://godotengine.org/asset-library/asset/3217)

## Usage Instructions 

- Download the plugin and enable it.

- If enabled correctly, there should be a new dock on the left side of the editor.

- This dock has two parts: a code input and an output panel.

- We will paste our Godot 3 code in the input panel, and copy our Godot 4 code from the output panel.

- Press execute and your code should be converted!

## Screenshots

![Screenshot 2024-08-09 100646](https://github.com/user-attachments/assets/fc175a57-70c6-40b7-bd70-07784d5944d7)

![Screenshot 2024-08-09 100719](https://github.com/user-attachments/assets/a5af7c62-1634-4f26-9639-4401fb79cc03)

## Completion Log

- Replacements for `export` and `onready` keywords.

- Transformation of `yield` statements to await with various patterns.

- Updated `signal connection` syntax to use direct method calls.

- Modified `signal connection` syntax to include `parameters` with binding.

- Simplified `move_and_slide()` usage and removed specific property assignments.

- Transformed `signal emission` syntax to `direct method` calls.

- Handled `signal emissions` with `parameters`.

- Updated `file` opening syntax with a detailed commented guide.

- Added the guide for the `set_cell` and `set_cell_v` syntax.

- Changed access from `.cell_size` to .tile_set.tile_size.

- Transformed `Tween` instantiation to direct instantiation with new instances.

- Updated the keyword list to upgrade more terms.