Module valence::prelude

Contains the most frequently used items in Valence projects.

This is usually glob imported like so:

use valence::prelude::*; // Glob import.

let mut app = App::new();
app.add_systems(Update, || println!("yippee!"));
// ...

Re-exports

• pub use valence_server::message::SendMessage as _;
• pub use valence_server::title::SetTitle as _;
• pub use super::DefaultPlugins;
• pub use bevy_ecs;
• pub use valence_server::ident;

Modules

• system_adapterDeprecated
  A collection of common adapters for piping the result of a system.

Macros

• ident
  Creates a new Ident at compile time from a string literal. A compile error is raised if the string is not a valid resource identifier.

Structs

• Added
  A filter on a component that only retains results added after the system last ran.
• Advancement
  Advancement’s id. May not be updated.
• AdvancementBundle
  Components for advancement that are required Optional components: AdvancementDisplay [Parent] - parent advancement
• AdvancementClientUpdate
• AdvancementCriteria
  Criteria’s identifier. May not be updated
• AdvancementDisplay
  Advancement display. Optional component
• AdvancementRequirements
  Requirements for advancement to be completed. All columns should be completed, column is completed when any of criteria in this column is completed.
• AdvancementTabChangeEvent
  This event sends when the client changes or closes advancement’s tab.
• AnyOf
  The AnyOf query parameter fetches entities with any of the component types included in T.
• App
  A container of app logic and data.
• AppTypeRegistry
  A Resource storing TypeRegistry for type registrations relevant to a whole app.
• Biome
• BiomeId
• BiomeRegistry
• Block
  Represents a complete block, which is a pair of block state and optional NBT data for the block entity.
• BlockPos
  Represents an absolute block position in world space.
• BlockRef
  Like Block, but immutably referenced.
• BlockState
  Represents the state of a block. This does not include block entity data such as the text on a sign, the design on a banner, or the content of a spawner.
• Changed
  A filter on a component that only retains results added or mutably dereferenced after the system last ran.
• ChunkLayer
  A Component containing the chunks and dimension information of a Minecraft world.
• ChunkPos
  The X and Z position of a chunk.
• ChunkView
  Represents the set of all chunk positions that a client can see, defined by a center chunk position pos and view distance dist.
• Client
  The main client component. Contains the underlying network connection and packet buffer.
• ClientSpawnQuery
  A convenient WorldQuery for obtaining client spawn components. Also see ClientSpawnQueryReadOnly.
• ClientSpawnQueryReadOnly
  Automatically generated WorldQuery type for a read-only variant of ClientSpawnQuery.
• Commands
  A Command queue to perform impactful changes to the World.
• Compound
  A map type with String keys and Value values.
• CursorItem
  The item stack that the client thinks it’s holding under the mouse cursor.
• DVec2
  A 2-dimensional vector.
• DVec3
  A 3-dimensional vector.
• Deferred
  A SystemParam that stores a buffer which gets applied to the World during apply_deferred. This is used internally by Commands to defer World mutations.
• Despawned
  A marker Component for entities that should be despawned at the end of the tick.
• DiggingEvent
• DimensionType
• DimensionTypeRegistry
• Entity
  Lightweight identifier of an entity.
• EntityKind
  Identifies the type of an entity. As a component, the entity kind should not be modified.
• EntityLayer
  A Component containing Minecraft entities.
• EntityLayerId
  Contains the entity layer an entity is on.
• EntityManager
  A Resource which maintains information about all spawned Minecraft entities.
• EntityMut
  Provides mutable access to a single entity and all of its components.
• EntityRef
  A read-only reference to a particular Entity and all of its components.
• EntityWorldMut
  A mutable reference to a particular Entity, and the entire world. This is essentially a performance-optimized (Entity, &mut World) tuple, which caches the EntityLocation to reduce duplicate lookups.
• ErasedNetworkCallbacks
  A type-erased wrapper around an NetworkCallbacks object.
• EventLoopPostUpdate
• EventLoopPreUpdate
• EventLoopUpdate
• EventReader
  Reads events of type T in order and tracks which events have already been read.
• EventWriter
  Sends events of type T.
• Events
  An event collection that represents the events that occurred within the last two Events::update calls. Events can be written to using an EventWriter and are typically cheaply read using an EventReader.
• First
  Runs first in the schedule. This is run by the Main schedule.
• FixedUpdate
  The schedule that contains systems which only run after a fixed period of time has elapsed.
• Has
  Returns a bool that describes if an entity has the component T.
• HeadYaw
• Hitbox
  Hitbox, aabb of which is calculated each tick using its position and Hitbox. In order to change size of this hitbox you need to change Hitbox.
• HitboxShape
  Size of hitbox. The only way to manipulate it without losing it on the next tick is using a marker entity. Marker entity’s hitbox is never updated.
• Ident
  A wrapper around a string type S which guarantees the wrapped string is a valid resource identifier.
• In
  Wrapper type to mark a SystemParam as an input.
• InteractEntityEvent
• Inventory
• InventoryWindow
  A helper to represent the inventory window that the player is currently viewing. Handles dispatching reads to the correct inventory.
