HyTari Studios · Virallinen visuaalinen opas

Menu Info Pages

Opi JSON näkemällä lopputulos.

Käytännönläheinen visuaalinen ohje MenuInfoPagesin määrittämiseen. Aloita keski-ikkunasta, rakenna navigointi sivupalkeille ja mukauta sitten O-Key-pikavalinnat ja interaktiiviset esineet. Jokainen esimerkki sisältää kopioitavan JSONin ja yksinkertaistetun esityksen lopputuloksesta.

ALOITA OPAS MODIN SIVU

Lue tämä ensin

Aloittaminen

VAIHE 01

Ota opastukset käyttöön

Aseta tiedostossa config.json arvot languages.fi-FI.enabled ja demo arvoon true. Full-paketti sisältää opastukset 25 kielellä.

VAIHE 02

Luo sivu

Käytä komentoa /infopages newpage <name> <command> tai luo JSON-tiedosto kansioon mods/MenuInfoPages/pages/fi-FI/.

VAIHE 03

Lataa uudelleen ja testaa

Suorita /infopages reload sisällön tai kuvien muutosten jälkeen. Uusi pelaajakomento tai rakenteellinen ItemCommands-muutos voi vaatia uudelleenkäynnistyksen.

Nämä esimerkit perustuvat nykyisen Full-version mukana tuleviin JSON-määrityksiin ja opastustiedostoihin. Esikatselut ovat havainnollistavia kaavioita, eivät kuvakaappauksia tai Hytalen natiivia käyttöliittymärenderöintiä. Korvaa esimerkkikomennot, kohteet ja PNG-nimet palvelimellasi olevilla resursseilla. Säilytä varmuuskopio olemassa olevista tiedostoista.

LUKU 01 · 10 ESIMERKKIÄ

Keskeinen GUI

Aloita itse sivusta: teksti, osiot, kuvat, painikkeet, oikeudet ja AutoOpen.

01Sivun JSON

Ensimmäinen sivusi

Yksi JSON-tiedosto luo sivun omalla komennolla, otsikolla ja johdannolla.

JSON-määritys

{
  "command": "welcome",
  "title": "TERVETULOA PALVELIMELLEMME",
  "intro": "Hei {player}! Tässä on kaikki, mitä tarvitset aloittamiseen.",
  "images": [],
  "sections": [
    {
      "title": "ALOITTAMINEN",
      "text": "Lue säännöt, etsi paikka rakentamiselle ja nauti seikkailusta!",
      "images": []
    }
  ],
  "buttons": [],
  "footer": "Mukavaa peliä!"
}

pages/fi-FI/welcome.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

TERVETULOA PALVELIMELLEMME

Hei Alex! Tässä on kaikki, mitä tarvitset aloittamiseen.

ALOITTAMINEN

Lue säännöt, etsi paikka rakentamiselle ja nauti seikkailusta!

Mukavaa peliä!

Tiedostonimi voi poiketa komennosta. Uudet pelaajakomennot voivat vaatia palvelimen uudelleenkäynnistyksen luomisen jälkeen.

02Sivun JSON

Muotoiltu teksti ja paikkamerkit

Muotoile tekstiä ja lisää dynaamisia tietoja pelaajasta ja palvelimesta.

JSON-määritys

{
  "command": "player-info",
  "title": "PELAAJAN TIEDOT",
  "intro": "{center}{#54DAF4}{b}Tervetuloa takaisin, {player}!{/}{/}",
  "images": [],
  "sections": [
    {
      "title": "{#F894FF}{b}TIETOSI{/}{/}",
      "text": "{b}Pelaaja:{/} {player}\n{b}Maailma:{/} {world}\n{b}Online:{/} {online}/{max_players}\n{m}Hyödyllisiä palvelintietoja{/}",
      "images": []
    }
  ],
  "buttons": []
}

pages/fi-FI/player-info.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

PELAAJAN TIEDOT

Tervetuloa takaisin, Alex!{/}{/}

TIETOSI{/}{/}

