X-Plane plugin APIs for Rust
Purpose
Rust XPLM provides a convenient interface for X-Plane plugin development in the Rust programming language for all platforms.
As we use the X-Plane SDK version 3.0, any plugin created with this library supports X-Plane version 11.10 or later.
Status
The library is still in an incomplete state. As a result some parts of the SDK may only be sparsely covered or missing completely.
- Compiles and is callable from X-Plane
- Debug logging to the console / log file
- DataRef reading and writing
- Commands
- GUI - Needs further work
- Drawing - Needs further work
Example
Some more examples can be found in the examples/
directory.
This small snippet is the minimal boilerplate needed to make your plugin compile.
extern crate xplm;
use ;
use ;
;
xplane_plugin!;
Compiling and installing a plugin
Then add to Cargo.toml
:
[]
= ["cdylib"]
Copy minimal example from above into src/lib.rs
cargo build
Rename target/debug/my_rxplm_project.dll
to win.xpl
(or my_rxplm_project.so
to lin.xpl
, etc) and copy to the aircraft/scenery/sim plugins folder
Cross-compiling
The cross tool may help compile plugins for multiple operating systems/architectures.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.