HyTari Studios · Resmi görsel rehber

Menu Info Pages

Sonucu görerek JSON öğrenin.

MenuInfoPages yapılandırması için uygulamalı görsel bir başvuru kaynağı. Merkezi pencereden başlayın, yan panellerde gezinmeyi oluşturun, ardından O-Key kısayollarını ve etkileşimli öğeleri özelleştirin. Her örnek kopyalanabilir JSON ve sonucun basitleştirilmiş bir gösterimini içerir.

REHBERE BAŞLA MOD SAYFASI

Önce bunu okuyun

Başlangıç

ADIM 01

Eğitimleri etkinleştirin

config.json içinde languages.tr-TR.enabled ve demo değerlerini true olarak ayarlayın. Full paketi 25 dilde eğitim içerir.

ADIM 02

Bir sayfa oluşturun

/infopages newpage <name> <command> kullanın veya mods/MenuInfoPages/pages/tr-TR/ altında bir JSON dosyası oluşturun.

ADIM 03

Yenile ve test et

İçerik veya görsel değişikliklerinden sonra /infopages reload çalıştırın. Yeni bir oyuncu komutu veya ItemCommands yapısal değişikliği yeniden başlatma gerektirebilir.

Bu örnekler mevcut Full sürümünde bulunan JSON yapılandırması ve eğitim dosyalarına dayanır. Önizlemeler eğitim amaçlı diyagramlardır; ekran görüntüsü veya Hytale'ın yerel arayüz renderı değildir. Örnek komutları, hedefleri ve PNG adlarını sunucunuzdaki kaynaklarla değiştirin. Mevcut dosyaların yedeğini saklayın.

BÖLÜM 01 · 10 ÖRNEKLER

Merkezi GUI

Sayfanın kendisiyle başlayın: metin, bölümler, görseller, düğmeler, izinler ve AutoOpen.

01Sayfa JSON

İlk sayfanız

Tek bir JSON dosyası kendi komutu, başlığı ve giriş metni olan bir sayfa oluşturur.

JSON yapılandırması

{
  "command": "welcome",
  "title": "SUNUCUMUZA HOŞ GELDİNİZ",
  "intro": "Merhaba {player}! Başlamak için ihtiyacınız olan her şey burada.",
  "images": [],
  "sections": [
    {
      "title": "İLK ADIMLAR",
      "text": "Kuralları okuyun, inşa etmek için bir yer bulun ve maceranın tadını çıkarın!",
      "images": []
    }
  ],
  "buttons": [],
  "footer": "İyi eğlenceler!"
}

pages/tr-TR/welcome.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

SUNUCUMUZA HOŞ GELDİNİZ

Merhaba Alex! Başlamak için ihtiyacınız olan her şey burada.

İLK ADIMLAR

Kuralları okuyun, inşa etmek için bir yer bulun ve maceranın tadını çıkarın!

İyi eğlenceler!

Dosya adı komuttan farklı olabilir. Yeni oyuncu komutları oluşturulduktan sonra sunucu yeniden başlatması gerektirebilir.

02Sayfa JSON

Biçimlendirilmiş metin ve yer tutucular

Metninizi biçimlendirin ve oyuncu ile sunucudan dinamik bilgiler ekleyin.

JSON yapılandırması

{
  "command": "player-info",
  "title": "OYUNCU BİLGİLERİ",
  "intro": "{center}{#54DAF4}{b}Tekrar hoş geldin, {player}!{/}{/}",
  "images": [],
  "sections": [
    {
      "title": "{#F894FF}{b}BİLGİLERİN{/}{/}",
      "text": "{b}Oyuncu:{/} {player}\n{b}Dünya:{/} {world}\n{b}Çevrimiçi:{/} {online}/{max_players}\n{m}Yararlı sunucu bilgileri{/}",
      "images": []
    }
  ],
  "buttons": []
}

pages/tr-TR/player-info.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

OYUNCU BİLGİLERİ

Tekrar hoş geldin, Alex!{/}{/}

BİLGİLERİN{/}{/}

Oyuncu:{/} Alex Dünya:{/} Survival Çevrimiçi:{/} 12/256 Yararlı sunucu bilgileri{/}

Biçimlendirilmiş metin Hytale tarafından render edilir. Şematik önizleme yerel yazı tipi renderını taklit etmek yerine biçimlendirme tokenlarını kaldırır.

