Skip to content

Contributing

Contributions are welcome, from documentation fixes to binding improvements. You don't need to know the whole codebase to get started; discuss the change in an issue and we can help you find the relevant code.

How to Build

How it works

  • Where to start: the engineering reasoning behind Godot-JVM's internals.

Discussions

Discuss changes in the relevant GitHub issue or on Discord. If a decision is made on Discord, record it in the issue so everyone can follow the outcome.

Keep feedback specific and respectful. Contributors have different backgrounds and levels of English fluency; ask for clarification when a comment's intent is unclear.

Code ownership

GitHub Code Owners identifies the maintainers responsible for each part of the codebase. They review changes in their areas. Code without a specific owner falls to the maintainer team.

Before contributing

Coordinate work through issues before starting a substantial change:

  • Search for an existing issue describing the bug or feature.
  • If someone is assigned, ask whether they need help or share your findings.
  • If the issue is unassigned, comment that you'd like to work on it so a maintainer can assign it to you.
  • If no issue exists, open one using the relevant template and describe the problem or proposed change.

The repository's specs/ directory describes what Godot-JVM offers its users and the rules every change follows. If your change adds, changes or removes something users can do, update it in the same pull request.

Code style

Follow Kotlin's official coding conventions and configure your IDE accordingly.

For C++, use the repository's .clang-format and .clang-tidy settings. They define formatting and a focused set of static checks. Configure your editor to use them, or run the tools from the repository root.

Branching

The project follows the git-flow branching model.