HyTari Studios · Guida visuale ufficiale

Menu Info Pages

Impara il JSON vedendone il risultato.

Un riferimento visuale pratico per configurare MenuInfoPages. Parti dalla finestra centrale, costruisci la navigazione nelle barre laterali, poi personalizza le scorciatoie O-Key e gli oggetti interattivi. Ogni esempio include JSON copiabile e una rappresentazione semplificata del risultato.

INIZIA LA GUIDA PAGINA DELLA MOD

Leggi prima questo

Per iniziare

PASSO 01

Abilita i tutorial

In config.json, imposta languages.it-IT.enabled e demo su true. Il pacchetto Full include tutorial in 25 lingue.

PASSO 02

Crea una pagina

Usa /infopages newpage <name> <command> oppure crea un file JSON in mods/MenuInfoPages/pages/it-IT/.

PASSO 03

Ricarica e prova

Esegui /infopages reload dopo modifiche a contenuti o immagini. Un nuovo comando giocatore o una modifica strutturale a ItemCommands può richiedere un riavvio.

Questi esempi si basano sulla configurazione JSON e sui file tutorial inclusi nell’attuale edizione Full. Le anteprime sono diagrammi didattici, non screenshot né rendering nativi dell’interfaccia di Hytale. Sostituisci comandi, destinazioni e nomi PNG di esempio con risorse disponibili sul tuo server. Conserva una copia di sicurezza dei file esistenti.

CAPITOLO 01 · 10 ESEMPI

GUI centrale

Parti dalla pagina: testo, sezioni, immagini, pulsanti, permessi e AutoOpen.

01JSON pagina

La tua prima pagina

Un file JSON crea una pagina con comando, titolo e introduzione propri.

Configurazione JSON

{
  "command": "welcome",
  "title": "BENVENUTO SUL NOSTRO SERVER",
  "intro": "Ciao {player}! Qui trovi tutto ciò che ti serve per iniziare.",
  "images": [],
  "sections": [
    {
      "title": "PER INIZIARE",
      "text": "Leggi il regolamento, trova un posto dove costruire e goditi l’avventura!",
      "images": []
    }
  ],
  "buttons": [],
  "footer": "Buona permanenza!"
}

pages/it-IT/welcome.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

BENVENUTO SUL NOSTRO SERVER

Ciao Alex! Qui trovi tutto ciò che ti serve per iniziare.

PER INIZIARE

Leggi il regolamento, trova un posto dove costruire e goditi l’avventura!

Buona permanenza!

Il nome del file può essere diverso dal comando. I nuovi comandi giocatore possono richiedere un riavvio del server dopo la creazione.

02JSON pagina

Testo formattato e placeholder

Formatta il testo e inserisci informazioni dinamiche del giocatore e del server.

Configurazione JSON

{
  "command": "player-info",
  "title": "INFORMAZIONI GIOCATORE",
  "intro": "{center}{#54DAF4}{b}Bentornato, {player}!{/}{/}",
  "images": [],
  "sections": [
    {
      "title": "{#F894FF}{b}I TUOI DATI{/}{/}",
      "text": "{b}Giocatore:{/} {player}\n{b}Mondo:{/} {world}\n{b}Online:{/} {online}/{max_players}\n{m}Informazioni utili sul server{/}",
      "images": []
    }
  ],
  "buttons": []
}

pages/it-IT/player-info.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

INFORMAZIONI GIOCATORE

Bentornato, Alex!{/}{/}

I TUOI DATI{/}{/}

Giocatore:{/} Alex Mondo:{/} Survival Online:{/} 12/256 Informazioni utili sul server{/}

Il testo formattato viene renderizzato da Hytale. L’anteprima schematica rimuove i token di formattazione invece di replicare il renderer nativo dei caratteri.

03JSON pagina

Colori di sfondo delle sezioni

Combina nello stesso menu sezioni standard, trasparenti e colorate tramite HEX.

Configurazione JSON