03Sayfa JSON

Bölüm arka plan renkleri

Aynı menüde standart, şeffaf ve HEX renkli bölümleri birleştirin.

JSON yapılandırması

{
  "command": "colors",
  "title": "ÖZEL BÖLÜMLER",
  "intro": "Her içerik alanı için görsel bir stil seçin.",
  "images": [],
  "sections": [
    {
      "title": "VARSAYILAN",
      "text": "Yerel bölüm stili.",
      "backgroundColor": "default",
      "images": []
    },
    {
      "title": "ŞEFFAF",
      "text": "Arka plan paneli kaldırılır.",
      "backgroundColor": "none",
      "images": []
    },
    {
      "title": "ÖZEL HEX",
      "text": "Özel bir bölüm rengi.",
      "backgroundColor": "#243D59",
      "images": []
    }
  ],
  "buttons": []
}

pages/tr-TR/colors.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

ÖZEL BÖLÜMLER

Her içerik alanı için görsel bir stil seçin.

VARSAYILAN

Yerel bölüm stili.

ŞEFFAF

Arka plan paneli kaldırılır.

ÖZEL HEX

Özel bir bölüm rengi.

backgroundColor değerini tüm sayfada değil, tek tek bölümlerde kullanın.

04Sayfa JSON

Sabit giriş ve başlık görselleri

Bir giriş metni ve en fazla altı görsel kaydırılabilir bölümlerin üzerinde kalır.

JSON yapılandırması

{
  "command": "header",
  "title": "TOPLULUĞUMUZ",
  "intro": "{center}Sunucuyu ve özelliklerini keşfedin.",
  "images": [
    {
      "image": "server-logo.png"
    },
    {
      "image": "welcome-banner.png"
    }
  ],
  "sections": [
    {
      "title": "KAYDIRILABİLİR İÇERİK",
      "text": "Bu bölüm kaydırılırken giriş ve başlık görselleri görünür kalır.",
      "images": []
    }
  ],
  "buttons": []
}

pages/tr-TR/header.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

TOPLULUĞUMUZ

Sunucuyu ve özelliklerini keşfedin.

server-logo.png

welcome-banner.png

KAYDIRILABİLİR İÇERİK

Bu bölüm kaydırılırken giriş ve başlık görselleri görünür kalır.

Sayfayı açmadan önce server-logo.png ve welcome-banner.png dosyalarını mods/MenuInfoPages/images/ içine yerleştirin. PNG kullanın; daha hızlı yükleme için her dosyanın 2 MB altında tutulması önerilir ancak zorunlu değildir.

05Sayfa JSON

Bir bölümde birden fazla görsel

Bir bölüme en fazla altı görsel yerleştirin. Görseller eşit yatay hücrelere dağıtılır.

JSON yapılandırması

{
  "command": "places",
  "title": "ZİYARET EDİLECEK YERLER",
  "intro": "Bir hedef seçin.",
  "images": [],
  "sections": [
    {
      "title": "HEDEFLER",
      "text": "Nereye gitmek istediğinizi seçin.",
      "images": [
        {
          "image": "spawn.png",
          "command": "spawn",
          "runAs": "player",
          "close": true,
          "delayMs": 100
        },
        {
          "image": "market.png",
          "command": "warp market",
          "runAs": "player",
          "close": true,
          "delayMs": 100
        },
        {
          "image": "website.png",
          "command": "https://example.org",
          "close": false
        }
      ]
    }
  ],
  "buttons": []
}

pages/tr-TR/places.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

ZİYARET EDİLECEK YERLER

Bir hedef seçin.

HEDEFLER

Nereye gitmek istediğinizi seçin.

spawn.png

market.png

website.png

Her dosya adı mods/MenuInfoPages/images/ içine eklediğiniz bir PNG'yi temsil eder.

06Sayfa JSON

Bir bölüm içindeki düğmeler

Bir bölüme kendi etkileşimli primary, secondary ve danger eylemlerini verin.

JSON yapılandırması

