feat: add an event handler for ServerListPingEvent to customise server info displayed to players

Author: wu-vincent

src/endstone_example/example_listener.py

@@ -0,0 +1,9 @@
+from endstone.event import ServerListPingEvent, event_handler, EventPriority
+from endstone.util import ColorFormat
+
+
+class ExampleListener:
+    @event_handler(priority=EventPriority.HIGHEST)
+    def on_server_list_ping(self, event: ServerListPingEvent):
+        event.motd = ColorFormat.BOLD + ColorFormat.AQUA + "Example MOTD"
+        event.level_name = f"Your IP is {ColorFormat.YELLOW}{event.remote_host}:{event.remote_port}{ColorFormat.RESET}"

src/endstone_example/example_plugin.py

@@ -2,6 +2,7 @@
 from endstone.event import EventPriority, ServerLoadEvent, event_handler
 from endstone.plugin import Plugin
 
+from endstone_example.example_listener import ExampleListener
 from endstone_example.python_command import PythonCommandExecutor
 
 
@@ -54,7 +55,10 @@ def on_load(self) -> None:
     def on_enable(self) -> None:
         self.logger.info("on_enable is called!")
         self.get_command("python").executor = PythonCommandExecutor()
-        self.register_events(self)
+
+        self.register_events(self)  # register event listeners defined directly in Plugin class
+        self.listener = ExampleListener()
+        self.register_events(self.listener)  # you can also register event listeners in a separate class
 
     def on_disable(self) -> None:
         self.logger.info("on_disable is called!")