document Position default

azalea-client/src/client.rs

@@ -683,6 +683,10 @@ impl Client {
     /// Get the position of this client.
     ///
     /// This is a shortcut for `Vec3::from(&bot.component::<Position>())`.
+    ///
+    /// Note that this value is given a default of [`Vec3::ZERO`] when it
+    /// receives the login packet, its true position may be set ticks
+    /// later.
     pub fn position(&self) -> Vec3 {
         Vec3::from(&self.component::<Position>())
     }

azalea-client/src/plugins/packet/game/mod.rs

@@ -297,7 +297,7 @@ impl GamePacketHandler<'_> {
 
                 let entity_bundle = EntityBundle::new(
                     game_profile.uuid,
-                    Vec3::default(),
+                    Vec3::ZERO,
                     azalea_registry::EntityKind::Player,
                     new_instance_name,
                 );

azalea-entity/src/lib.rs

@@ -140,8 +140,11 @@ impl Debug for EntityUuid {
 
 /// The position of the entity right now.
 ///
-/// You are free to change this; there's systems that update the indexes
-/// automatically.
+/// You are free to change the value of this component; there's systems that
+/// update the indexes automatically.
+///
+/// Its value is set to a default of [`Vec3::ZERO`] when it receives the login
+/// packet, its true position may be set ticks later.
 #[derive(Component, Clone, Copy, Debug, Default, PartialEq, Deref, DerefMut)]
 pub struct Position(Vec3);
 impl Position {