{
  "command": "section-actions",
  "title": "YARARLI KOMUTLAR",
  "intro": "Farklı düğme stilleri eylemleri ayırt etmeyi kolaylaştırır.",
  "images": [],
  "sections": [
    {
      "title": "GEZİNME",
      "text": "Bir bölüm metin, görsel ve düğmeler içerebilir.",
      "images": [],
      "buttons": [
        {
          "text": "SPAWN",
          "command": "spawn",
          "runAs": "player",
          "close": true,
          "delayMs": 250,
          "style": "primary"
        },
        {
          "text": "SUNUCU KURALLARI",
          "page": "rules",
          "style": "secondary"
        },
        {
          "text": "DANGER ÖRNEĞİ",
          "style": "danger"
        }
      ]
    }
  ],
  "buttons": []
}

pages/tr-TR/section-actions.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

YARARLI KOMUTLAR

Farklı düğme stilleri eylemleri ayırt etmeyi kolaylaştırır.

GEZİNME

Bir bölüm metin, görsel ve düğmeler içerebilir.

SPAWN

SUNUCU KURALLARI

DANGER ÖRNEĞİ

Başka bir MenuInfoPages sayfasını doğrudan açmak için page kullanın. Komut çalıştırmak için command kullanın; runAs: console yalnızca güvenilir eylemler için kullanılmalıdır.

07Sayfa JSON

Alt eylem çubuğu

Alt kısma kaydırılan bölümlerden ayrı en fazla altı eylem yerleştirin.

JSON yapılandırması

{
  "command": "shortcuts",
  "title": "HIZLI EYLEMLER",
  "intro": "Yaygın kısayollar tek yerde.",
  "images": [],
  "sections": [
    {
      "title": "YARDIM",
      "text": "Aşağıdan bir eylem seçin.",
      "images": []
    }
  ],
  "buttons": [
    {
      "text": "KURALLAR",
      "page": "rules",
      "style": "primary"
    },
    {
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player",
      "close": true,
      "delayMs": 250,
      "style": "secondary"
    },
    {
      "text": "WEB SİTESİ",
      "command": "https://example.org",
      "style": "secondary"
    }
  ]
}

pages/tr-TR/shortcuts.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

HIZLI EYLEMLER

Yaygın kısayollar tek yerde.

YARDIM

Aşağıdan bir eylem seçin.

KURALLAR

SPAWN

WEB SİTESİ

rules veya warp market gibi hedefler sunucunuzda mevcut olmalıdır. Bir page hedefi, dahili bir MenuInfoPages sayfa komutudur.

08Sayfa JSON

Sayfa izinleri

Bir sayfayı yetkili kullanıcılarla sınırlamak için isteğe bağlı bir izin düğümü ekleyin.

JSON yapılandırması

{
  "command": "staff-info",
  "permission": "server.staff",
  "title": "EKİP BİLGİLERİ",
  "intro": "Yetkili oyunculara özel bilgiler.",
  "images": [],
  "sections": [
    {
      "title": "EKİP NOTLARI",
      "text": "Bu sayfayı yalnızca server.staff iznine sahip oyuncular açabilir.",
      "images": []
    }
  ],
  "buttons": []
}

pages/tr-TR/staff-info.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

EKİP BİLGİLERİ

Yetkili oyunculara özel bilgiler.

EKİP NOTLARI

Bu sayfayı yalnızca server.staff iznine sahip oyuncular açabilir.

İzin düğümü bir örnektir. Sunucunuzun izin sistemi üzerinden verin. AutoOpen da sayfa izinlerine uyar.

09Sayfa JSON

Girişte otomatik açılma

Karşılama sayfasını bir kez, her zaman veya oyuncu kapatana kadar gösterin.

JSON yapılandırması

{
  "autoOpen": {
    "enabled": true,
    "mode": "dismissible",
    "version": 1,
    "worlds": [],
    "delayMs": 1500
  },
  "command": "server-guide",
  "title": "SUNUCU REHBERİ",
  "intro": "Hoş geldiniz! Gelecekteki girişlerde bu sayfayı gizlemek için Bir daha gösterme seçeneğini işaretleyin.",
  "images": [],
  "sections": [
    {
      "title": "İLK ADIMLAR",
      "text": "Kurallarımızı okuyun ve sunucuda nasıl ilerleyeceğinizi öğrenin.",
      "images": []
    }
  ],
  "buttons": []
}

pages/tr-TR/server-guide.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

SUNUCU REHBERİ

Hoş geldiniz! Gelecekteki girişlerde bu sayfayı gizlemek için Bir daha gösterme seçeneğini işaretleyin.

İLK ADIMLAR

