HyTari Studios · Hivatalos vizuális útmutató

Menu Info Pages

Tanulj JSON-t az eredmény megfigyelésével.

Gyakorlati vizuális referencia a MenuInfoPages beállításához. Kezdd a központi ablakkal, építsd fel az oldalsávok navigációját, majd szabd testre az O-Key gyorsbillentyűket és az interaktív tárgyakat. Minden példa másolható JSON-t és az eredmény egyszerűsített megjelenítését tartalmazza.

ÚTMUTATÓ INDÍTÁSA MOD OLDALA

Ezt olvasd el először

Első lépések

LÉPÉS 01

Oktatóoldalak engedélyezése

A config.json fájlban állítsd a languages.hu-HU.enabled és demo értékét true értékre. A Full csomag 25 nyelven tartalmaz oktatóoldalakat.

LÉPÉS 02

Oldal létrehozása

Használd a /infopages newpage <name> <command> parancsot, vagy hozz létre egy JSON-fájlt itt: mods/MenuInfoPages/pages/hu-HU/.

LÉPÉS 03

Újratöltés és teszt

Tartalom- vagy képmódosítás után futtasd a /infopages reload parancsot. Új játékosparancs vagy strukturális ItemCommands-módosítás újraindítást igényelhet.

Ezek a példák a jelenlegi Full kiadásban található JSON-konfigurációra és oktatófájlokra épülnek. Az előnézetek oktatási célú ábrák, nem képernyőképek és nem a Hytale natív felületének renderelései. Cseréld le a példaparanccsokat, célokat és PNG-neveket a szervereden elérhető erőforrásokra. Készíts biztonsági másolatot a meglévő fájlokról.

FEJEZET 01 · 10 PÉLDÁK

Központi GUI

Kezdd magával az oldallal: szöveg, szekciók, képek, gombok, jogosultságok és AutoOpen.

01Oldal JSON

Az első oldalad

Egy JSON-fájl létrehoz egy oldalt saját paranccsal, címmel és bevezetővel.

JSON konfiguráció

{
  "command": "welcome",
  "title": "ÜDV A SZERVERÜNKÖN",
  "intro": "Szia {player}! Itt mindent megtalálsz, ami a kezdéshez kell.",
  "images": [],
  "sections": [
    {
      "title": "ELSŐ LÉPÉSEK",
      "text": "Olvasd el a szabályokat, keress helyet az építkezéshez, és élvezd a kalandot!",
      "images": []
    }
  ],
  "buttons": [],
  "footer": "Jó játékot!"
}

pages/hu-HU/welcome.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

ÜDV A SZERVERÜNKÖN

Szia Alex! Itt mindent megtalálsz, ami a kezdéshez kell.

ELSŐ LÉPÉSEK

Olvasd el a szabályokat, keress helyet az építkezéshez, és élvezd a kalandot!

Jó játékot!

A fájlnév eltérhet a parancstól. Új játékosparancs létrehozása után szerver-újraindításra lehet szükség.

02Oldal JSON

Formázott szöveg és helyőrzők

Formázd a szöveget, és illessz be dinamikus adatokat a játékosról és a szerverről.

JSON konfiguráció

{
  "command": "player-info",
  "title": "JÁTÉKOSINFORMÁCIÓ",
  "intro": "{center}{#54DAF4}{b}Üdv újra, {player}!{/}{/}",
  "images": [],
  "sections": [
    {
      "title": "{#F894FF}{b}ADATAID{/}{/}",
      "text": "{b}Játékos:{/} {player}\n{b}Világ:{/} {world}\n{b}Online:{/} {online}/{max_players}\n{m}Hasznos szerverinformáció{/}",
      "images": []
    }
  ],
  "buttons": []
}

pages/hu-HU/player-info.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

JÁTÉKOSINFORMÁCIÓ

Üdv újra, Alex!{/}{/}

ADATAID{/}{/}

Játékos:{/} Alex Világ:{/} Survival Online:{/} 12/256 Hasznos szerverinformáció{/}

