From 6530eb675dbd08c3fed41f6d3906f98fe0400a3d Mon Sep 17 00:00:00 2001
From: elmurato <1382097+elmurato@users.noreply.github.com>
Date: Mon, 7 Aug 2023 08:05:52 +0200
Subject: [PATCH] Minecraft Server: Add notes about player names list and
 compatible server versions (#28451)

* Add notes about player names list and compatible server versions

* Apply suggestions from code review

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/minecraft_server.markdown | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/source/_integrations/minecraft_server.markdown b/source/_integrations/minecraft_server.markdown
index d2954c9d843..fedf5c1f1a6 100644
--- a/source/_integrations/minecraft_server.markdown
+++ b/source/_integrations/minecraft_server.markdown
@@ -17,10 +17,14 @@ ha_platforms:
 ha_integration_type: integration
 ---
 
-Minecraft servers allow players to play the sandbox video game [Minecraft](https://www.minecraft.net/en-us) by Mojang AB online or via a local area network with other players. The `Minecraft Server` integration lets you retrieve information from a Minecraft server (Java edition) within Home Assistant.
+Minecraft servers allow players to play the sandbox video game [Minecraft](https://www.minecraft.net/en-us) by Mojang Studios online or via a local area network with other players. The `Minecraft Server` integration lets you retrieve information from a Minecraft server within Home Assistant.
 
 <div class='note'>
-The server must be version 1.7 or higher, since older versions don't expose any information.
+Minecraft Java edition servers must be version 1.7 or newer, since older versions don't expose any information.
+</div>
+
+<div class='note'>
+Minecraft Bedrock edition servers are not supported yet.
 </div>
 
 {% include integrations/config_flow.md %}
@@ -35,9 +39,14 @@ This integration provides a binary sensor for the following information from a M
 
 This integration provides sensors for the following information from a Minecraft server:
 
-- Latency time
+- Latency
 - Version
 - Protocol version
-- Number of online players (player names are available in state attributes)
+- Number of online players
+  - Including player names list in the state attributes, if available (see note below).
 - Number of maximum players
 - World Message / Message of the Day (MOTD)
+
+<div class='note'>
+Depending on the server, the player names list may not be shown completely. Some servers and plugins limit or completely hide this list or even replace the player names with fake ones to show some custom messages there.
+</div>