Kurallarımızı okuyun ve sunucuda nasıl ilerleyeceğinizi öğrenin.

autoOpen'u bu sayfanın yedek dil sürümünde yapılandırın. Aynı dünya için çakışan AutoOpen sayfaları etkinleştirmeyin: birden fazla sayfa eşleşirse hiçbiri otomatik açılmaz.

10Yapılandırma JSON

Dahil edilen eğitimleri etkinleştirin

Yüklenecek dilleri, demo sayfalarının oluşturulacağı dillerden bağımsız olarak seçin.

JSON yapılandırması

{
  "fallbackLanguage": "en-US",
  "languages": {
    "en-US": {
      "enabled": true,
      "demo": true
    },
    "it-IT": {
      "enabled": true,
      "demo": false
    },
    "de-DE": {
      "enabled": true,
      "demo": false
    }
  }
}

config.json — top-level fields

Görsel sonuçŞematik önizleme

Dil ayarları

en-USYüklendi · Demo ON

it-ITYüklendi · Demo OFF

de-DEYüklendi · Demo OFF

İstemci dili sayfa çevirisini seçer; eksik çeviriler yapılandırılmış yedek dili kullanır.

Full sürümü 25 dil klasörü içerir. Bir dilin eğitim sayfalarının oluşturulması için enabled ve demo değerlerinin ikisi de true olmalıdır. Artık gerekmediğinde demo: false olarak ayarlayın.

BÖLÜM 02 · 5 ÖRNEKLER

Sol ve sağ yan paneller

Bir veya iki bağımsız panel, sabit panel başlıkları ve karma gezinme öğeleri ekleyin.

Açık sayfa için otomatik PRIMARY vurgusu

Hem leftContent hem de rightContent içinde, page değeri açık sayfanın command değeriyle eşleşen yan panel düğmesi otomatik olarak primary görünür. "style": "primary" belirtmeniz gerekmez. Aşağıdaki örneklerde bu durum altın renkle gösterilir. Diğer düğmeler yapılandırılmış stillerini korur.

Yalnızca eşleşen sayfa hedefleri otomatik vurgulanır: üst kategori veya karşı paneldeki ilgisiz bir düğme otomatik seçilmez. Böyle bir düğmeyi başka bir sayfada vurgulu tutmak için o sayfanın JSON'unda açıkça "style": "primary" kullanın.

01Sayfa JSON

Sol gezinme paneli

Sayfa bağlantıları ve metin başlıkları içeren bağımsız kaydırılan bir sol panel oluşturun. Aktif sayfa düğmesi otomatik olarak primary vurgulanır.

JSON yapılandırması

{
  "command": "help-index",
  "title": "YARDIM MERKEZİ",
  "intro": "Bilgiler arasında gezinmek için sol menüyü kullanın.",
  "images": [],
  "sections": [
    {
      "title": "BİR KONU SEÇİN",
      "text": "Sayfalar arayüzü kapatmadan birbirine bağlantı verebilir.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "BİLGİLER"
    },
    {
      "type": "button",
      "text": "YARDIM MERKEZİ",
      "page": "help-index"
    },
    {
      "type": "button",
      "text": "HOŞ GELDİNİZ",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "KURALLAR",
      "page": "rules"
    },
    {
      "type": "button",
      "text": "YARDIM",
      "command": "help",
      "runAs": "player"
    }
  ],
  "buttons": []
}

pages/tr-TR/help-index.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

sol panel

BİLGİLER

YARDIM MERKEZİ

HOŞ GELDİNİZ

KURALLAR

YARDIM

YARDIM MERKEZİ

Bilgiler arasında gezinmek için sol menüyü kullanın.

BİR KONU SEÇİN

Sayfalar arayüzü kapatmadan birbirine bağlantı verebilir.

HELP CENTER bu sayfanın komutuna (help-index) işaret ettiği için style alanı olmadan primary olur. Her çeviride aynı page hedeflerini kullanın.

02Sayfa JSON

Sağ yan panel

Alt konular veya bağlamsal eylem listesi için rightContent kullanın. Aktif sayfa vurgusu sağ tarafta da çalışır.

JSON yapılandırması