A formázott szöveget a Hytale rendereli. A sematikus előnézet eltávolítja a formázási tokeneket a natív betűrenderelő utánzása helyett.

03Oldal JSON

Szekciók háttérszínei

Kombinálj normál, átlátszó és HEX-színű szekciókat ugyanabban a menüben.

JSON konfiguráció

{
  "command": "colors",
  "title": "EGYEDI SZEKCIÓK",
  "intro": "Válassz vizuális megjelenést minden tartalmi területhez.",
  "images": [],
  "sections": [
    {
      "title": "ALAPÉRTELMEZETT",
      "text": "Natív szekcióstílus.",
      "backgroundColor": "default",
      "images": []
    },
    {
      "title": "ÁTLÁTSZÓ",
      "text": "A háttérpanel eltűnik.",
      "backgroundColor": "none",
      "images": []
    },
    {
      "title": "EGYEDI HEX",
      "text": "Egyedi szekciószín.",
      "backgroundColor": "#243D59",
      "images": []
    }
  ],
  "buttons": []
}

pages/hu-HU/colors.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

EGYEDI SZEKCIÓK

Válassz vizuális megjelenést minden tartalmi területhez.

ALAPÉRTELMEZETT

Natív szekcióstílus.

ÁTLÁTSZÓ

A háttérpanel eltűnik.

EGYEDI HEX

Egyedi szekciószín.

A backgroundColor értéket az egyes szekciókon használd, ne az egész oldalon.

04Oldal JSON

Rögzített bevezető és fejléc-képek

A bevezető és legfeljebb hat kép a görgethető szekciók fölött marad.

JSON konfiguráció

{
  "command": "header",
  "title": "KÖZÖSSÉGÜNK",
  "intro": "{center}Fedezd fel a szervert és a funkcióit.",
  "images": [
    {
      "image": "server-logo.png"
    },
    {
      "image": "welcome-banner.png"
    }
  ],
  "sections": [
    {
      "title": "GÖRGETHETŐ TARTALOM",
      "text": "Ez a szekció görgethető, miközben a bevezető és a fejléc-képek láthatók maradnak.",
      "images": []
    }
  ],
  "buttons": []
}

pages/hu-HU/header.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

KÖZÖSSÉGÜNK

Fedezd fel a szervert és a funkcióit.

server-logo.png

welcome-banner.png

GÖRGETHETŐ TARTALOM

Ez a szekció görgethető, miközben a bevezető és a fejléc-képek láthatók maradnak.

Az oldal megnyitása előtt tedd a server-logo.png és welcome-banner.png fájlokat a mods/MenuInfoPages/images/ mappába. PNG használata szükséges; a gyorsabb betöltés érdekében ajánlott, de nem kötelező az egyes fájlokat 2 MB alatt tartani.

05Oldal JSON

Több kép egy szekcióban

Helyezz el legfeljebb hat képet egy szekcióban. Egyenlő vízszintes cellákba rendeződnek.

JSON konfiguráció

