server-icon.png: ang eksaktong mga kinakailangan, at ang management API na walang gumagamit

64x64, PNG, sa server root — magkamali sa alinman sa tatlo at tahimik na hindi lalabas ang icon. Dagdag pa ang JSON-RPC management API na pumalit sa screen-scraping ng console.

2026-06-14

Ang server icon ang pinakasensitibong maliit na feature sa Minecraft, dahil magkakapareho ang itsura ng bawat uri ng error: walang icon, walang error.

Tatlong kinakailangan, lahat ay mandatory

1. Eksaktong 64×64 pixels. Hindi 63, hindi 128. Hindi nagre-resize ang server.
2. Format na PNG. Tunay na PNG, hindi pinalitang-pangalan na JPG.
3. Pinangalanang server-icon.png, in the server root — katabi ng server.properties, not

sa loob ng folder ng mundo.

Magkamali sa kahit isa at magsisimula nang normal ang server at ipapakita ang default na icon. Walang nai-log sa default level.

Mga bagay na nakakasira rin dito

• Interlaced na PNG. Ang ilang editor ay nagse-save bilang interlaced bilang default; tinatanggihan ng reader ng Minecraft

ito. I-re-export bilang non-interlaced.

• 16-bit na lalim ng kulay. I-save bilang 8-bit bawat channel.
• Mga profile ng kulay. Ang naka-embed na ICC profile ay paminsan-minsang nagdudulot ng error sa parser. Tanggalin ang

metadata sa pag-export.

• Ayos lang ang transparency at nagre-render nang tama sa listahan ng server.

Kina-cache ito ng client

Kapag nakita na ng isang client ang iyong server, pinapanatili nito ang icon. Ang pagbabago nito sa server-side ay hindi nag-a-update ng mga umiiral na entry — kailangang alisin at muling idagdag ng manlalaro ang server, o maghintay na mag-expire ang cache. Ang pagsubok ng pagbabago ng icon mula sa sarili mong client ay magpapaniwala sa iyo na hindi ito gumana kahit gumana naman talaga.

Ang management API

Ang mga kamakailang bersyon ng server ay naglalantad ng isang JSON-RPC management interface, na siyang opisyal na kapalit sa pag-parse ng console output o pagkakabit ng plugin.

Paganahin ito sa server.properties:

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

Pagkatapos ay makipag-ugnayan gamit ang JSON-RPC sa port na iyon:

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

Sinasaklaw ng mga method ang listahan ng manlalaro, katayuan ng server, allowlist at ban list, mga gamerule, mga setting, at isang save/stop pair. Nagbabalik ang bawat isa ng structured na JSON sa halip na isang linya ng teksto na kailangan mong i-regex.

I-bind ito sa localhost

Ang default ay localhost and it should stay there. The interface is hindi nilalayong ilantad sa internet — kahit ano na makarating dito ay maaaring magpahinto sa iyong server. Ilantad ito sa pamamagitan ng isang SSH tunnel o isang reverse proxy na may authentication kung kailangan mo ng remote access, huwag kailanman sa pamamagitan ng pagpapalit ng host sa 0.0.0.0.

Bakit ito mahalaga

Ang mga dashboard, Discord bot at uptime monitor ay dating gumagana sa pamamagitan ng pagbabasa ng console log o paggamit ng RCON, na parehong madaling masira. Ang isang typed API ay nangangahulugang ang isang player-count widget ay hindi masisira kapag nagbago ang format ng linya sa log.

I-convert ang anumang larawan sa isang sumusunod na server-icon.png and browse the JSON-RPC methods in the Mga Tool sa Server Icon at API.