Pelaaja:{/} Alex Maailma:{/} Survival Online:{/} 12/256 Hyödyllisiä palvelintietoja{/}

Muotoiltu teksti renderöidään Hytalessa. Kaaviomainen esikatselu poistaa muotoilutunnisteet sen sijaan, että se jäljittelisi natiivia fonttirenderöintiä.

03Sivun JSON

Osioiden taustavärit

Yhdistä samassa valikossa tavallisia, läpinäkyviä ja HEX-värisiä osioita.

JSON-määritys

{
  "command": "colors",
  "title": "MUKAUTETUT OSIOT",
  "intro": "Valitse visuaalinen tyyli jokaiselle sisältöalueelle.",
  "images": [],
  "sections": [
    {
      "title": "OLETUS",
      "text": "Natiivi osiotyyli.",
      "backgroundColor": "default",
      "images": []
    },
    {
      "title": "LÄPINÄKYVÄ",
      "text": "Taustapaneeli poistetaan.",
      "backgroundColor": "none",
      "images": []
    },
    {
      "title": "MUKAUTETTU HEX",
      "text": "Mukautettu osion väri.",
      "backgroundColor": "#243D59",
      "images": []
    }
  ],
  "buttons": []
}

pages/fi-FI/colors.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

MUKAUTETUT OSIOT

Valitse visuaalinen tyyli jokaiselle sisältöalueelle.

OLETUS

Natiivi osiotyyli.

LÄPINÄKYVÄ

Taustapaneeli poistetaan.

MUKAUTETTU HEX

Mukautettu osion väri.

Käytä backgroundColor-arvoa yksittäisessä osiossa, ei koko sivulla.

04Sivun JSON

Kiinteä johdanto ja otsakekuvat

Johdanto ja enintään kuusi kuvaa pysyvät vieritettävien osioiden yläpuolella.

JSON-määritys

{
  "command": "header",
  "title": "YHTEISÖMME",
  "intro": "{center}Tutustu palvelimeen ja sen ominaisuuksiin.",
  "images": [
    {
      "image": "server-logo.png"
    },
    {
      "image": "welcome-banner.png"
    }
  ],
  "sections": [
    {
      "title": "VIERITETTÄVÄ SISÄLTÖ",
      "text": "Tätä osiota vieritetään, kun taas johdanto ja otsakekuvat pysyvät näkyvissä.",
      "images": []
    }
  ],
  "buttons": []
}

pages/fi-FI/header.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

YHTEISÖMME

Tutustu palvelimeen ja sen ominaisuuksiin.

server-logo.png

welcome-banner.png

VIERITETTÄVÄ SISÄLTÖ

Tätä osiota vieritetään, kun taas johdanto ja otsakekuvat pysyvät näkyvissä.

Sijoita server-logo.png ja welcome-banner.png kansioon mods/MenuInfoPages/images/ ennen sivun avaamista. Käytä PNG-tiedostoja; nopeamman latauksen vuoksi yksittäiset tiedostot kannattaa pitää alle 2 Mt:n kokoisina, mutta se ei ole pakollista.

05Sivun JSON

Useita kuvia yhdessä osiossa

Sijoita osioon enintään kuusi kuvaa. Ne jaetaan samanlevyisiin vaakasuuntaisiin soluihin.

JSON-määritys

