การตั้งค่าอินสแตนซ์ (schema v2)

การตั้งค่าอินสแตนซ์อธิบายม็อดแพ็กหนึ่งชุด: ตัวตน เวอร์ชัน Minecraft และโหลดเดอร์ การนำเสนอ และวิธีที่ตัวเปิดปฏิบัติกับไฟล์ Neko API ให้บริการสำหรับอินสแตนซ์บนแดชบอร์ด ส่วนเจ้าของที่โฮสต์เองเขียนเป็น instance.json

• Schema: https://cdn.neko-launcher.com/schema/neko-launcher.json (เวอร์ชัน 2, 2026-09-21)
• Schema ก่อนหน้า (ล้าสมัย ตัวเปิดยังรับ): https://cdn.neko-launcher.com/schema/neko-launcher-v1.json

ใส่ "$schema" ในไฟล์เพื่อให้ editor ตรวจสอบและเติมให้

รูปร่าง

ไฟล์ที่โฮสต์เองเป็นได้ทั้ง object เปล่าด้านล่างหรือ envelope ของ API { "code": 200, "message": "OK", "data": { … } } ทั้งสองแบบผ่าน schema และตัวเปิดรับได้

{
  "$schema": "https://cdn.neko-launcher.com/schema/neko-launcher.json",
  "name": "my-server",
  "displayName": "My Server",
  "description": "Fabric survival กับเพื่อน",
  "icon": "https://cdn.example.com/icon.png",
  "onlineMode": true,
  "minecraft": {
    "version": "1.21.8",
    "loader": { "type": "fabric", "build": "0.17.3", "enable": true }
  },
  "metadata": {
    "wallpaper": "https://cdn.example.com/wallpaper.webp",
    "announcementUrl": "https://cdn.example.com/announcements.json",
    "announcementEnabled": true,
    "no_access_title": "Members only",
    "th_no_access_title": "เฉพาะสมาชิก"
  },
  "gameArgs": ["--quickPlayMultiplayer=play.example.com"],
  "socials": [
    { "type": "discord", "url": "https://discord.gg/example" },
    { "type": "web", "url": "https://example.com", "label": "เว็บไซต์" }
  ],
  "tags": ["survival"],
  "ignored": ["options.txt", "resourcepacks", "shaderpacks", "screenshots", "logs"],
  "readonly": true,
  "hideMods": false,
  "activeVersion": "1.0.0",
  "changelog": "รุ่นแรก"
}
json

ฟิลด์

บังคับ

การนำเสนอ

พฤติกรรม

สิทธิ์ (อินสแตนซ์บนแดชบอร์ด เป็นข้อมูลประกอบสำหรับโฮสต์เอง)

ข้อความแยกภาษาใน metadata

key ใดใน metadata นำหน้าด้วยรหัสภาษาสองตัวได้: th_no_access_title, en_no_access_subtitle, jp_…, ru_… ตัวเปิดเลือกภาษาของผู้เล่นและใช้ key ที่ไม่มีคำนำหน้าเมื่อไม่มี key ที่ไม่รู้จักถูกเก็บไว้

เวอร์ชัน

ต่างจาก schema v1

• description และ icon เป็น null ได้
• เพิ่ม: visibility, enforceWhitelist, tags, hideMods, activeVersion, changelog, applicationMode, access, key วอลเปเปอร์วิดีโอ, announcementEnabled, ข้อความ no_access_*
• socials[].type เพิ่ม furipay (FuriPay handle ใน url) และทุกรายการมี label ได้
• metadata รับ key เพิ่มเติมได้
• รับ envelope ของ API ที่ระดับบนสุด
• ไฟล์ v1 ยังเป็นเอกสาร v2 ที่ถูกต้อง

ดูเพิ่มเติม

• Manifest ของอินสแตนซ์
• DNS discovery
• อินสแตนซ์ในแดชบอร์ด