Overview
Godot Cardano is a free add-on for the Godot game engine that lets developers build a crypto wallet into their games. Players can load a wallet, see their balance, and send ADA from ordinary game screens. Developers also get a software development kit (SDK), a set of ready-made code tools, for building and submitting transactions from their game scripts1.
The add-on works with Cardano and comes from MLabs, a software engineering consultancy that works on Cardano projects. The Cardano community paid for the work through a Project Catalyst Fund 10 grant, and the proposal is marked complete2. Godot Cardano is in beta: its demos run on Cardano's preview testnet, a practice network that uses test ADA with no real value1. The code is open-source under the MIT license3.
Key Features
- A wallet that lives inside the game. Godot Cardano's wallet runs in the player's copy of the game, not in the Godot editor. The demo game loads a wallet from a seed phrase (the list of words that restores a wallet) and sends ADA from in-game forms1.
- Keys kept encrypted. The wallet stores the player's master private key in encrypted form and can sign transactions and other data offline4. Signing a transaction requires the wallet's password5.
- Game code that talks to the blockchain. Developers use GDScript, Godot's built-in scripting language, to check a wallet's assets and ADA balance and to build transactions5. The demo submits those transactions through Blockfrost, an online service that relays data to and from the network1.
- Wallet access for web games. A separate add-on registers the game's wallet under CIP-30, the standard Cardano websites use to talk to browser wallets, so web pages can connect to the wallet inside a game built for the browser6. It supports only part of the standard: pages can read the wallet's address and request data signing, not transaction signing6.
- Middleware for Paima Engine. Another add-on provides middleware, the connecting code between two systems, so developers can write part of their game logic in Godot while using Paima Engine1. Paima Engine has since been rebranded as Effectstream, a multi-chain engine for building onchain games and apps, and its code was rewritten from scratch7,8.
What to Expect
For players, wallet steps in a game built with Godot Cardano look like ordinary game menus. In the demo, you type a seed phrase and click "Set wallet," and the game shows the funds held at that address. A second form takes a recipient and an amount in lovelace, the smallest unit of ADA, and "Send ADA" submits the transfer1. The demo does not say whether the transfer succeeded, so the docs suggest checking on a block explorer, a website that shows blockchain transactions, such as Cardanoscan1.
For developers, the demo needs Godot 4.2, a preview-testnet wallet funded with test ADA, and a Blockfrost preview token, the access key the demo uses to reach Blockfrost. You download the add-on from the GitHub releases page, copy it into the demo folder, and run the project from the Godot editor1. The docs also show the exported demo running as a standalone program, with the wallet inside it1.
Work on the add-on's own code is supported on Linux, or through a virtual machine or WSL (Windows Subsystem for Linux) elsewhere, and uses the Nix package manager plus a Rust extension1. A reference section documents each GDScript class, with pages for wallets and transaction building1.
Among specialized wallets, Godot Cardano is a builder's toolkit for gaming studios and hobbyists, not a game to play.