• InventoryWindowMut
  A helper to represent the inventory window that the player is currently viewing. Handles dispatching reads/writes to the correct inventory.
• Ip
• ItemStack
  A stack of items in an inventory.
• JumpWithHorseEvent
• Last
  Runs last in the schedule. This is run by the Main schedule.
• LayerBundle
  Convenience Bundle for spawning a layer entity with both ChunkLayer and EntityLayer components.
• LeaveBedEvent
• LoadedChunk
• Local
  A system local SystemParam.
• Look
  Describes the direction an entity is looking using pitch and yaw angles.
• Main
  The schedule that contains the app logic that is evaluated each tick of App::update().
• Mut
  Unique mutable borrow of an entity’s component
• NetworkSettings
  Settings for NetworkPlugin. Note that mutations to these fields have no effect after the plugin is built.
• NewClientInfo
  Contains information about a new client joining the server.
• NextState
  The next state of State<S>.
• NonSend
  Shared borrow of a non-Send resource.
• NonSendMut
  Unique borrow of a non-Send resource.
• OldEntityLayerId
  The value of EntityLayerId from the end of the previous tick.
• OldPosition
  The value of Position from the end of the previous tick.
• OldView
• OldViewDistance
  The ViewDistance at the end of the previous tick. Automatically updated as ViewDistance is changed.
• OnEnter
  The label of a Schedule that runs whenever State<S> enters this state.
• OnExit
  The label of a Schedule that runs whenever State<S> exits this state.
• OnTransition
  The label of a Schedule that only runs whenever State<S> exits the from state, AND enters the to state.
• OpenInventory
  Used to indicate that the client with this component is currently viewing an inventory.
• Or
  A filter that tests if any of the given filters apply.
• ParallelCommands
  An alternative to Commands that can be used in parallel contexts, such as those in Query::par_iter
• ParamSet
  A collection of potentially conflicting SystemParams allowed by disjoint access.
• PlayerList
• PlayerListEntry
  Marker component for player list entries.
• Position
• PostStartup
  The schedule that runs once after Startup. This is run by the Main schedule.
• PostUpdate
  The schedule that contains logic that must run after Update. For example, synchronizing “local transforms” in a hierarchy to “global” absolute transforms. This enables the PostUpdate transform-sync system to react to “local transform” changes in Update without the Update systems needing to know about (or add scheduler dependencies for) the “global transform sync system”.
• PreStartup
  The schedule that runs before Startup. This is run by the Main schedule.
• PreUpdate
  The schedule that contains logic that must run before Update. For example, a system that reads raw keyboard input OS events into an Events resource. This enables systems in Update to consume the events from the Events resource without actually knowing about (or taking a direct scheduler dependency on) the “os-level keyboard event system”.
• Properties
  Player properties from the game profile.
• Query
  System parameter that provides selective access to the Component data stored in a World.
• QueryState
  Provides scoped access to a World state according to a given WorldQuery and query filter.
• Ref
  Shared borrow of an entity’s component with access to change detection. Similar to Mut but is immutable and so doesn’t require unique access.
• ReflectComponent
  A struct used to operate on reflected Component of a type.
• ReflectResource
  A struct used to operate on reflected Resource of a type.
• RemovedComponents
  A SystemParam that grants access to the entities that had their T Component removed.
• Res
  Shared borrow of a Resource.
• ResMut
  Unique mutable borrow of a Resource.
• RespawnPosition
  The position and angle that clients will respawn with. Also controls the position that compasses point towards.
• Schedule
  A collection of systems, and the metadata and executor needed to run them in a certain order under certain conditions.
• Schedules
  Resource that stores Schedules mapped to ScheduleLabels.
• Server
  Contains global server state accessible as a Resource.
• SharedNetworkState
• SneakEvent
• SpawnScene
  The schedule that contains scene spawning. This is run by the Main schedule.
• SprintEvent
• Startup
  The schedule that runs once when the app starts. This is run by the Main schedule.
• State
  A finite-state machine whose transitions have associated schedules ([OnEnter(state)] and [OnExit(state)]).
• StateTransition
  Runs state transitions. This is run by the Main schedule.
• Text
  Represents formatted text in Minecraft’s JSON text format.
• UniqueId
  The universally unique identifier of an entity. Component wrapper for a Uuid.
• UnloadedChunk
• Update
  The schedule that contains app logic. This is run by the Main schedule.
• Username
• Uuid
  A Universally Unique Identifier (UUID).
• Vec2
  A 2-dimensional vector.
• Vec3
  A 3-dimensional vector.
• View
• ViewDistance
• VisibleChunkLayer
  A Component containing a handle to the ChunkLayer a client can see.
• VisibleEntityLayers
  A Component containing the set of EntityLayers a client can see. All Minecraft entities from all layers in this set are potentially visible to the client.
• With
  Filter that selects entities with a component T.
• Without
  Filter that selects entities without a component T.
• World
  Stores and exposes operations on entities, components, resources, and their associated metadata.

Enums

• AdvancementFrameType
• BlockKind
  An enumeration of all block kinds.
• ClientCommand
• Color
  Text color
• ConnectionMode
  Describes how new connections to the server are handled.
