OpenRP Docs
Behavior Engine

Behavior Registry

Learn how to use the Behavior Registry to make your behaviors them usable to others.

The Behavior Registry is a central hub where creators can publish their behaviors for others to discover, use, and learn from. When you publish a behavior, you are contributing to the OpenRP community ecosystem, allowing anyone to incorporate your custom logic into their own characters and worlds.

What does publishing do?

When you publish a behavior:

  • It becomes publicly visible in the Behavior Registry.
  • Other creators can search for it and use it in their own worlds.
  • It receives a dedicated page detailing its functionality, version history, and release notes.

How to publish a behavior

In your world's behavior editor, in the top right corner, click on more, select publish.

Versioning

OpenRP uses Semantic Versioning for published behaviors (e.g., 1.0.0, 2.1.2-beta).

When publishing, you specify a version number that is greater than the previous version. This helps other creators know whether an update is a minor tweak or a major breaking change:

  • Major (e.g. 1.0.1 to 2.0.0): Breaking changes in the graph's expected inputs/outputs or core behavior.
  • Minor (e.g. 1.0.1 to 1.1.0): New capabilities added in a backwards-compatible manner.
  • Patch (e.g. 1.0.1 to 1.0.2): Minor changes or bug fixes.

Graph immutability

Once a specific version of a behavior is published, it becomes immutable. This means we take a permanent snapshot of the behavior and it will stay the same. To make modifications to it, you must publish a new version.

This guarantees that users of the behavior can rely on the behavior not changing even after you release new versions of it.

Visibility

All published behaviors are public, even publishing from a private world. In addition, there is no way to unpublish a behavior once published. Please contact support if your behavior contains sensitive information that must be unpublished.

On this page