rename add_plugin_group to add_plugins (#773)

crates/bevy_app/src/app_builder.rs

@@ -272,14 +272,14 @@ impl AppBuilder {
         self
     }
 
-    pub fn add_plugin_group<T: PluginGroup>(&mut self, mut group: T) -> &mut Self {
+    pub fn add_plugins<T: PluginGroup>(&mut self, mut group: T) -> &mut Self {
         let mut plugin_group_builder = PluginGroupBuilder::default();
         group.build(&mut plugin_group_builder);
         plugin_group_builder.finish(self);
         self
     }
 
-    pub fn add_plugin_group_with<T, F>(&mut self, mut group: T, func: F) -> &mut Self
+    pub fn add_plugins_with<T, F>(&mut self, mut group: T, func: F) -> &mut Self
     where
         T: PluginGroup,
         F: FnOnce(&mut PluginGroupBuilder) -> &mut PluginGroupBuilder,

examples/2d/sprite.rs

@@ -2,7 +2,7 @@ use bevy::prelude::*;
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/2d/sprite_sheet.rs

@@ -2,7 +2,7 @@ use bevy::prelude::*;
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(animate_sprite_system.system())
         .run();

examples/2d/texture_atlas.rs

@@ -4,7 +4,7 @@ use bevy::{asset::LoadState, prelude::*, sprite::TextureAtlasBuilder};
 fn main() {
     App::build()
         .init_resource::<RpgSpriteHandles>()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(load_atlas.system())
         .run();

examples/3d/3d_scene.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/3d/load_gltf.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/3d/msaa.rs

@@ -6,7 +6,7 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/3d/parenting.rs

@@ -5,7 +5,7 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(rotator_system.system())
         .run();

examples/3d/spawner.rs

@@ -10,7 +10,7 @@ use rand::{rngs::StdRng, Rng, SeedableRng};
 /// NOTE: Bevy still has a number of optimizations to do in this area. Expect the performance here to go way up in the future
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_plugin(FrameTimeDiagnosticsPlugin::default())
         .add_plugin(PrintDiagnosticsPlugin::default())
         .add_startup_system(setup.system())

examples/3d/texture.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 /// This example shows various ways to configure texture materials in 3D
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/3d/z_sort_debug.rs

@@ -9,7 +9,7 @@ use bevy::{
 /// This example visualizes camera z-ordering by setting the material of rotating cubes to their distance from the camera
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(rotator_system.system())
         .add_system(camera_order_color_system.system())

examples/app/empty_defaults.rs

@@ -1,5 +1,5 @@
 use bevy::prelude::*;
 
 fn main() {
-    App::build().add_plugin_group(DefaultPlugins).run();
+    App::build().add_plugins(DefaultPlugins).run();
 }

examples/app/headless.rs

@@ -13,7 +13,7 @@ fn main() {
     // this app runs once
     App::build()
         .add_resource(ScheduleRunnerSettings::run_once())
-        .add_plugin_group(MinimalPlugins)
+        .add_plugins(MinimalPlugins)
         .add_system(hello_world_system.system())
         .run();
 
@@ -22,7 +22,7 @@ fn main() {
         .add_resource(ScheduleRunnerSettings::run_loop(Duration::from_secs_f64(
             1.0 / 60.0,
         )))
-        .add_plugin_group(MinimalPlugins)
+        .add_plugins(MinimalPlugins)
         .add_system(counter.system())
         .run();
 }

examples/app/plugin.rs

@@ -6,7 +6,7 @@ use std::time::Duration;
 /// This example illustrates how to create a simple plugin that prints out a message.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // plugins are registered as part of the "app building" process
         .add_plugin(PrintMessagePlugin {
             wait_duration: Duration::from_secs(1),

examples/app/plugin_group.rs

@@ -4,11 +4,11 @@ use bevy::{app::PluginGroupBuilder, prelude::*};
 fn main() {
     App::build()
         // Two PluginGroups that are included with bevy are DefaultPlugins and MinimalPlugins
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // Adding a plugin group adds all plugins in the group by default
-        .add_plugin_group(HelloWorldPlugins)
+        .add_plugins(HelloWorldPlugins)
         // You can also modify a PluginGroup (such as disabling plugins) like this:
-        // .add_plugin_group_with(HelloWorldPlugins, |group| {
+        // .add_plugins_with(HelloWorldPlugins, |group| {
         //     group
         //         .disable::<PrintWorldPlugin>()
         //         .add_before::<PrintHelloPlugin, _>(bevy::diagnostic::PrintDiagnosticsPlugin::default())

examples/app/return_after_run.rs

@@ -7,7 +7,7 @@ fn main() {
             return_from_run: true,
         })
         .add_resource(ClearColor(Color::rgb(0.2, 0.2, 0.8)))
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .run();
     println!("Running another App.");
     App::build()
@@ -15,7 +15,7 @@ fn main() {
             return_from_run: true,
         })
         .add_resource(ClearColor(Color::rgb(0.2, 0.8, 0.2)))
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .run();
     println!("Done.");
 }

examples/app/thread_pool_resources.rs

@@ -5,6 +5,6 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(DefaultTaskPoolOptions::with_num_threads(4))
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .run();
 }

examples/asset/asset_loading.rs

@@ -4,7 +4,7 @@ use bevy::prelude::*;
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/asset/custom_asset.rs

@@ -35,7 +35,7 @@ impl AssetLoader for CustomAssetLoader {
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .init_resource::<State>()
         .add_asset::<CustomAsset>()
         .init_asset_loader::<CustomAssetLoader>()

examples/asset/hot_asset_reloading.rs

@@ -5,7 +5,7 @@ use bevy::prelude::*;
 /// This example illustrates hot reloading mesh changes.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/audio/audio.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 /// This example illustrates how to load and play an audio file
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/diagnostics/custom_diagnostic.rs

@@ -6,7 +6,7 @@ use bevy::{
 /// This example illustrates how to create a custom diagnostic
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // The "print diagnostics" plugin is optional. It just visualizes our diagnostics in the console
         .add_plugin(PrintDiagnosticsPlugin::default())
         .add_startup_system(setup_diagnostic_system.system())

examples/diagnostics/print_diagnostics.rs

@@ -5,7 +5,7 @@ use bevy::{
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // Adds frame time diagnostics
         .add_plugin(FrameTimeDiagnosticsPlugin::default())
         // Adds a system that prints diagnostics to the console

examples/ecs/event.rs

@@ -4,7 +4,7 @@ use bevy::prelude::*;
 /// and a system that prints a message whenever the event is received.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_event::<MyEvent>()
         .init_resource::<EventTriggerState>()
         .add_system(event_trigger_system.system())

examples/ecs/hierarchy.rs

@@ -2,7 +2,7 @@ use bevy::prelude::*;
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(rotate.system())
         .run();

examples/ecs/parallel_query.rs

@@ -73,7 +73,7 @@ fn bounce_system(
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(spawn_system.system())
         .add_system(move_system.system())
         .add_system(bounce_system.system())

examples/game/breakout.rs

@@ -7,7 +7,7 @@ use bevy::{
 /// An implementation of the classic game "Breakout"
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_resource(Scoreboard { score: 0 })
         .add_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))
         .add_startup_system(setup.system())

examples/input/gamepad_input.rs

@@ -4,7 +4,7 @@ use bevy_utils::HashSet;
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .init_resource::<GamepadLobby>()
         .add_system_to_stage(stage::PRE_UPDATE, connection_system.system())
         .add_system(gamepad_system.system())

examples/input/gamepad_input_events.rs

@@ -3,7 +3,7 @@ use bevy_input::gamepad::{GamepadEvent, GamepadEventType};
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(gamepad_events.system())
         .run();
 }

examples/input/keyboard_input.rs

@@ -5,7 +5,7 @@ use bevy::{
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(keyboard_input_system.system())
         .run();
 }

examples/input/keyboard_input_events.rs

@@ -2,7 +2,7 @@ use bevy::{input::keyboard::KeyboardInput, prelude::*};
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(print_keyboard_event_system.system())
         .run();
 }

examples/input/mouse_input.rs

@@ -2,7 +2,7 @@ use bevy::prelude::*;
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(mouse_click_system.system())
         .run();
 }

examples/input/mouse_input_events.rs

@@ -6,7 +6,7 @@ use bevy::{
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(print_mouse_events_system.system())
         .run();
 }

examples/input/touch_input.rs

@@ -2,7 +2,7 @@ use bevy::{input::touch::*, prelude::*};
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(touch_system.system())
         .run();
 }

examples/input/touch_input_events.rs

@@ -2,7 +2,7 @@ use bevy::{input::touch::*, prelude::*};
 
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(touch_event_system.system())
         .run();
 }

examples/ios/src/lib.rs

@@ -17,7 +17,7 @@ extern "C" fn main_rs() {
             ..Default::default()
         })
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/scene/properties.rs

@@ -11,7 +11,7 @@ use serde::{Deserialize, Serialize};
 /// familiar with "reflection" in other languages, Properties are very similar to that concept.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // If you need to deserialize custom property types, register them like this:
         .register_property::<Test>()
         .register_property::<Nested>()

examples/scene/scene.rs

@@ -3,7 +3,7 @@ use bevy::{prelude::*, type_registry::TypeRegistry};
 /// This example illustrates loading and saving scenes from files
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // Registering components informs Bevy that they exist. This allows them to be used when loading scenes
         // This step is only required if you want to load your components from scene files.
         // Unregistered components can still be used in your code, but they will be ignored during scene save/load.

examples/shader/mesh_custom_attribute.rs

@@ -13,7 +13,7 @@ use bevy::{
 /// This example illustrates how to add a custom attribute to a mesh and use it in a custom shader.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_asset::<MyMaterialWithVertexColorSupport>()
         .add_startup_system(setup.system())
         .run();

examples/shader/shader_custom_material.rs

@@ -13,7 +13,7 @@ use bevy::{
 /// This example illustrates how to create a custom material asset and a shader that uses that material
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_asset::<MyMaterial>()
         .add_startup_system(setup.system())
         .run();

examples/shader/shader_defs.rs

@@ -14,7 +14,7 @@ use bevy::{
 /// In Bevy, "shader defs" are a way to selectively enable parts of a shader based on values set in a component or asset.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_asset::<MyMaterial>()
         .add_startup_system(setup.system())
         .add_system_to_stage(

examples/ui/button.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 /// This example illustrates how to create a button that changes color and text based on its interaction state.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .init_resource::<ButtonMaterials>()
         .add_startup_system(setup.system())
         .add_system(button_system.system())

examples/ui/font_atlas_debug.rs

@@ -4,7 +4,7 @@ use bevy::{prelude::*, text::FontAtlasSet};
 fn main() {
     App::build()
         .init_resource::<State>()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .add_system(text_update_system.system())
         .add_system(atlas_render_system.system())

examples/ui/text.rs

@@ -6,7 +6,7 @@ use bevy::{
 /// This example illustrates how to create text and update it in a system. It displays the current FPS in the upper left hand corner.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_plugin(FrameTimeDiagnosticsPlugin::default())
         .add_startup_system(setup.system())
         .add_system(text_update_system.system())

examples/ui/ui.rs

@@ -3,7 +3,7 @@ use bevy::prelude::*;
 /// This example illustrates the various features of Bevy UI.
 fn main() {
     App::build()
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/wasm/assets_wasm.rs

@@ -19,7 +19,7 @@ fn main() {
         .add_resource(AssetServerSettings {
             asset_folder: "/".to_string(),
         })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_asset::<RustSourceCode>()
         .init_asset_loader::<RustSourceCodeLoader>()
         .add_startup_system(load_asset.system())

examples/wasm/winit_wasm.rs

@@ -22,7 +22,7 @@ fn main() {
             height: 300,
             ..Default::default()
         })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         // One time greet
         .add_startup_system(hello_wasm_system.system())
         // Track ticks (sanity check, whether game loop is running)

examples/window/clear_color.rs

@@ -3,6 +3,6 @@ use bevy::{prelude::*, render::pass::ClearColor};
 fn main() {
     App::build()
         .add_resource(ClearColor(Color::rgb(0.5, 0.5, 0.9)))
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .run();
 }

examples/window/multiple_windows.rs

@@ -16,7 +16,7 @@ use bevy::{
 fn main() {
     App::build()
         .add_resource(Msaa { samples: 4 })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_startup_system(setup.system())
         .run();
 }

examples/window/window_settings.rs

@@ -11,7 +11,7 @@ fn main() {
             resizable: false,
             ..Default::default()
         })
-        .add_plugin_group(DefaultPlugins)
+        .add_plugins(DefaultPlugins)
         .add_system(change_title.system())
         .add_system(toggle_cursor.system())
         .run();