#bevy #mesh #graphics #gamedev #game-engine

grid_plane

Grid plane for the bevy game engine

3 releases

0.1.2 Mar 15, 2023
0.1.1 Mar 14, 2023
0.1.0 Mar 13, 2023

#1353 in Game dev

46 downloads per month

MIT license

360KB
185 lines

Grid plane

This is an image

Grid plane is a Rust plugin for the Bevy game engine that allows you to add a grid plane inside your scene. This plugin provides a simple way to create a grid on 3 axes: xy, yz, and zx.

Features

  • Add grid plane on the scene.
  • Set grid size and spacing.
  • Set grid axes such as xy, yz, and zx.
  • Set grid minor and major line colors.

Usage

To use the bevy_grid plugin, simply add it to your Bevy app's plugin list:

use bevy::prelude::*;
use grid_plane::GridPlanePlugin;

fn main() {
    App::new()
    .add_plugins(DefaultPlugins)
    .add_plugin(GridPlanePlugin::default())
    .run();
}

Usage with custom options

use bevy::prelude::*;
use grid_plane::{GridPlanePlugin, GridAxis};

fn main() {
    App::new()
    .add_plugins(DefaultPlugins)
    .add_plugin(GridPlanePlugin { 
        grid_axis: GridAxis::Zx,
        size: 100,
        spacing: 1.0,
        x_axis_color: Color::RED,
        y_axis_color: Color::GREEN,
        z_axis_color: Color::BLUE,
        minor_line_color: Color::GRAY,
        major_line_color: Color::CYAN,
    })
    .run();
}

Examples

The Grid Plugin comes with three example scenes to get you started:

  • cargo run --example grid_plane_default
  • cargo run --example grid_plane_with_options
  • cargo run --example grid_plane_with_some_options

Compatible Bevy versions

grid_plane bevy
0.1.0 0.10

License

Grid plane is licensed under MIT

Dependencies

~35–76MB
~1M SLoC