{
  "command": "places",
  "title": "KÄYNTIKOHTEET",
  "intro": "Valitse kohde.",
  "images": [],
  "sections": [
    {
      "title": "KOHTEET",
      "text": "Valitse, minne haluat mennä.",
      "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/fi-FI/places.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

KÄYNTIKOHTEET

Valitse kohde.

KOHTEET

Valitse, minne haluat mennä.

spawn.png

market.png

website.png

Jokainen tiedostonimi vastaa PNG-tiedostoa, jonka lisäät kansioon mods/MenuInfoPages/images/.

06Sivun JSON

Painikkeet osion sisällä

Anna osiolle omat interaktiiviset primary-, secondary- ja danger-toiminnot.

JSON-määritys

{
  "command": "section-actions",
  "title": "HYÖDYLLISET KOMENNOT",
  "intro": "Eri painiketyylit helpottavat toimintojen tunnistamista.",
  "images": [],
  "sections": [
    {
      "title": "NAVIGOINTI",
      "text": "Osio voi sisältää tekstiä, kuvia ja painikkeita.",
      "images": [],
      "buttons": [
        {
          "text": "SPAWN",
          "command": "spawn",
          "runAs": "player",
          "close": true,
          "delayMs": 250,
          "style": "primary"
        },
        {
          "text": "PALVELIMEN SÄÄNNÖT",
          "page": "rules",
          "style": "secondary"
        },
        {
          "text": "DANGER-ESIMERKKI",
          "style": "danger"
        }
      ]
    }
  ],
  "buttons": []
}

pages/fi-FI/section-actions.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

HYÖDYLLISET KOMENNOT

Eri painiketyylit helpottavat toimintojen tunnistamista.

NAVIGOINTI

Osio voi sisältää tekstiä, kuvia ja painikkeita.

SPAWN

PALVELIMEN SÄÄNNÖT

DANGER-ESIMERKKI

Käytä page-arvoa toisen MenuInfoPages-sivun avaamiseen suoraan. Käytä command-arvoa komentojen suorittamiseen; runAs: console -asetusta tulee käyttää vain luotetuissa toiminnoissa.

07Sivun JSON

Alareunan toimintopalkki

Sijoita alareunaan enintään kuusi toimintoa erilleen vieritettävistä osioista.

JSON-määritys

{
  "command": "shortcuts",
  "title": "PIKATOIMINNOT",
  "intro": "Yleiset pikavalinnat yhdessä paikassa.",
  "images": [],
  "sections": [
    {
      "title": "OHJE",
      "text": "Valitse toiminto alta.",
      "images": []
    }
  ],
  "buttons": [
    {
      "text": "SÄÄNNÖT",
      "page": "rules",
      "style": "primary"
    },
    {
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player",
      "close": true,
      "delayMs": 250,
      "style": "secondary"
    },
    {
      "text": "VERKKOSIVU",
      "command": "https://example.org",
      "style": "secondary"
    }
  ]
}

pages/fi-FI/shortcuts.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

PIKATOIMINNOT

Yleiset pikavalinnat yhdessä paikassa.

OHJE

Valitse toiminto alta.

SÄÄNNÖT

SPAWN

VERKKOSIVU

Kohteiden, kuten rules tai warp market, on oltava olemassa palvelimellasi. page-kohde on MenuInfoPages-sivun sisäinen komento.

08Sivun JSON

Sivun oikeudet

Lisää valinnainen permission node rajoittaaksesi sivun valtuutetuille käyttäjille.

JSON-määritys

{
  "command": "staff-info",
  "permission": "server.staff",
  "title": "HENKILÖKUNNAN TIEDOT",
  "intro": "Rajoitettua tietoa valtuutetuille pelaajille.",
  "images": [],
  "sections": [
    {
      "title": "HENKILÖKUNNAN MUISTIINPANOT",
      "text": "Vain pelaajat, joilla on server.staff-oikeus, voivat avata tämän sivun.",
      "images": []
    }
  ],
  "buttons": []
}

pages/fi-FI/staff-info.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

HENKILÖKUNNAN TIEDOT

Rajoitettua tietoa valtuutetuille pelaajille.

HENKILÖKUNNAN MUISTIINPANOT

Vain pelaajat, joilla on server.staff-oikeus, voivat avata tämän sivun.

Permission node on esimerkki. Myönnä se palvelimesi oikeusjärjestelmän kautta. AutoOpen huomioi myös sivun oikeudet.

09Sivun JSON

Automaattinen avautuminen liittyessä

Näytä tervetulosivu kerran, aina tai kunnes pelaaja poistaa sen käytöstä.

JSON-määritys

{
  "autoOpen": {
    "enabled": true,
    "mode": "dismissible",
    "version": 1,
    "worlds": [],
    "delayMs": 1500
  },
  "command": "server-guide",
  "title": "PALVELINOPAS",
  "intro": "Tervetuloa! Valitse Älä näytä uudelleen, jos haluat piilottaa tämän sivun tulevilla liittymiskerroilla.",
  "images": [],
  "sections": [
    {
      "title": "ENSIMMÄISET ASKELEET",
      "text": "Lue sääntömme ja tutustu palvelimeen.",
      "images": []
    }
  ],
  "buttons": []
}

pages/fi-FI/server-guide.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

PALVELINOPAS

Tervetuloa! Valitse Älä näytä uudelleen, jos haluat piilottaa tämän sivun tulevilla liittymiskerroilla.

ENSIMMÄISET ASKELEET

Lue sääntömme ja tutustu palvelimeen.

Määritä autoOpen tämän sivun fallback-kieliversiossa. Älä ota käyttöön päällekkäisiä AutoOpen-sivuja samalle maailmalle: jos useampi sivu täsmää, mitään niistä ei avata automaattisesti.

10Määrityksen JSON

Ota mukana tulevat opastukset käyttöön

Valitse ladattavat kielet riippumatta siitä, mille kielille demosivut luodaan.

JSON-määritys

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

Visuaalinen tulosKaaviomainen esikatselu

Kieliasetukset

en-USLadattu · Demo ON

it-ITLadattu · Demo OFF

de-DELadattu · Demo OFF

Asiakkaan kieli valitsee sivun käännöksen; puuttuvissa käännöksissä käytetään määritettyä fallback-kieltä.

Full-versio sisältää 25 kielikansiota. Sekä enabled- että demo-arvon on oltava true, jotta kielen opastussivut luodaan. Aseta demo: false, kun et enää tarvitse niitä.

LUKU 02 · 5 ESIMERKKIÄ

Vasen ja oikea sivupalkki

Lisää yksi tai molemmat itsenäiset sivupalkit, kiinteät otsakkeet ja erilaisia navigointielementtejä.

Avoimen sivun automaattinen PRIMARY-korostus

Sekä leftContent- että rightContent-kohdassa sivupalkin painike näkyy automaattisesti primary-tyylisenä, kun sen page vastaa avoimen sivun command-arvoa. "style": "primary"-asetusta ei tarvitse määrittää. Alla olevissa esimerkeissä tila näkyy kultaisena. Muut painikkeet säilyttävät määritetyn tyylinsä.

Vain vastaavat sivukohteet korostetaan automaattisesti: ylempi kategoria tai vastakkaisen sivupalkin liittymätön painike ei valikoidu automaattisesti. Jos haluat pitää tällaisen painikkeen korostettuna toisella sivulla, käytä sen sivun JSONissa erikseen asetusta "style": "primary".

01Sivun JSON

Vasen navigointisivupalkki

Luo erikseen vieritettävä vasen sivupalkki, jossa on sivulinkkejä ja tekstiotsikoita. Aktiivisen sivun painike korostetaan automaattisesti primary-tyylillä.

JSON-määritys

{
  "command": "help-index",
  "title": "OHJEKESKUS",
  "intro": "Selaa tietoja vasemman valikon avulla.",
  "images": [],
  "sections": [
    {
      "title": "VALITSE AIHE",
      "text": "Sivut voivat linkittää toisiinsa sulkematta käyttöliittymää.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "TIEDOT"
    },
    {
      "type": "button",
      "text": "OHJEKESKUS",
      "page": "help-index"
    },
    {
      "type": "button",
      "text": "TERVETULOA",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "SÄÄNNÖT",
      "page": "rules"
    },
    {
      "type": "button",
      "text": "OHJE",
      "command": "help",
      "runAs": "player"
    }
  ],
  "buttons": []
}

pages/fi-FI/help-index.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

vasen sivupalkki

TIEDOT

OHJEKESKUS

TERVETULOA

SÄÄNNÖT

OHJE

OHJEKESKUS

Selaa tietoja vasemman valikon avulla.

VALITSE AIHE

Sivut voivat linkittää toisiinsa sulkematta käyttöliittymää.

HELP CENTER osoittaa tämän sivun komentoon (help-index), joten se muuttuu primary-tyyliseksi ilman style-kenttää. Käytä samoja page-kohteita kaikissa käännöksissä.

02Sivun JSON

Oikea sivupalkki

Käytä rightContentia ala-aiheisiin tai tilannekohtaiseen toimintoluetteloon. Aktiivisen sivun korostus toimii myös oikealla.

JSON-määritys

{
  "command": "guide-topic",
  "title": "OPPAAN AIHE",
  "intro": "Lisänavigointi on oikealla.",
  "images": [],
  "sections": [
    {
      "title": "PÄÄARTIKKELI",
      "text": "Pidä pääsisältö keskellä.",
      "images": []
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "AIHEET"
    },
    {
      "type": "button",
      "text": "NYKYINEN AIHE",
      "page": "guide-topic"
    },
    {
      "type": "button",
      "text": "KOMENNOT",
      "page": "shortcuts"
    }
  ],
  "buttons": []
}

pages/fi-FI/guide-topic.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

OPPAAN AIHE

Lisänavigointi on oikealla.

PÄÄARTIKKELI

Pidä pääsisältö keskellä.

oikea sivupalkki

AIHEET

NYKYINEN AIHE

KOMENNOT

CURRENT TOPIC muuttuu automaattisesti primary-tyyliseksi, koska sen page-kohde vastaa arvoa guide-topic. Manuaalista style-asetusta ei tarvita; kumpikin sivupalkki vierii itsenäisesti.

03Sivun JSON

Molemmat sivupalkit yhdessä

Yhdistä itsenäinen vasen ja oikea navigointi muuttamatta keskisivun rakennetta.

JSON-määritys

{
  "command": "server-manual",
  "title": "PALVELIMEN KÄSIKIRJA",
  "intro": "Navigoi kategorian ja ala-aiheen mukaan.",
  "images": [],
  "sections": [
    {
      "title": "NYKYINEN AIHE",
      "text": "Keskiosa pysyy pääasiallisten tietojen käytössä.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "button",
      "text": "JOHDANTO",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "SÄÄNNÖT",
      "page": "rules"
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "PIKALINKIT"
    },
    {
      "type": "button",
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player"
    },
    {
      "type": "button",
      "text": "VERKKOSIVU",
      "command": "https://example.org"
    }
  ],
  "buttons": []
}

pages/fi-FI/server-manual.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

vasen sivupalkki

JOHDANTO

SÄÄNNÖT

PALVELIMEN KÄSIKIRJA

Navigoi kategorian ja ala-aiheen mukaan.

NYKYINEN AIHE

Keskiosa pysyy pääasiallisten tietojen käytössä.

oikea sivupalkki

PIKALINKIT

SPAWN

VERKKOSIVU

Kumpaankin sivupalkkiin voidaan sijoittaa enintään 24 erilaista elementtiä JSONissa kirjoitetussa järjestyksessä.

04Sivun JSON

Kiinteät kuvat sivupalkkien yläpuolella

Lisää kiinteä otsakekuva erikseen kumpaankin sivupalkkiin.

JSON-määritys

{
  "command": "branded-menu",
  "title": "BRÄNDÄTTY NAVIGOINTI",
  "intro": "Sivupalkkien otsakkeet pysyvät näkyvissä, kun niiden sisältöä vieritetään.",
  "images": [],
  "sections": [
    {
      "title": "TERVETULOA",
      "text": "Kokeile yhtä tai molempia kiinteitä sivupalkkiotsakkeita.",
      "images": []
    }
  ],
  "leftHeaderImage": {
    "image": "left-logo.png",
    "page": "welcome"
  },
  "leftContent": [
    {
      "type": "button",
      "text": "ETUSIVU",
      "page": "welcome"
    }
  ],
  "rightHeaderImage": {
    "image": "right-logo.png"
  },
  "rightContent": [
    {
      "type": "button",
      "text": "SÄÄNNÖT",
      "page": "rules"
    }
  ],
  "buttons": []
}

pages/fi-FI/branded-menu.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

vasen sivupalkki

left-logo.png

ETUSIVU

BRÄNDÄTTY NAVIGOINTI

Sivupalkkien otsakkeet pysyvät näkyvissä, kun niiden sisältöä vieritetään.

TERVETULOA

Kokeile yhtä tai molempia kiinteitä sivupalkkiotsakkeita.

oikea sivupalkki

right-logo.png

SÄÄNNÖT

Sijoita left-logo.png ja right-logo.png kansioon mods/MenuInfoPages/images/. Kummankin sivupalkin otsake hyväksyy valinnaisen page- tai command-toiminnon.

05Sivun JSON

Sekoitettu teksti, kuvat ja painikkeet

Järjestä teksti, klikattavat kuvat ja navigointipainikkeet vapaasti kummassa tahansa sivupalkissa.

JSON-määritys

{
  "command": "player-panel",
  "title": "PELAAJAPANEELI",
  "intro": "Sivupalkeissa voidaan yhdistää kolmea elementtityyppiä.",
  "images": [],
  "sections": [
    {
      "title": "YLEISKATSAUS",
      "text": "Tervetuloa takaisin, {player}!",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "{center}{b}PROFIILISI{/}"
    },
    {
      "type": "image",
      "image": "profile.png",
      "command": "profile",
      "runAs": "player",
      "close": true,
      "delayMs": 250
    },
    {
      "type": "text",
      "text": "Pelaaja: {player}"
    },
    {
      "type": "button",
      "text": "ETUSIVU",
      "page": "welcome"
    }
  ],
  "buttons": []
}

pages/fi-FI/player-panel.json

Visuaalinen tulosKaaviomainen esikatselu

MENUINFOPAGES · KAAVIO×

vasen sivupalkki

PROFIILISI{/}

profile.png

Pelaaja: Alex

ETUSIVU

PELAAJAPANEELI

Sivupalkeissa voidaan yhdistää kolmea elementtityyppiä.

YLEISKATSAUS

Tervetuloa takaisin, Alex!

Full-version nykyiset sivupalkkitaulukot ovat leftContent/rightContent. Tuleva yhtenäinen content/cells-rakenne ei kuulu tähän oppaaseen.

LUKU 03 · 4 ESIMERKKIÄ

O-Key & HUD

Luo pikavalintoja, sijoita niiden ilmaisimet ja määritä toiminta maailmakohtaisesti.

01Määrityksen JSON

Globaali O-Key-pikavalinta

Aseta oletuskomento, oikeudet ja HUD-ilmaisin jokaiselle maailmalle.

JSON-määritys

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

Visuaalinen tulosKaaviomainen esikatselu

O-Key · havainnollistava HUD

Peliruudun esitys

HUD-sijainti: right:-8, top:245. Komennot ja toiminta määritetään tiedostossa config.json.

Muokkaa olemassa olevaa O-Key-objektia sen sijaan, että korvaisit koko config.json-tiedoston. HUD-kuvan default-arvo viittaa mukana tulevaan kuvakkeeseen.

02Määrityksen JSON

Keskitä O-Key-HUD

Käytä center-arvoa itsenäisesti kummalla tahansa akselilla ja säädä toinen akseli reunasta.

JSON-määritys

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

config.json — O-Key.AllWorlds.Hud

Visuaalinen tulosKaaviomainen esikatselu

O-Key · havainnollistava HUD

Peliruudun esitys

HUD-sijainti: center, top:190. Komennot ja toiminta määritetään tiedostossa config.json.

Tämä esimerkki on osittainen Hud-objekti; yhdistä arvot olemassa oleviin O-Key.AllWorlds.Hud-asetuksiisi.

03Määrityksen JSON

Maailma- ja instance-kohtaiset ohitukset

Anna tietyille maailmoille eri pikavalinta, mukaan lukien luodut instancet, joissa käytetään lopussa wildcardia.

JSON-määritys

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

Visuaalinen tulosKaaviomainen esikatselu

O-Key · havainnollistava HUD

Peliruudun esitys

Survival → /welcome

instance-Forgotten_Temple-* → /server-guide

Maailman nimen etuliitteessä tuetaan yhtä lopussa olevaa *-merkkiä. Tarkat nimet ovat wildcard-kuvioita ensisijaisempia; muussa tapauksessa pisin täsmäävä etuliite voittaa.

04Määrityksen JSON

Mukautettu O-Key-kuva

Käytä omaa PNG-kuvaa, jonka kokoa ja sijaintia voi säätää.

JSON-määritys

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

config.json — O-Key.AllWorlds.Hud

Visuaalinen tulosKaaviomainen esikatselu

O-Key · havainnollistava HUD

Peliruudun esitys

HUD-sijainti: right:-5, top:138. Komennot ja toiminta määritetään tiedostossa config.json.

Sijoita okey-survival.png kansioon mods/MenuInfoPages/images/. Sovita Width/Height PNG:n kuvasuhteeseen, esimerkiksi 600×400 renderöitynä kokoon 300×200.

LUKU 04 · 2 ESIMERKKIÄ

ItemCommands

Luo esineitä, joilla on erilliset komennot vasemmalle ja oikealle napsautukselle.

01Määrityksen JSON

Ota demoesine käyttöön

Mukana tuleva esimerkki tarjoaa interaktiivisen lähde-esineen erillisillä vasemman ja oikean napsautuksen toiminnoilla.

JSON-määritys

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

config.json — itemCommands object

Visuaalinen tulosKaaviomainen esikatselu

ItemCommands · toimintokartta

Demosivut

Vasen napsautus/menuinfopages

Oikea napsautus/menuinfopages

Tämä on mukana tulevan esimerkin todellinen lähde-esineen ID. Toisin kuin sivumuutokset, rakenteelliset esinemuutokset voivat vaatia palvelimen uudelleenkäynnistyksen.

02Määrityksen JSON

Erilliset vasemman ja oikean komennot

Käytä olemassa olevaa Hytale-esinettä tai asennetun modin esinettä uuden interaktiivisen pikavalinnan lähteenä.

JSON-määritys

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

config.json — itemCommands object

Visuaalinen tulosKaaviomainen esikatselu

ItemCommands · toimintokartta

Palvelimen pikavalinnat

Vasen napsautus/welcome

Oikea napsautus/spawn

Korvaa sourceItem palvelimellesi asennetun todellisen esineen ID:llä ja valitse olemassa olevat komennot, joihin pelaajilla on pääsy. ItemCommands toimii riippumatta sivun JSONista.

Ennen esimerkin käyttöä

Täydelliset sivuesimerkit: Sijoita jokainen JSON-objekti omaan tiedostoonsa kansioon mods/MenuInfoPages/pages/fi-FI/. Pidä jokaisen sivun komento yksilöllisenä ja käännä vastaavat sivutiedostot muihin kielikansioihin tarvittaessa.

Määritysesimerkit: O-Key- ja ItemCommands-objektit ovat osia olemassa olevasta config.json-tiedostostasi. Yhdistä esitetyt ominaisuudet oikeaan kohtaan; älä koskaan korvaa koko määritystiedostoa pienellä esimerkillä.

Turvallinen määritys: Sijoita viitatut PNG-kuvat niille tarkoitettuun kuvakansioon. Parhaan suorituskyvyn vuoksi yksittäiset kuvat kannattaa pitää alle 2 Mt:n kokoisina, mutta se ei ole pakollista; suuremmat tiedostot voivat vaatia enemmän latausaikaa ja muistia. Demokomennot, sivunavigoinnin kohteet, permission nodet ja ulkoiset URL-osoitteet ovat paikkamerkkejä omille resursseillesi. Vältä korotettujen komentojen suorittamista epäluotettaville pelaajille.

Nykyinen rakenne: Tämä opas dokumentoi nykyisen sections-, leftContent- ja rightContent-järjestelmän; mahdollista tulevaa yhtenäistä content/cells-mallia ei esitetä julkaistuna ominaisuutena.

TAKAISIN YLÖS