{
  "command": "places",
  "title": "MEGLÁTOGATANDÓ HELYEK",
  "intro": "Válassz úti célt.",
  "images": [],
  "sections": [
    {
      "title": "ÚTI CÉLOK",
      "text": "Válaszd ki, hová szeretnél menni.",
      "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/hu-HU/places.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

MEGLÁTOGATANDÓ HELYEK

Válassz úti célt.

ÚTI CÉLOK

Válaszd ki, hová szeretnél menni.

spawn.png

market.png

website.png

Minden fájlnév egy általad a mods/MenuInfoPages/images/ mappába helyezett PNG-t jelöl.

06Oldal JSON

Gombok egy szekción belül

Adj a szekciónak saját interaktív primary, secondary és danger műveleteket.

JSON konfiguráció

{
  "command": "section-actions",
  "title": "HASZNOS PARANCSOK",
  "intro": "A különböző gombstílusok könnyen felismerhetővé teszik a műveleteket.",
  "images": [],
  "sections": [
    {
      "title": "NAVIGÁCIÓ",
      "text": "Egy szekció tartalmazhat szöveget, képeket és gombokat.",
      "images": [],
      "buttons": [
        {
          "text": "SPAWN",
          "command": "spawn",
          "runAs": "player",
          "close": true,
          "delayMs": 250,
          "style": "primary"
        },
        {
          "text": "SZERVERSZABÁLYOK",
          "page": "rules",
          "style": "secondary"
        },
        {
          "text": "DANGER PÉLDA",
          "style": "danger"
        }
      ]
    }
  ],
  "buttons": []
}

pages/hu-HU/section-actions.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

HASZNOS PARANCSOK

A különböző gombstílusok könnyen felismerhetővé teszik a műveleteket.

NAVIGÁCIÓ

Egy szekció tartalmazhat szöveget, képeket és gombokat.

SPAWN

SZERVERSZABÁLYOK

DANGER PÉLDA

A page segítségével közvetlenül megnyithatsz egy másik MenuInfoPages oldalt. A command paranccsal műveleteket futtathatsz; a runAs: console csak megbízható műveleteknél használható.

07Oldal JSON

Alsó műveletsáv

Helyezz el legfeljebb hat műveletet alul, a görgethető szekcióktól elkülönítve.

JSON konfiguráció

{
  "command": "shortcuts",
  "title": "GYORSMŰVELETEK",
  "intro": "Gyakori gyorsbillentyűk egy helyen.",
  "images": [],
  "sections": [
    {
      "title": "SÚGÓ",
      "text": "Válassz egy műveletet lent.",
      "images": []
    }
  ],
  "buttons": [
    {
      "text": "SZABÁLYOK",
      "page": "rules",
      "style": "primary"
    },
    {
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player",
      "close": true,
      "delayMs": 250,
      "style": "secondary"
    },
    {
      "text": "WEBOLDAL",
      "command": "https://example.org",
      "style": "secondary"
    }
  ]
}

pages/hu-HU/shortcuts.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

GYORSMŰVELETEK

Gyakori gyorsbillentyűk egy helyen.

SÚGÓ

Válassz egy műveletet lent.

SZABÁLYOK

SPAWN

WEBOLDAL

A rules vagy warp market típusú céloknak létezniük kell a szerveren. A page cél egy belső MenuInfoPages oldalparancs.

08Oldal JSON

Oldaljogosultságok

Adj hozzá opcionális jogosultsági csomópontot, hogy az oldalt csak engedélyezett felhasználók érhessék el.

JSON konfiguráció

{
  "command": "staff-info",
  "permission": "server.staff",
  "title": "STAFF INFORMÁCIÓ",
  "intro": "Korlátozott információ jogosult játékosoknak.",
  "images": [],
  "sections": [
    {
      "title": "STAFF JEGYZETEK",
      "text": "Csak a server.staff jogosultsággal rendelkező játékosok nyithatják meg ezt az oldalt.",
      "images": []
    }
  ],
  "buttons": []
}

pages/hu-HU/staff-info.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

STAFF INFORMÁCIÓ

Korlátozott információ jogosult játékosoknak.

STAFF JEGYZETEK

Csak a server.staff jogosultsággal rendelkező játékosok nyithatják meg ezt az oldalt.

A jogosultsági csomópont csak példa. A szerver jogosultsági rendszerén keresztül add meg. Az AutoOpen szintén figyelembe veszi az oldaljogosultságokat.

09Oldal JSON

Automatikus megnyitás csatlakozáskor

Mutasd a köszöntőoldalt egyszer, mindig vagy addig, amíg a játékos le nem tiltja.

JSON konfiguráció

{
  "autoOpen": {
    "enabled": true,
    "mode": "dismissible",
    "version": 1,
    "worlds": [],
    "delayMs": 1500
  },
  "command": "server-guide",
  "title": "SZERVERÚTMUTATÓ",
  "intro": "Üdv! Jelöld be a Ne jelenjen meg újra lehetőséget, ha a jövőbeli csatlakozásoknál el szeretnéd rejteni ezt az oldalt.",
  "images": [],
  "sections": [
    {
      "title": "ELSŐ LÉPÉSEK",
      "text": "Olvasd el a szabályainkat, és ismerd meg a szervert.",
      "images": []
    }
  ],
  "buttons": []
}

pages/hu-HU/server-guide.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

SZERVERÚTMUTATÓ

Üdv! Jelöld be a Ne jelenjen meg újra lehetőséget, ha a jövőbeli csatlakozásoknál el szeretnéd rejteni ezt az oldalt.

ELSŐ LÉPÉSEK

Olvasd el a szabályainkat, és ismerd meg a szervert.

Az autoOpen beállítást ennek az oldalnak a fallback nyelvű változatán konfiguráld. Ugyanarra a világra ne engedélyezz átfedő AutoOpen oldalakat: ha több oldal is illeszkedik, egyik sem nyílik meg automatikusan.

10Konfigurációs JSON

Beépített oktatóoldalak engedélyezése

A betöltött nyelveket attól függetlenül válaszd ki, hogy mely nyelvekhez készülnek demóoldalak.

JSON konfiguráció

{
  "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

Vizuális eredménySematikus előnézet

Nyelvi beállítások

en-USBetöltve · Demo ON

it-ITBetöltve · Demo OFF

de-DEBetöltve · Demo OFF

A kliens nyelve választja ki az oldal fordítását; hiányzó fordítás esetén a beállított fallback nyelv használatos.

A Full kiadás 25 nyelvi mappát tartalmaz. Egy nyelv oktatóoldalainak generálásához az enabled és demo értékének is true-nak kell lennie. Állítsd a demo értékét false-ra, amikor már nincs rá szükség.

FEJEZET 02 · 5 PÉLDÁK

Bal és jobb oldalsáv

Adj hozzá egy vagy mindkét független oldalsávot, rögzített fejlécet és vegyes navigációs elemeket.

Automatikus PRIMARY kiemelés a megnyitott oldalhoz

A leftContent és rightContent esetén is automatikusan primary állapotban jelenik meg az a gomb, amelynek page értéke megegyezik a megnyitott oldal command értékével. Nem kell megadnod a "style": "primary" beállítást. Az alábbi példák ezt arany színnel mutatják. A többi gomb megtartja a beállított stílusát.

Csak az egyező oldal-célok kapnak automatikus kiemelést: egy szülőkategória vagy a másik oldalsáv nem kapcsolódó gombja nem lesz automatikusan kijelölve. Ha egy ilyen gombot egy másik oldalon is kiemelve szeretnél tartani, használd kifejezetten a "style": "primary" beállítást annak az oldalnak a JSON-jában.

01Oldal JSON

Bal oldali navigációs sáv

Hozz létre külön görgethető bal oldalsávot oldalhivatkozásokkal és szöveges fejlécekkel. Az aktív oldal gombja automatikusan primary kiemelést kap.

JSON konfiguráció

{
  "command": "help-index",
  "title": "SÚGÓKÖZPONT",
  "intro": "A bal oldali menüvel böngészheted az információkat.",
  "images": [],
  "sections": [
    {
      "title": "VÁLASSZ TÉMÁT",
      "text": "Az oldalak a felület bezárása nélkül hivatkozhatnak egymásra.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "INFORMÁCIÓ"
    },
    {
      "type": "button",
      "text": "SÚGÓKÖZPONT",
      "page": "help-index"
    },
    {
      "type": "button",
      "text": "ÜDVÖZLÜNK",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "SZABÁLYOK",
      "page": "rules"
    },
    {
      "type": "button",
      "text": "SÚGÓ",
      "command": "help",
      "runAs": "player"
    }
  ],
  "buttons": []
}

pages/hu-HU/help-index.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

bal oldalsáv

INFORMÁCIÓ

SÚGÓKÖZPONT

ÜDVÖZLÜNK

SZABÁLYOK

SÚGÓ

SÚGÓKÖZPONT

A bal oldali menüvel böngészheted az információkat.

VÁLASSZ TÉMÁT

Az oldalak a felület bezárása nélkül hivatkozhatnak egymásra.

A HELP CENTER ennek az oldalnak a parancsára (help-index) mutat, ezért style mező nélkül is primary lesz. Minden fordításban azonos page célokat használj.

02Oldal JSON

Jobb oldalsáv

A rightContent használható altémákhoz vagy környezetfüggő műveletlistához. Az aktív oldal kiemelése jobb oldalon is működik.

JSON konfiguráció

{
  "command": "guide-topic",
  "title": "ÚTMUTATÓ TÉMÁJA",
  "intro": "A kiegészítő navigáció jobb oldalon található.",
  "images": [],
  "sections": [
    {
      "title": "FŐ CIKK",
      "text": "A fő tartalmat tartsd középen.",
      "images": []
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "TÉMÁK"
    },
    {
      "type": "button",
      "text": "AKTUÁLIS TÉMA",
      "page": "guide-topic"
    },
    {
      "type": "button",
      "text": "PARANCSOK",
      "page": "shortcuts"
    }
  ],
  "buttons": []
}

pages/hu-HU/guide-topic.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

ÚTMUTATÓ TÉMÁJA

A kiegészítő navigáció jobb oldalon található.

FŐ CIKK

A fő tartalmat tartsd középen.

jobb oldalsáv

TÉMÁK

AKTUÁLIS TÉMA

PARANCSOK

A CURRENT TOPIC automatikusan primary lesz, mert a page célja megegyezik a guide-topic értékkel. Kézi style nem szükséges; az oldalsávok egymástól függetlenül görgethetők.

03Oldal JSON

Mindkét oldalsáv együtt

Kombináld a független bal és jobb navigációt a központi oldal szerkezetének módosítása nélkül.

JSON konfiguráció

{
  "command": "server-manual",
  "title": "SZERVERKÉZIKÖNYV",
  "intro": "Navigálj kategória és altéma szerint.",
  "images": [],
  "sections": [
    {
      "title": "AKTUÁLIS TÉMA",
      "text": "A központi terület a fő információk számára marad.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "button",
      "text": "BEVEZETÉS",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "SZABÁLYOK",
      "page": "rules"
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "GYORSHIVATKOZÁSOK"
    },
    {
      "type": "button",
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player"
    },
    {
      "type": "button",
      "text": "WEBOLDAL",
      "command": "https://example.org"
    }
  ],
  "buttons": []
}

pages/hu-HU/server-manual.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

bal oldalsáv

BEVEZETÉS

SZABÁLYOK

SZERVERKÉZIKÖNYV

Navigálj kategória és altéma szerint.

AKTUÁLIS TÉMA

A központi terület a fő információk számára marad.

jobb oldalsáv

GYORSHIVATKOZÁSOK

SPAWN

WEBOLDAL

Minden oldalsávba legfeljebb 24 vegyes elem helyezhető el a JSON-ban megadott sorrendben.

04Oldal JSON

Rögzített képek az oldalsávok felett

Adj rögzített fejléc-képet külön-külön bármelyik oldalsávhoz.

JSON konfiguráció

{
  "command": "branded-menu",
  "title": "MÁRKÁZOTT NAVIGÁCIÓ",
  "intro": "Az oldalsáv-fejlécek láthatók maradnak, miközben az elemek görgethetők.",
  "images": [],
  "sections": [
    {
      "title": "ÜDVÖZLÜNK",
      "text": "Próbáld ki az egyik vagy mindkét rögzített oldalsáv-fejlécet.",
      "images": []
    }
  ],
  "leftHeaderImage": {
    "image": "left-logo.png",
    "page": "welcome"
  },
  "leftContent": [
    {
      "type": "button",
      "text": "KEZDŐLAP",
      "page": "welcome"
    }
  ],
  "rightHeaderImage": {
    "image": "right-logo.png"
  },
  "rightContent": [
    {
      "type": "button",
      "text": "SZABÁLYOK",
      "page": "rules"
    }
  ],
  "buttons": []
}

pages/hu-HU/branded-menu.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

bal oldalsáv

left-logo.png

KEZDŐLAP

MÁRKÁZOTT NAVIGÁCIÓ

Az oldalsáv-fejlécek láthatók maradnak, miközben az elemek görgethetők.

ÜDVÖZLÜNK

Próbáld ki az egyik vagy mindkét rögzített oldalsáv-fejlécet.

jobb oldalsáv

right-logo.png

SZABÁLYOK

Helyezd a left-logo.png és right-logo.png fájlokat a mods/MenuInfoPages/images/ mappába. Minden oldalsáv-fejléc opcionális page vagy command műveletet fogadhat.

05Oldal JSON

Vegyes szöveg, képek és gombok

Szabadon rendezd a szöveget, kattintható képeket és navigációs gombokat bármelyik oldalsávban.

JSON konfiguráció

{
  "command": "player-panel",
  "title": "JÁTÉKOSPANEL",
  "intro": "Az oldalsávok három elemtípust keverhetnek.",
  "images": [],
  "sections": [
    {
      "title": "ÁTTEKINTÉS",
      "text": "Üdv újra, {player}!",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "{center}{b}PROFILOD{/}"
    },
    {
      "type": "image",
      "image": "profile.png",
      "command": "profile",
      "runAs": "player",
      "close": true,
      "delayMs": 250
    },
    {
      "type": "text",
      "text": "Játékos: {player}"
    },
    {
      "type": "button",
      "text": "KEZDŐLAP",
      "page": "welcome"
    }
  ],
  "buttons": []
}

pages/hu-HU/player-panel.json

Vizuális eredménySematikus előnézet

MENUINFOPAGES · SÉMA×

bal oldalsáv

PROFILOD{/}

profile.png

Játékos: Alex

KEZDŐLAP

JÁTÉKOSPANEL

Az oldalsávok három elemtípust keverhetnek.

ÁTTEKINTÉS

Üdv újra, Alex!

A Full jelenlegi oldalsáv-tömbjei a leftContent/rightContent. A jövőbeli egységes content/cells séma nem része ennek az útmutatónak.

FEJEZET 03 · 4 PÉLDÁK

O-Key & HUD

Hozz létre gyorselérési parancsokat, helyezd el az indikátoraikat, és állítsd be világonként a működést.

01Konfigurációs JSON

Globális O-Key gyorsbillentyű

Állítsd be az alapértelmezett parancsot, jogosultságokat és HUD-jelzőt minden világhoz.

JSON konfiguráció

{
  "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

Vizuális eredménySematikus előnézet

O-Key · szemléltető HUD

Játékképernyő ábrázolása

HUD pozíció: right:-8, top:245. A parancsok és a működés a config.json fájlban állíthatók be.

A meglévő O-Key objektumot szerkeszd a teljes config.json cseréje helyett. A HUD-kép default értéke a beépített ikonra utal.

02Konfigurációs JSON

O-Key HUD középre igazítása

A center értéket bármely tengelyen önállóan használhatod; a másik tengelyt egy élhez viszonyítva állítsd be.

JSON konfiguráció

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

config.json — O-Key.AllWorlds.Hud

Vizuális eredménySematikus előnézet

O-Key · szemléltető HUD

Játékképernyő ábrázolása

HUD pozíció: center, top:190. A parancsok és a működés a config.json fájlban állíthatók be.

Ez egy részleges Hud objektum; illeszd ezeket az értékeket a meglévő O-Key.AllWorlds.Hud beállításaidba.

03Konfigurációs JSON

Világ- és instance-felülírások

Adj másik gyorsbillentyűt adott világoknak, beleértve a végső wildcardot használó generált instance-okat is.

JSON konfiguráció

{
  "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

Vizuális eredménySematikus előnézet

O-Key · szemléltető HUD

Játékképernyő ábrázolása

Survival → /welcome

instance-Forgotten_Temple-* → /server-guide

Egyetlen lezáró * támogatott a világnév előtagjában. A pontos nevek elsőbbséget élveznek a wildcard mintákkal szemben; egyébként a leghosszabb egyező előtag nyer.

04Konfigurációs JSON

Egyedi O-Key kép

Használj saját PNG-t konfigurálható mérettel és pozícióval.

JSON konfiguráció

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

config.json — O-Key.AllWorlds.Hud

Vizuális eredménySematikus előnézet

O-Key · szemléltető HUD

Játékképernyő ábrázolása

HUD pozíció: right:-5, top:138. A parancsok és a működés a config.json fájlban állíthatók be.

Helyezd az okey-survival.png fájlt a mods/MenuInfoPages/images/ mappába. A Width/Height értékeket igazítsd a PNG képarányához, például 600×400 megjelenítve 300×200-ként.

FEJEZET 04 · 2 PÉLDÁK

ItemCommands

Hozz létre tárgyakat külön bal- és jobbkattintás-paranccsal.

01Konfigurációs JSON

Demó tárgy engedélyezése

A beépített példa interaktív forrástárgyat biztosít külön bal- és jobbkattintásos művelettel.

JSON konfiguráció

{
  "itemCommands": {
    "enabled": true,
    "items": [
      {
        "id": "demo",
        "sourceItem": "MenuInfoPages_Demo_Grimoire_Source",
        "name": "Demóoldalak",
        "quality": "",
        "leftClickCommand": "menuinfopages",
        "rightClickCommand": "menuinfopages"
      }
    ]
  }
}

config.json — itemCommands object

Vizuális eredménySematikus előnézet

ItemCommands · interakciós térkép

Demóoldalak

Bal kattintás/menuinfopages

Jobb kattintás/menuinfopages

Ez a beépített példa tényleges forrástárgy-azonosítója. Az oldalmódosításokkal ellentétben a strukturális tárgymódosítások szerver-újraindítást igényelhetnek.

02Konfigurációs JSON

Külön bal és jobb parancsok

Használj meglévő Hytale- vagy telepített modtárgyat egy új interaktív gyorsbillentyű forrásaként.

JSON konfiguráció

{
  "itemCommands": {
    "enabled": true,
    "items": [
      {
        "id": "server-shortcuts",
        "sourceItem": "MenuInfoPages_Demo_Grimoire_Source",
        "name": "Szervergyorsbillentyűk",
        "quality": "",
        "leftClickCommand": "welcome",
        "rightClickCommand": "spawn"
      }
    ]
  }
}

config.json — itemCommands object

Vizuális eredménySematikus előnézet

ItemCommands · interakciós térkép

Szervergyorsbillentyűk

Bal kattintás/welcome

Jobb kattintás/spawn

Cseréld a sourceItem értékét egy valódi, a szervereden telepített tárgyazonosítóra, és válassz létező, játékosok számára elérhető parancsokat. Az ItemCommands független az oldal JSON-jától.

Példa használata előtt

Teljes oldal-példák: Minden JSON-objektumot külön fájlba helyezz a mods/MenuInfoPages/pages/hu-HU/ alatt. Minden oldal parancsa legyen egyedi, és szükség esetén fordítsd le a megfelelő oldalfájlokat a többi nyelvi mappában.

Konfigurációs példák: Az O-Key és ItemCommands objektumok a meglévő config.json részletei. Illeszd a bemutatott tulajdonságokat a megfelelő helyre; soha ne cseréld le a teljes konfigurációs fájlt egy kis példára.

Biztonságos konfiguráció: A hivatkozott PNG-ket a megfelelő képmappába helyezd. A jobb teljesítmény érdekében ajánlott, de nem kötelező az egyes képeket 2 MB alatt tartani; a nagyobb fájlok több betöltési időt és memóriát igényelhetnek. A demóparancsok, navigációs célok, jogosultsági csomópontok és külső URL-ek a saját erőforrásaid helyőrzői. Ne futtass emelt jogosultságú parancsokat nem megbízható játékosok számára.

Jelenlegi séma: Ez az útmutató a jelenlegi sections, leftContent és rightContent rendszert dokumentálja; egy esetleges jövőbeli egységes content/cells modell nem jelenik meg kész, kiadott funkcióként.

VISSZA A TETEJÉRE