{
  "command": "colors",
  "title": "SEZIONI PERSONALIZZATE",
  "intro": "Scegli un aspetto visivo per ogni area di contenuto.",
  "images": [],
  "sections": [
    {
      "title": "PREDEFINITO",
      "text": "Stile nativo della sezione.",
      "backgroundColor": "default",
      "images": []
    },
    {
      "title": "TRASPARENTE",
      "text": "Il pannello di sfondo viene rimosso.",
      "backgroundColor": "none",
      "images": []
    },
    {
      "title": "HEX PERSONALIZZATO",
      "text": "Un colore personalizzato per la sezione.",
      "backgroundColor": "#243D59",
      "images": []
    }
  ],
  "buttons": []
}

pages/it-IT/colors.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

SEZIONI PERSONALIZZATE

Scegli un aspetto visivo per ogni area di contenuto.

PREDEFINITO

Stile nativo della sezione.

TRASPARENTE

Il pannello di sfondo viene rimosso.

HEX PERSONALIZZATO

Un colore personalizzato per la sezione.

Usa backgroundColor sulla singola sezione, non sull’intera pagina.

04JSON pagina

Introduzione e immagini di intestazione fisse

Un’introduzione e fino a sei immagini rimangono sopra le sezioni scorrevoli.

Configurazione JSON

{
  "command": "header",
  "title": "LA NOSTRA COMMUNITY",
  "intro": "{center}Esplora il server e le sue funzionalità.",
  "images": [
    {
      "image": "server-logo.png"
    },
    {
      "image": "welcome-banner.png"
    }
  ],
  "sections": [
    {
      "title": "CONTENUTO SCORREVOLE",
      "text": "Questa sezione scorre mentre introduzione e immagini di intestazione rimangono visibili.",
      "images": []
    }
  ],
  "buttons": []
}

pages/it-IT/header.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

LA NOSTRA COMMUNITY

Esplora il server e le sue funzionalità.

server-logo.png

welcome-banner.png

CONTENUTO SCORREVOLE

Questa sezione scorre mentre introduzione e immagini di intestazione rimangono visibili.

Inserisci server-logo.png e welcome-banner.png in mods/MenuInfoPages/images/ prima di aprire la pagina. Sono supportati file PNG; per un caricamento più rapido è consigliato, ma non obbligatorio, mantenere ogni file sotto i 2 MB.

05JSON pagina

Più immagini in una sezione

Inserisci fino a sei immagini in una sezione. Vengono distribuite in celle orizzontali di uguale dimensione.

Configurazione JSON

