Crate bevy::dynamic_plugin

Bevy’s dynamic plugin loading functionality.

This crate allows loading dynamic libraries (.dylib, .so) that export a single Plugin. For usage, see dynamically_load_plugin.

Note that dynamic linking and loading is inherently unsafe because it allows executing foreign code. Additionally, Rust does not have a stable ABI and may produce incompatible libraries across Rust versions, or even subsequent compilations. This will not work well in scenarios such as modding, but can work if the dynamic plugins and the main app are built at the same time, such as with Downloadable Content (DLC) packs.

You may be interested in these safer alternatives:

• Bevy Assets - Scripting: Scripting and modding libraries for Bevy
• Bevy Assets - Development tools: Hot reloading and other development functionality
• stabby: Stable Rust ABI

Enums

• DynamicPluginLoadError
  Errors that can occur when loading a dynamic plugin

Traits

• DynamicPluginExt
  An extension trait for App that allows loading dynamic plugins.

Functions

• dynamically_load_plugin^⚠
  Dynamically links a plugin at the given path. The plugin must export a function with the CreatePlugin signature named _bevy_create_plugin.