{
  "command": "guide-topic",
  "title": "REHBER KONUSU",
  "intro": "Ek gezinme sağ tarafta yer alır.",
  "images": [],
  "sections": [
    {
      "title": "ANA MAKALE",
      "text": "Ana içeriği merkezde tutun.",
      "images": []
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "KONULAR"
    },
    {
      "type": "button",
      "text": "GÜNCEL KONU",
      "page": "guide-topic"
    },
    {
      "type": "button",
      "text": "KOMUTLAR",
      "page": "shortcuts"
    }
  ],
  "buttons": []
}

pages/tr-TR/guide-topic.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

REHBER KONUSU

Ek gezinme sağ tarafta yer alır.

ANA MAKALE

Ana içeriği merkezde tutun.

sağ panel

KONULAR

GÜNCEL KONU

KOMUTLAR

CURRENT TOPIC, page hedefi guide-topic ile eşleştiği için otomatik olarak primary olur. Elle style ayarlamak gerekmez; her panel bağımsız kaydırılır.

03Sayfa JSON

İki yan panel birlikte

Merkezi sayfa yapısını değiştirmeden bağımsız sol ve sağ gezinmeyi birleştirin.

JSON yapılandırması

{
  "command": "server-manual",
  "title": "SUNUCU KILAVUZU",
  "intro": "Kategori ve alt konuya göre gezinin.",
  "images": [],
  "sections": [
    {
      "title": "GÜNCEL KONU",
      "text": "Merkez ana bilgilerinize ayrılmış olarak kalır.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "button",
      "text": "GİRİŞ",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "KURALLAR",
      "page": "rules"
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "HIZLI BAĞLANTILAR"
    },
    {
      "type": "button",
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player"
    },
    {
      "type": "button",
      "text": "WEB SİTESİ",
      "command": "https://example.org"
    }
  ],
  "buttons": []
}

pages/tr-TR/server-manual.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

sol panel

GİRİŞ

KURALLAR

SUNUCU KILAVUZU

Kategori ve alt konuya göre gezinin.

GÜNCEL KONU

Merkez ana bilgilerinize ayrılmış olarak kalır.

sağ panel

HIZLI BAĞLANTILAR

SPAWN

WEB SİTESİ

Her panele JSON'da yazıldığı sırayla en fazla 24 karma öğe yerleştirilebilir.

04Sayfa JSON

Yan panellerin üzerinde sabit görseller

Her panele bağımsız olarak sabit başlık görseli ekleyin.

JSON yapılandırması

{
  "command": "branded-menu",
  "title": "MARKALI GEZİNME",
  "intro": "Panel başlıkları, öğeleri kaydırılırken görünür kalır.",
  "images": [],
  "sections": [
    {
      "title": "HOŞ GELDİNİZ",
      "text": "Bir veya iki sabit yan panel başlığını deneyin.",
      "images": []
    }
  ],
  "leftHeaderImage": {
    "image": "left-logo.png",
    "page": "welcome"
  },
  "leftContent": [
    {
      "type": "button",
      "text": "ANA SAYFA",
      "page": "welcome"
    }
  ],
  "rightHeaderImage": {
    "image": "right-logo.png"
  },
  "rightContent": [
    {
      "type": "button",
      "text": "KURALLAR",
      "page": "rules"
    }
  ],
  "buttons": []
}

pages/tr-TR/branded-menu.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

sol panel

left-logo.png

ANA SAYFA

MARKALI GEZİNME

Panel başlıkları, öğeleri kaydırılırken görünür kalır.

HOŞ GELDİNİZ

Bir veya iki sabit yan panel başlığını deneyin.

sağ panel

right-logo.png

KURALLAR

left-logo.png ve right-logo.png dosyalarını mods/MenuInfoPages/images/ içine yerleştirin. Her panel başlığı isteğe bağlı bir page veya command eylemi kabul eder.

05Sayfa JSON

Karma metin, görseller ve düğmeler

Metin, tıklanabilir görseller ve gezinme düğmelerini herhangi bir yan panelde serbestçe sıralayın.

JSON yapılandırması

{
  "command": "player-panel",
  "title": "OYUNCU PANELİ",
  "intro": "Yan paneller üç öğe türünü karıştırabilir.",
  "images": [],
  "sections": [
    {
      "title": "GENEL BAKIŞ",
      "text": "Tekrar hoş geldin, {player}!",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "{center}{b}PROFİLİN{/}"
    },
    {
      "type": "image",
      "image": "profile.png",
      "command": "profile",
      "runAs": "player",
      "close": true,
      "delayMs": 250
    },
    {
      "type": "text",
      "text": "Oyuncu: {player}"
    },
    {
      "type": "button",
      "text": "ANA SAYFA",
      "page": "welcome"
    }
  ],
  "buttons": []
}

