server-icon.png: सटीक आवश्यकताएं, और वह प्रबंधन API जिसका कोई उपयोग नहीं करता
64x64, PNG, सर्वर रूट पर — तीनों में से एक भी गलत हुआ और आइकन बिना किसी सूचना के गायब रहेगा। साथ ही JSON-RPC प्रबंधन API जिसने कंसोल को स्क्रीन-स्क्रैप करने की जगह ले ली है।
सर्वर आइकन Minecraft का सबसे असंवेदनशील छोटा फीचर है, क्योंकि हर विफलता का परिणाम एक जैसा दिखता है: कोई आइकन नहीं, कोई एरर नहीं।
तीन आवश्यकताएं, सभी अनिवार्य
- बिल्कुल 64×64 पिक्सल। न 63, न 128। सर्वर आकार नहीं बदलता है।
- PNG फॉर्मेट। वास्तव में PNG, न कि नाम बदला हुआ JPG।
- नामित
server-icon.png, in the server root — इसके पासserver.properties, not
world फ़ोल्डर के अंदर।
किसी भी एक में गलती होने पर सर्वर सामान्य रूप से शुरू हो जाता है और डिफ़ॉल्ट आइकन दिखाता है। डिफ़ॉल्ट स्तर पर कुछ भी लॉग नहीं होता है।
वे चीजें जो इसे भी बाधित करती हैं
- इंटरलैस्ड PNG। कुछ संपादक डिफ़ॉल्ट रूप से इंटरलैस्ड सेव करते हैं; Minecraft का रीडर अस्वीकार करता है
इसे। गैर-इंटरलैस्ड के रूप में फिर से निर्यात करें।
- 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" }तरीके प्लेयर सूची, सर्वर स्थिति, allowlist और ban सूची, gamerules, सेटिंग्स, और save/stop जोड़ी को कवर करते हैं। प्रत्येक एक संरचित JSON लौटाता है न कि टेक्स्ट की एक पंक्ति जिसे आपको regex करना पड़े।
इसे localhost से बाइंड करें
डिफ़ॉल्ट है localhost and it should stay there. The interface is नहीं इंटरनेट के संपर्क में आने के लिए अभिप्रेत — इस तक पहुँचने वाली कोई भी चीज़ आपके सर्वर को रोक सकती है। यदि आपको रिमोट एक्सेस की आवश्यकता है, तो इसे SSH टनल या प्रमाणीकरण वाले रिवर्स प्रॉक्सी के माध्यम से उजागर करें, कभी भी होस्ट को इसमें न बदलें 0.0.0.0.
यह क्यों मायने रखता है
डैशबोर्ड, Discord बॉट और अपटाइम मॉनिटर ऐतिहासिक रूप से कंसोल लॉग पढ़कर या RCON का उपयोग करके काम करते रहे हैं, जो दोनों ही नाजुक हैं। एक टाइप्ड API का मतलब है कि जब कोई लॉग लाइन फॉर्मेट बदलती है तो प्लेयर-काउंट विजेट खराब नहीं होता है।
किसी भी छवि को एक अनुपालन योग्य server-icon.png and browse the JSON-RPC methods in the सर्वर आइकन और API टूल्स.