Docs for events

pysamp/actor.py

@@ -140,11 +140,31 @@ def is_valid(self) -> bool:
         return is_valid_actor(self.id)
 
     @event("OnActorStreamIn")
-    def on_stream_in(cls, actorid: int, forplayerid: int):
-        return (cls(actorid), Player(forplayerid))
+    def on_stream_in(cls, actor_id: int, for_player_id: int):
+        """This event is called when an actor is streamed in by a player's
+        client.
+
+        :param int actor_id: The ID of the actor.
+        :param int for_player_id: The ID of the player that streamed the
+        actor in.
+        :returns: No return value.
+
+        .. note:: This event can also be called by NPC.
+        """
+        return (cls(actor_id), Player(for_player_id))
 
     @event("OnActorStreamOut")
-    def on_stream_out(cls, actorid: int, forplayerid: int):
-        return (cls(actorid), Player(forplayerid))
+    def on_stream_out(cls, actor_id: int, for_player_id: int):
+        """This event is called when an actor is streamed out by a
+        player's client.
+
+        :param int actor_id: The ID of the actor.
+        :param int for_player_id: The ID of the player that streamed the
+        actor out.
+        :returns: No return value.
+
+        .. note:: This event can also be called by NPC.
+        """
+        return (cls(actor_id), Player(for_player_id))
 
-from pysamp.player import Player  # noqa
+from pysamp.player import Player  # noqa

pysamp/object.py

@@ -239,5 +239,14 @@ def set_default_camera_col(disable: bool) -> bool:
         return set_objects_default_camera_col(disable)
 
     @event("OnObjectMoved")
-    def on_moved(cls, objectid: int):
-        return (cls(objectid),)
+    def on_moved(cls, object_id: int):
+        """This event is called when an object stops moving after
+        :meth:`Object.move()`.
+
+        :param int object_id: The ID of the object that was moved.
+        :returns: No return value.
+
+        .. note:: :meth:`set_position` does not work when used in this
+            event. To fix it, recreate the object.
+        """
+        return (cls(object_id),)