pages/tr-TR/player-panel.json

Görsel sonuçŞematik önizleme

MENUINFOPAGES · ŞEMA×

sol panel

PROFİLİN{/}

profile.png

Oyuncu: Alex

ANA SAYFA

OYUNCU PANELİ

Yan paneller üç öğe türünü karıştırabilir.

GENEL BAKIŞ

Tekrar hoş geldin, Alex!

Mevcut Full yan panel dizileri leftContent/rightContent'tir. Gelecekteki birleşik content/cells şeması bu rehberin parçası değildir.

BÖLÜM 03 · 4 ÖRNEKLER

O-Key & HUD

Hızlı erişim kısayolları oluşturun, göstergelerini konumlandırın ve dünya başına davranışı yapılandırın.

01Yapılandırma JSON

Genel O-Key kısayolu

Her dünya için varsayılan komutu, izinleri ve HUD göstergesini ayarlayın.

JSON yapılandırması

{
  "O-Key": {
    "Enabled": true,
    "RequirePermission": false,
    "Permission": "menuinfopages.okey",
    "OpPermission": "hytale.command.gamemode",
    "AllWorlds": {
      "Command": "menuinfopages",
      "OpCommand": "menuinfopages",
      "AppliesOnOP": true,
      "CooldownMs": 250,
      "Hud": {
        "Enabled": true,
        "Horizontal": "right:-8",
        "Vertical": "top:245",
        "Title": "menuinfopages.hud.okey.press",
        "Image": "default",
        "Width": 112,
        "Height": 112
      }
    }
  }
}

config.json — O-Key object

Görsel sonuçŞematik önizleme

O-Key · örnek HUD

Oyun ekranı gösterimi

HUD konumu: right:-8, top:245. Komutlar ve davranış config.json içinde yapılandırılır.

Tüm config.json dosyasını değiştirmek yerine mevcut O-Key nesnesini düzenleyin. HUD görselindeki default değeri dahil edilen simgeyi ifade eder.

02Yapılandırma JSON

O-Key HUD'unu ortala

center değerini eksenlerden birinde bağımsız kullanın; diğer ekseni bir kenardan ayarlayın.

JSON yapılandırması

{
  "Hud": {
    "Enabled": true,
    "Image": "default",
    "Width": 112,
    "Height": 112,
    "Horizontal": "center",
    "Vertical": "top:190"
  }
}

config.json — O-Key.AllWorlds.Hud

Görsel sonuçŞematik önizleme

O-Key · örnek HUD

Oyun ekranı gösterimi

HUD konumu: center, top:190. Komutlar ve davranış config.json içinde yapılandırılır.

Bu örnek kısmi bir Hud nesnesidir; bu değerleri mevcut O-Key.AllWorlds.Hud ayarlarınıza ekleyin.

03Yapılandırma JSON

Dünya ve instance override'ları

Belirli dünyalara, son wildcard kullanılan oluşturulmuş instance'lar dahil, farklı bir kısayol verin.

JSON yapılandırması

{
  "WorldOverrides": [
    {
      "Worlds": [
        "Survival"
      ],
      "Enabled": true,
      "Command": "welcome",
      "Hud": {
        "Enabled": true,
        "Horizontal": "right:-5",
        "Vertical": "center"
      }
    },
    {
      "Worlds": [
        "instance-Forgotten_Temple-*"
      ],
      "Enabled": true,
      "Command": "server-guide",
      "Hud": {
        "Enabled": true,
        "Horizontal": "center",
        "Vertical": "top:190"
      }
    }
  ]
}

config.json — O-Key.WorldOverrides

Görsel sonuçŞematik önizleme

O-Key · örnek HUD

Oyun ekranı gösterimi

Survival → /welcome

instance-Forgotten_Temple-* → /server-guide

Dünya adı önekinde tek bir son * desteklenir. Tam adlar wildcard desenlerinden önceliklidir; aksi halde en uzun eşleşen önek kazanır.

04Yapılandırma JSON

Özel O-Key görseli

Yapılandırılabilir boyut ve konumla kendi PNG'nizi kullanın.

JSON yapılandırması

