The godot-rust book

This book is a user guide for godot-rust, the Rust bindings to Godot 4.[^gdnative-book]
It covers a large part of the concepts and complements the API docs.

[!Tip] The book is deployed at godot-rust.github.io/book.

Local setup

The book is built with mdBook and the plugins mdbook-toc and mdbook-admonish.[^mdbook]
To install them and build the book locally, you can run:

cargo install mdbook@^0.4 mdbook-toc@^0.14 mdbook-admonish@1.18.0
mdbook build

To run a local server with automatic updates while editing the book, use:

mdbook serve --open

Formatting and linting

markdownlint enforces a consistent style across the Markdown files. It is automatically run during CI, but if you have the npm toolchain, you can also run it locally:

npm install --global markdownlint-cli2
./lint.sh

# To fix certain errors directly:
./lint.sh fix

Oxipng

We use oxipng to optimize image file size. You can install it with cargo install oxipng and then run it as follows:

oxipng --strip safe --alpha -r src

Contributing

This repository is for documentation only. For changes in the library itself, please open pull requests and issues in the main repo, and read the contributing guidelines.

License

Like godot-rust itself, the godot-rust book is licensed under MPL 2.0.

<br>

[^gdnative-book]: For Godot 3, there is the older gdnative-book. [^mdbook]: mdBook 0.5 contains breaking changes, and we can't support it until plugins catch up. Right now it offers no features that would benefit us.