{
  "command": "places",
  "title": "LUOGHI DA VISITARE",
  "intro": "Scegli una destinazione.",
  "images": [],
  "sections": [
    {
      "title": "DESTINAZIONI",
      "text": "Scegli dove vuoi andare.",
      "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/it-IT/places.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

LUOGHI DA VISITARE

Scegli una destinazione.

DESTINAZIONI

Scegli dove vuoi andare.

spawn.png

market.png

website.png

Ogni nome file rappresenta un PNG fornito da te nella cartella mods/MenuInfoPages/images/.

06JSON pagina

Pulsanti dentro una sezione

Assegna a una sezione azioni interattive primary, secondary e danger.

Configurazione JSON

{
  "command": "section-actions",
  "title": "COMANDI UTILI",
  "intro": "Stili diversi dei pulsanti rendono le azioni facili da riconoscere.",
  "images": [],
  "sections": [
    {
      "title": "NAVIGAZIONE",
      "text": "Una sezione può contenere testo, immagini e pulsanti.",
      "images": [],
      "buttons": [
        {
          "text": "SPAWN",
          "command": "spawn",
          "runAs": "player",
          "close": true,
          "delayMs": 250,
          "style": "primary"
        },
        {
          "text": "REGOLAMENTO SERVER",
          "page": "rules",
          "style": "secondary"
        },
        {
          "text": "ESEMPIO DANGER",
          "style": "danger"
        }
      ]
    }
  ],
  "buttons": []
}

pages/it-IT/section-actions.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

COMANDI UTILI

Stili diversi dei pulsanti rendono le azioni facili da riconoscere.

NAVIGAZIONE

Una sezione può contenere testo, immagini e pulsanti.

SPAWN

REGOLAMENTO SERVER

ESEMPIO DANGER

Usa page per aprire direttamente un’altra pagina MenuInfoPages. Usa command per eseguire comandi; runAs: console va usato solo per azioni fidate.

07JSON pagina

Barra azioni inferiore

Inserisci fino a sei azioni in basso, separate dalle sezioni scorrevoli.

Configurazione JSON

{
  "command": "shortcuts",
  "title": "AZIONI RAPIDE",
  "intro": "Scorciatoie comuni raccolte in un unico punto.",
  "images": [],
  "sections": [
    {
      "title": "AIUTO",
      "text": "Scegli un’azione qui sotto.",
      "images": []
    }
  ],
  "buttons": [
    {
      "text": "REGOLAMENTO",
      "page": "rules",
      "style": "primary"
    },
    {
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player",
      "close": true,
      "delayMs": 250,
      "style": "secondary"
    },
    {
      "text": "SITO WEB",
      "command": "https://example.org",
      "style": "secondary"
    }
  ]
}

pages/it-IT/shortcuts.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

AZIONI RAPIDE

Scorciatoie comuni raccolte in un unico punto.

AIUTO

Scegli un’azione qui sotto.

REGOLAMENTO

SPAWN

SITO WEB

Destinazioni come rules o warp market devono esistere sul tuo server. Una destinazione page è il comando interno di una pagina MenuInfoPages.

08JSON pagina

Permessi della pagina

Aggiungi un nodo permesso opzionale per limitare una pagina agli utenti autorizzati.

Configurazione JSON

{
  "command": "staff-info",
  "permission": "server.staff",
  "title": "INFORMAZIONI STAFF",
  "intro": "Informazioni riservate ai giocatori autorizzati.",
  "images": [],
  "sections": [
    {
      "title": "NOTE STAFF",
      "text": "Solo i giocatori con il permesso server.staff possono aprire questa pagina.",
      "images": []
    }
  ],
  "buttons": []
}

pages/it-IT/staff-info.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

INFORMAZIONI STAFF

Informazioni riservate ai giocatori autorizzati.

NOTE STAFF

Solo i giocatori con il permesso server.staff possono aprire questa pagina.

Il nodo permesso è un esempio. Concedilo tramite il sistema permessi del server. Anche AutoOpen rispetta i permessi della pagina.

09JSON pagina

Apertura automatica all’accesso

Mostra una pagina di benvenuto una sola volta, sempre oppure finché il giocatore non la disattiva.

Configurazione JSON

{
  "autoOpen": {
    "enabled": true,
    "mode": "dismissible",
    "version": 1,
    "worlds": [],
    "delayMs": 1500
  },
  "command": "server-guide",
  "title": "GUIDA DEL SERVER",
  "intro": "Benvenuto! Seleziona Non mostrare più per nascondere questa pagina agli accessi successivi.",
  "images": [],
  "sections": [
    {
      "title": "PRIMI PASSI",
      "text": "Leggi il regolamento e scopri come orientarti.",
      "images": []
    }
  ],
  "buttons": []
}

pages/it-IT/server-guide.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

GUIDA DEL SERVER

Benvenuto! Seleziona Non mostrare più per nascondere questa pagina agli accessi successivi.

PRIMI PASSI

Leggi il regolamento e scopri come orientarti.

Configura autoOpen nella versione della pagina relativa alla lingua di fallback. Non abilitare pagine AutoOpen sovrapposte per lo stesso mondo: se più pagine corrispondono, nessuna viene aperta automaticamente.

10JSON configurazione

Abilita i tutorial inclusi

Scegli le lingue caricate indipendentemente da quelle per cui vengono generate le pagine demo.

Configurazione JSON

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

Risultato visualeAnteprima schematica

Impostazioni lingua

en-USCaricata · Demo ON

it-ITCaricata · Demo OFF

de-DECaricata · Demo OFF

La lingua del client seleziona la traduzione della pagina; per le traduzioni mancanti viene usata la lingua di fallback configurata.

L’edizione Full include 25 cartelle lingua. Per generare le pagine tutorial di una lingua, sia enabled sia demo devono essere true. Imposta demo: false quando non ti servono più.

CAPITOLO 02 · 5 ESEMPI

Barre laterali sinistra e destra

Aggiungi una o entrambe le barre indipendenti, intestazioni fisse ed elementi di navigazione misti.

Evidenziazione PRIMARY automatica della pagina aperta

Sia in leftContent sia in rightContent, un pulsante laterale il cui page corrisponde al command della pagina attualmente aperta viene mostrato automaticamente come primary. Non è necessario specificare "style": "primary". Negli esempi qui sotto questo stato è mostrato in oro. Gli altri pulsanti mantengono lo stile configurato.

Vengono evidenziate automaticamente solo le destinazioni pagina corrispondenti: una categoria superiore o un pulsante non correlato nella barra opposta non viene selezionato automaticamente. Per mantenere evidenziato un pulsante simile in un’altra pagina, usa esplicitamente "style": "primary" nel JSON di quella pagina.

01JSON pagina

Barra di navigazione sinistra

Crea una barra sinistra con scorrimento indipendente, collegamenti a pagine e intestazioni testuali. Il pulsante della pagina attiva viene evidenziato automaticamente come primary.

Configurazione JSON

{
  "command": "help-index",
  "title": "CENTRO ASSISTENZA",
  "intro": "Usa il menu sinistro per consultare le informazioni.",
  "images": [],
  "sections": [
    {
      "title": "SELEZIONA UN ARGOMENTO",
      "text": "Le pagine possono collegarsi tra loro senza chiudere l’interfaccia.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "INFORMAZIONI"
    },
    {
      "type": "button",
      "text": "CENTRO ASSISTENZA",
      "page": "help-index"
    },
    {
      "type": "button",
      "text": "BENVENUTO",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "REGOLAMENTO",
      "page": "rules"
    },
    {
      "type": "button",
      "text": "AIUTO",
      "command": "help",
      "runAs": "player"
    }
  ],
  "buttons": []
}

pages/it-IT/help-index.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

barra sinistra

INFORMAZIONI

CENTRO ASSISTENZA

BENVENUTO

REGOLAMENTO

AIUTO

CENTRO ASSISTENZA

Usa il menu sinistro per consultare le informazioni.

SELEZIONA UN ARGOMENTO

Le pagine possono collegarsi tra loro senza chiudere l’interfaccia.

HELP CENTER punta al comando di questa pagina (help-index), quindi diventa primary senza un campo style. Usa destinazioni page identiche in ogni traduzione.

02JSON pagina

Barra laterale destra

Usa rightContent per sottoargomenti o per un elenco contestuale di azioni. L’evidenziazione della pagina attiva funziona anche a destra.

Configurazione JSON

{
  "command": "guide-topic",
  "title": "ARGOMENTO GUIDA",
  "intro": "La navigazione aggiuntiva si trova a destra.",
  "images": [],
  "sections": [
    {
      "title": "ARTICOLO PRINCIPALE",
      "text": "Mantieni il contenuto principale al centro.",
      "images": []
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "ARGOMENTI"
    },
    {
      "type": "button",
      "text": "ARGOMENTO ATTUALE",
      "page": "guide-topic"
    },
    {
      "type": "button",
      "text": "COMANDI",
      "page": "shortcuts"
    }
  ],
  "buttons": []
}

pages/it-IT/guide-topic.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

ARGOMENTO GUIDA

La navigazione aggiuntiva si trova a destra.

ARTICOLO PRINCIPALE

Mantieni il contenuto principale al centro.

barra destra

ARGOMENTI

ARGOMENTO ATTUALE

COMANDI

CURRENT TOPIC diventa automaticamente primary perché la sua destinazione page corrisponde a guide-topic. Non serve impostare manualmente lo style; ogni barra scorre in modo indipendente.

03JSON pagina

Entrambe le barre laterali

Combina navigazione sinistra e destra indipendenti senza modificare la struttura della pagina centrale.

Configurazione JSON

{
  "command": "server-manual",
  "title": "MANUALE SERVER",
  "intro": "Naviga per categoria e sottoargomento.",
  "images": [],
  "sections": [
    {
      "title": "ARGOMENTO ATTUALE",
      "text": "Il centro rimane dedicato alle informazioni principali.",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "button",
      "text": "INTRODUZIONE",
      "page": "welcome"
    },
    {
      "type": "button",
      "text": "REGOLAMENTO",
      "page": "rules"
    }
  ],
  "rightContent": [
    {
      "type": "text",
      "text": "LINK RAPIDI"
    },
    {
      "type": "button",
      "text": "SPAWN",
      "command": "spawn",
      "runAs": "player"
    },
    {
      "type": "button",
      "text": "SITO WEB",
      "command": "https://example.org"
    }
  ],
  "buttons": []
}

pages/it-IT/server-manual.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

barra sinistra

INTRODUZIONE

REGOLAMENTO

MANUALE SERVER

Naviga per categoria e sottoargomento.

ARGOMENTO ATTUALE

Il centro rimane dedicato alle informazioni principali.

barra destra

LINK RAPIDI

SPAWN

SITO WEB

In ogni barra puoi inserire fino a 24 elementi misti, nell’ordine scritto nel JSON.

04JSON pagina

Immagini fisse sopra le barre laterali

Aggiungi immagini di intestazione fisse in modo indipendente a ciascuna barra.

Configurazione JSON

{
  "command": "branded-menu",
  "title": "NAVIGAZIONE PERSONALIZZATA",
  "intro": "Le intestazioni delle barre restano visibili mentre i relativi elementi scorrono.",
  "images": [],
  "sections": [
    {
      "title": "BENVENUTO",
      "text": "Prova una o entrambe le intestazioni laterali fisse.",
      "images": []
    }
  ],
  "leftHeaderImage": {
    "image": "left-logo.png",
    "page": "welcome"
  },
  "leftContent": [
    {
      "type": "button",
      "text": "HOME",
      "page": "welcome"
    }
  ],
  "rightHeaderImage": {
    "image": "right-logo.png"
  },
  "rightContent": [
    {
      "type": "button",
      "text": "REGOLAMENTO",
      "page": "rules"
    }
  ],
  "buttons": []
}

pages/it-IT/branded-menu.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

barra sinistra

left-logo.png

HOME

NAVIGAZIONE PERSONALIZZATA

Le intestazioni delle barre restano visibili mentre i relativi elementi scorrono.

BENVENUTO

Prova una o entrambe le intestazioni laterali fisse.

barra destra

right-logo.png

REGOLAMENTO

Inserisci left-logo.png e right-logo.png in mods/MenuInfoPages/images/. L’intestazione di ogni barra accetta un’azione page o command opzionale.

05JSON pagina

Testo, immagini e pulsanti misti

Ordina liberamente testo, immagini cliccabili e pulsanti di navigazione in ciascuna barra laterale.

Configurazione JSON

{
  "command": "player-panel",
  "title": "PANNELLO GIOCATORE",
  "intro": "Le barre laterali possono combinare tre tipi di elemento.",
  "images": [],
  "sections": [
    {
      "title": "PANORAMICA",
      "text": "Bentornato, {player}!",
      "images": []
    }
  ],
  "leftContent": [
    {
      "type": "text",
      "text": "{center}{b}IL TUO PROFILO{/}"
    },
    {
      "type": "image",
      "image": "profile.png",
      "command": "profile",
      "runAs": "player",
      "close": true,
      "delayMs": 250
    },
    {
      "type": "text",
      "text": "Giocatore: {player}"
    },
    {
      "type": "button",
      "text": "HOME",
      "page": "welcome"
    }
  ],
  "buttons": []
}

pages/it-IT/player-panel.json

Risultato visualeAnteprima schematica

MENUINFOPAGES · SCHEMA×

barra sinistra

IL TUO PROFILO{/}

profile.png

Giocatore: Alex

HOME

PANNELLO GIOCATORE

Le barre laterali possono combinare tre tipi di elemento.

PANORAMICA

Bentornato, Alex!

Gli array laterali attuali della Full sono leftContent/rightContent. Il futuro schema unificato content/cells non fa parte di questa guida.

CAPITOLO 03 · 4 ESEMPI

O-Key & HUD

Crea scorciatoie di accesso rapido, posiziona i relativi indicatori e configura il comportamento per mondo.

01JSON configurazione

Scorciatoia O-Key globale

Imposta comando predefinito, permessi e indicatore HUD per ogni mondo.

Configurazione JSON

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

Risultato visualeAnteprima schematica

O-Key · HUD illustrativo

Rappresentazione dello schermo di gioco

Posizione HUD: right:-8, top:245. Comandi e comportamento sono configurati in config.json.

Modifica l’oggetto O-Key esistente invece di sostituire l’intero config.json. Il valore default dell’immagine HUD si riferisce all’icona inclusa.

02JSON configurazione

Centra l’HUD O-Key

Usa center indipendentemente su ciascun asse e regola l’altro asse partendo da un bordo.

Configurazione JSON

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

config.json — O-Key.AllWorlds.Hud

Risultato visualeAnteprima schematica

O-Key · HUD illustrativo

Rappresentazione dello schermo di gioco

Posizione HUD: center, top:190. Comandi e comportamento sono configurati in config.json.

Questo esempio è un oggetto Hud parziale; integra questi valori nelle impostazioni O-Key.AllWorlds.Hud esistenti.

03JSON configurazione

Override per mondi e istanze

Assegna una scorciatoia diversa a mondi specifici, incluse le istanze generate tramite wildcard finale.

Configurazione JSON

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

Risultato visualeAnteprima schematica

O-Key · HUD illustrativo

Rappresentazione dello schermo di gioco

Survival → /welcome

instance-Forgotten_Temple-* → /server-guide

È supportato un singolo * finale nel prefisso del nome mondo. I nomi esatti hanno priorità sui pattern wildcard; altrimenti vince il prefisso corrispondente più lungo.

04JSON configurazione

Immagine O-Key personalizzata

Usa un tuo PNG con dimensione e posizione configurabili.

Configurazione JSON

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

config.json — O-Key.AllWorlds.Hud

Risultato visualeAnteprima schematica

O-Key · HUD illustrativo

Rappresentazione dello schermo di gioco

Posizione HUD: right:-5, top:138. Comandi e comportamento sono configurati in config.json.

Inserisci okey-survival.png in mods/MenuInfoPages/images/. Mantieni Width/Height coerenti con le proporzioni del PNG, ad esempio 600×400 visualizzato come 300×200.

CAPITOLO 04 · 2 ESEMPI

ItemCommands

Crea oggetti con comandi separati per clic sinistro e destro.

01JSON configurazione

Abilita un oggetto dimostrativo

L’esempio incluso fornisce un oggetto sorgente interattivo con azioni separate per clic sinistro e destro.

Configurazione JSON

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

config.json — itemCommands object

Risultato visualeAnteprima schematica

ItemCommands · mappa delle interazioni

Pagine Demo

Clic sinistro/menuinfopages

Clic destro/menuinfopages

Questo è l’ID reale dell’oggetto sorgente usato nell’esempio incluso. A differenza delle modifiche alle pagine, gli aggiornamenti strutturali degli item possono richiedere un riavvio del server.

02JSON configurazione

Comandi sinistro e destro separati

Usa un oggetto esistente di Hytale o di una mod installata come sorgente per una nuova scorciatoia interattiva.

Configurazione JSON

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

config.json — itemCommands object

Risultato visualeAnteprima schematica

ItemCommands · mappa delle interazioni

Scorciatoie Server

Clic sinistro/welcome

Clic destro/spawn

Sostituisci sourceItem con l’ID reale di un oggetto installato sul server e scegli comandi esistenti e accessibili ai giocatori. ItemCommands è indipendente dal JSON delle pagine.

Prima di usare un esempio

Esempi di pagina completi: Inserisci ogni oggetto JSON in un file separato dentro mods/MenuInfoPages/pages/it-IT/. Mantieni distinto il comando di ogni pagina e traduci i file corrispondenti nelle altre cartelle lingua quando necessario.

Esempi di configurazione: Gli oggetti O-Key e ItemCommands sono frammenti del tuo config.json esistente. Integra le proprietà mostrate nella posizione corretta; non sostituire mai l’intero file di configurazione con un piccolo esempio.

Configurazione sicura: Inserisci i PNG citati nella cartella immagini prevista. Per prestazioni migliori è consigliato, ma non obbligatorio, mantenere ogni immagine sotto i 2 MB; file più grandi possono richiedere più tempo e memoria per il caricamento. Comandi demo, destinazioni di navigazione, nodi permesso e URL esterni sono segnaposto per risorse fornite da te. Evita di eseguire comandi con privilegi elevati per giocatori non fidati.

Schema attuale: Questa guida documenta l’attuale sistema sections, leftContent e rightContent; un possibile futuro modello unificato content/cells non viene mostrato come funzione già disponibile.

TORNA IN ALTO