{
  "Hud": {
    "Enabled": true,
    "Image": "okey-survival.png",
    "Width": 300,
    "Height": 200,
    "Horizontal": "right:-5",
    "Vertical": "top:138"
  }
}

config.json — O-Key.AllWorlds.Hud

Görsel sonuçŞematik önizleme

O-Key · örnek HUD

Oyun ekranı gösterimi

HUD konumu: right:-5, top:138. Komutlar ve davranış config.json içinde yapılandırılır.

okey-survival.png dosyasını mods/MenuInfoPages/images/ içine yerleştirin. Width/Height değerlerini PNG en-boy oranına göre ayarlayın; örneğin 600×400 görsel 300×200 olarak render edilebilir.

BÖLÜM 04 · 2 ÖRNEKLER

ItemCommands

Sol ve sağ tık için ayrı komutlara sahip öğeler oluşturun.

01Yapılandırma JSON

Demo öğesini etkinleştirin

Dahil edilen örnek, sol ve sağ eylemleri ayrı olan etkileşimli bir kaynak öğe sağlar.

JSON yapılandırması

{
  "itemCommands": {
    "enabled": true,
    "items": [
      {
        "id": "demo",
        "sourceItem": "MenuInfoPages_Demo_Grimoire_Source",
        "name": "Demo Sayfaları",
        "quality": "",
        "leftClickCommand": "menuinfopages",
        "rightClickCommand": "menuinfopages"
      }
    ]
  }
}

config.json — itemCommands object

Görsel sonuçŞematik önizleme

ItemCommands · etkileşim haritası

Demo Sayfaları

Sol tık/menuinfopages

Sağ tık/menuinfopages

Bu, dahil edilen örneğin gerçek kaynak öğe ID'sidir. Sayfa değişikliklerinin aksine, yapısal öğe güncellemeleri sunucunun yeniden başlatılmasını gerektirebilir.

02Yapılandırma JSON

Ayrı sol ve sağ komutlar

Yeni bir etkileşimli kısayolun kaynağı olarak mevcut bir Hytale veya kurulu mod öğesi kullanın.

JSON yapılandırması

{
  "itemCommands": {
    "enabled": true,
    "items": [
      {
        "id": "server-shortcuts",
        "sourceItem": "MenuInfoPages_Demo_Grimoire_Source",
        "name": "Sunucu Kısayolları",
        "quality": "",
        "leftClickCommand": "welcome",
        "rightClickCommand": "spawn"
      }
    ]
  }
}

config.json — itemCommands object

Görsel sonuçŞematik önizleme

ItemCommands · etkileşim haritası

Sunucu Kısayolları

Sol tık/welcome

Sağ tık/spawn

sourceItem değerini sunucunuzda kurulu gerçek bir öğe ID'siyle değiştirin ve oyuncuların erişebildiği mevcut komutları seçin. ItemCommands sayfa JSON'undan bağımsızdır.

Bir örneği kullanmadan önce

Tam sayfa örnekleri: Her JSON nesnesini mods/MenuInfoPages/pages/tr-TR/ altında ayrı bir dosyaya yerleştirin. Her sayfanın komutunu benzersiz tutun ve gerektiğinde diğer dil klasörlerindeki karşılık gelen sayfa dosyalarını çevirin.

Yapılandırma örnekleri: O-Key ve ItemCommands nesneleri mevcut config.json dosyanızın parçalarıdır. Gösterilen özellikleri doğru konuma ekleyin; tüm yapılandırma dosyasını küçük bir örnekle asla değiştirmeyin.

Güvenli yapılandırma: Başvurulan PNG dosyalarını beklenen görsel klasörüne yerleştirin. En iyi performans için her görseli 2 MB altında tutmak önerilir ancak zorunlu değildir; daha büyük dosyalar daha fazla yükleme süresi ve bellek gerektirebilir. Demo komutları, sayfa gezinme hedefleri, izin düğümleri ve harici URL'ler sizin sağlayacağınız kaynaklar için yer tutucudur. Güvenilmeyen oyuncular için yüksek yetkili komutlar çalıştırmaktan kaçının.

Geçerli şema: Bu rehber mevcut sections, leftContent ve rightContent sistemini açıklar; gelecekte olası birleşik content/cells modeli yayınlanmış bir özellik gibi gösterilmez.

YUKARI DÖN