Guides / Server & Performance

server-icon.png: ข้อกำหนดที่แน่นอน และ API จัดการที่ไม่มีใครใช้

64x64, PNG, อยู่ที่รูทของเซิร์ฟเวอร์ – ถ้าทำผิดแม้แต่ข้อเดียว ไอคอนจะไม่แสดง และ API จัดการแบบ JSON-RPC ที่มาแทนการอ่านข้อมูลจากคอนโซล

2026-06-14

ไอคอนเซิร์ฟเวอร์เป็นฟีเจอร์เล็กๆ ที่ไม่ให้อภัยที่สุดใน Minecraft เพราะความล้มเหลวทุกรูปแบบดูเหมือนกันหมด: ไม่มีไอคอน ไม่มีข้อผิดพลาด

สามข้อกำหนด บังคับทั้งหมด

1. ขนาด 64×64 พิกเซลเป๊ะๆ ไม่ใช่ 63 ไม่ใช่ 128 เซิร์ฟเวอร์ไม่ปรับขนาด
2. รูปแบบ PNG ต้องเป็น PNG จริงๆ ไม่ใช่ JPG ที่เปลี่ยนชื่อ
3. ชื่อ server-icon.png อยู่ที่รูทของเซิร์ฟเวอร์ – อยู่ข้าง server.properties ไม่ใช่

อยู่ในโฟลเดอร์โลก

ถ้าทำผิดแม้แต่ข้อเดียว เซิร์ฟเวอร์จะเริ่มทำงานตามปกติและแสดงไอคอนเริ่มต้น ไม่มีอะไรถูกบันทึกในระดับเริ่มต้น

สิ่งที่ทำให้มันเสียได้อีก

• PNG แบบ Interlaced โปรแกรมแก้ไขบางตัวบันทึกแบบ interlaced เป็นค่าเริ่มต้น; ตัวอ่านของ Minecraft ปฏิเสธ

มัน ให้ส่งออกใหม่แบบ non-interlaced

• ความลึกสี 16 บิต บันทึกเป็น 8 บิตต่อช่อง
• โปรไฟล์สี โปรไฟล์ ICC ที่ฝังอยู่บางครั้งทำให้ตัวแยกวิเคราะห์มีปัญหา ลบ

เมตาดาต้าออกเมื่อส่งออก

• ความโปร่งใสใช้ได้ และแสดงผลได้อย่างถูกต้องในรายการเซิร์ฟเวอร์

ไคลเอนต์จะแคชมันไว้

เมื่อไคลเอนต์เห็นเซิร์ฟเวอร์ของคุณแล้ว มันจะเก็บไอคอนไว้ การเปลี่ยนไอคอนทางฝั่งเซิร์ฟเวอร์จะไม่ อัปเดตรายการที่มีอยู่ – ผู้เล่นต้องลบและเพิ่มเซิร์ฟเวอร์ใหม่ หรือรอให้ แคชหมดอายุ การทดสอบการเปลี่ยนไอคอนจากไคลเอนต์ของคุณเองจะทำให้คุณเชื่อว่ามันไม่ ทำงาน ทั้งที่จริงแล้วมันทำงาน

API จัดการ

เซิร์ฟเวอร์เวอร์ชันล่าสุดเปิดเผยอินเทอร์เฟซการจัดการแบบ JSON-RPC ซึ่งเป็น การแทนที่ที่ได้รับอนุญาตสำหรับการแยกวิเคราะห์เอาต์พุตคอนโซลหรือการติดตั้งปลั๊กอิน

เปิดใช้งานใน server.properties:

management-server-enabled=true
management-server-host=localhost
management-server-port=25585

จากนั้นสื่อสาร JSON-RPC ผ่านพอร์ตนั้น:

{ "jsonrpc": "2.0", "id": 1, "method": "minecraft:players" }

เมธอดครอบคลุมรายการผู้เล่น สถานะเซิร์ฟเวอร์ รายการอนุญาตและรายการแบน กฎเกม การตั้งค่า และคู่คำสั่งบันทึก/หยุด แต่ละเมธอดจะคืนค่า JSON ที่มีโครงสร้างแทนที่จะเป็นข้อความที่คุณต้องใช้ regex

ผูกกับ localhost

ค่าเริ่มต้นคือ localhost และควรคงไว้ที่นั่น อินเทอร์เฟซนี้ ไม่ ได้มีไว้เพื่อ เผชิญหน้ากับอินเทอร์เน็ต – สิ่งใดก็ตามที่เข้าถึงได้สามารถหยุดเซิร์ฟเวอร์ของคุณได้ เปิดเผยผ่านอุโมงค์ SSH หรือพร็อกซีผกผันพร้อมการตรวจสอบสิทธิ์ หากคุณต้องการเข้าถึงระยะไกล ห้าม เปลี่ยนโฮสต์เป็น 0.0.0.0 เด็ดขาด

ทำไมมันถึงสำคัญ

แดชบอร์ด บอท Discord และเครื่องมือตรวจสอบความพร้อมใช้งานในอดีตทำงานโดยการอ่าน บันทึกคอนโซลหรือใช้ RCON ซึ่งทั้งสองอย่างเปราะบาง API ที่มีการพิมพ์หมายความว่าวิดเจ็ตนับผู้เล่น จะไม่เสียเมื่อรูปแบบบรรทัดบันทึกเปลี่ยนไป

แปลงรูปภาพใดๆ ให้เป็น server-icon.png ที่เข้ากันได้ และเรียกดูเมธอด JSON-RPC ใน เครื่องมือไอคอนเซิร์ฟเวอร์และ API

ไอคอนเซิร์ฟเวอร์และ API →