• DiggingState
• Direction
• EntityAnimation
• EntityInteraction
• EntityStatus
• GameMode
• Hand
• InventoryKind
• ItemKind
  Represents an item from the game
• JumpWithHorseState
• Particle
• PropName
  Contains all possible block state property names.
• PropValue
  Contains all possible values that a block property might have.
• SneakState
• SprintState

Traits

• Bundle
  The Bundle trait enables insertion and removal of Components from an entity.
• Chunk
  Common operations on chunks. Notable implementors are LoadedChunk and UnloadedChunk.
• Component
  A data type that can be used to store data for an entity.
• Condition
  A system that determines if one or more scheduled systems should run.
• DetectChanges
  Types that can read change detection information. This change detection is controlled by DetectChangesMut types such as ResMut.
• DetectChangesMut
  Types that implement reliable change detection.
• Event
  A type that can be stored in an Events<E> resource You can conveniently access events using the EventReader and EventWriter system parameter.
• FromWorld
  Creates an instance of the type this trait is implemented for using data from the supplied World.
• IntoSystem
  Conversion trait to turn something into a System.
• IntoSystemConfigs
  Types that can convert into a SystemConfigs.
• IntoSystemSet
  Types that can be converted into a SystemSet.
• IntoSystemSetConfigs
  Types that can convert into a SystemSetConfigs.
• IntoText
  Trait for any data that can be converted to a Text object.
• NetworkCallbacks
  This trait uses async_trait.
• Plugin
  A collection of Bevy app logic and configuration.
• PluginGroup
  Combines multiple Plugins into a single unit.
• ReadOnlySystem
  System types that do not modify the World when run. This is implemented for any systems whose parameters all implement ReadOnlySystemParam.
• Resource
  A type that can be inserted into a World as a singleton.
• States
  Types that can define world-wide states in a finite-state machine.
• System
  An ECS system that can be added to a Schedule
• SystemParamFunction
  A trait implemented for all functions that can be used as Systems.
• SystemSet
  Types that identify logical groups of systems.

Functions

• any_component_removed
  Generates a Condition-satisfying closure that returns true if there are any entity with a component of the given type removed.
• any_with_component
  Generates a Condition-satisfying closure that returns true if there are any entities with the given component type.
• apply_deferred
  Instructs the executor to call System::apply_deferred on the systems that have run but not applied their Deferred system parameters (like Commands) or other system buffers.
• apply_state_transition
  If a new state is queued in NextState<S>, this system:
• dbgDeprecated
  System adapter that utilizes the [bevy_utils::tracing::debug!] macro to print the output of a system.
• despawn_disconnected_clients
  A system for adding Despawned components to disconnected clients. This works by listening for removed Client components.
• errorDeprecated
  System adapter that utilizes the [bevy_utils::tracing::error!] macro to print the output of a system.
• ignoreDeprecated
  System adapter that ignores the output of the previous system in a pipe. This is useful for fallible systems that should simply return early in case of an Err/None.
• in_state
  Generates a Condition-satisfying closure that returns true if the state machine is currently in state.
• infoDeprecated
  System adapter that utilizes the [bevy_utils::tracing::info!] macro to print system information.
• not
  Generates a Condition that inverses the result of passed one.
• on_event
  Generates a Condition-satisfying closure that returns true if there are any new events of the given type since it was last called.
• resource_added
  Generates a Condition-satisfying closure that returns true if the resource of the given type has been added since the condition was last checked.
• resource_changed
  Generates a Condition-satisfying closure that returns true if the resource of the given type has had its value changed since the condition was last checked.
• resource_changed_or_removed
  Generates a Condition-satisfying closure that returns true if the resource of the given type has had its value changed since the condition was last checked.
• resource_equals
  Generates a Condition-satisfying closure that returns true if the resource is equal to value.
• resource_exists
  Generates a Condition-satisfying closure that returns true if the resource exists.
• resource_exists_and_changed
  Generates a Condition-satisfying closure that returns true if the resource of the given type has had its value changed since the condition was last checked.
• resource_exists_and_equals
  Generates a Condition-satisfying closure that returns true if the resource exists and is equal to value.
• resource_removed
  Generates a Condition-satisfying closure that returns true if the resource of the given type has been removed since the condition was last checked.
• run_once
  Generates a Condition-satisfying closure that returns true if the first time the condition is run and false every time after
• state_changed
  Generates a Condition-satisfying closure that returns true if the state machine changed state.
• state_exists
  Generates a Condition-satisfying closure that returns true if the state machine exists.
• state_exists_and_equals
  Generates a Condition-satisfying closure that returns true if the state machine exists and is currently in state.
• unwrapDeprecated
  System adapter that unwraps the Ok variant of a Result. This is useful for fallible systems that should panic in the case of an error.
• warnDeprecated
  System adapter that utilizes the [bevy_utils::tracing::warn!] macro to print the output of a system.

Derive Macros

• Bundle
• Component
• DynamicPlugin
  Generates a dynamic plugin entry point function for the given Plugin type.
• Event
• Resource
• States
• SystemSet
  Derive macro generating an impl of the trait SystemSet.