5MCustoms

Branding & Sprache

Alle Oberflächen holen sich Markenname, Logo, Akzentfarbe und Sprache aus einer Quelle. Du setzt sie einmal, HUD, Telefon, Inventar, Pausenmenü und Ladebildschirm ziehen nach.

Über das Portal

Der bequeme Weg: im Kundenportal Logo hochladen, Farben wählen und Deutsch oder Englisch als Serversprache festlegen. Die Einstellungen landen in deiner Installation, ohne dass du eine Datei anfasst.

Über die Konfiguration

Wer lieber direkt arbeitet, setzt dieselben Werte in der Serverkonfiguration. Jedes Modul liest sie über das SDK aus, ein Neustart der Module genügt.

Verfügbar sind Name, Kurzform, Slogan, Logo-Adresse, Akzentfarbe, dunkle Variante, Discord und Website. Im Code sieht der Zugriff so aus:

import { getBrand } from '@5mc/sdk';

const brand = getBrand();
// { name, short, tagline, logo, color, colorDark, discord, website }

In einer NUI-Oberfläche entsprechend:

import { useBrand, BrandLogo } from '@5mc/ui';

const brand = useBrand();
<BrandLogo height={46} />

Das Logo liegt zentral im Core und wird an alle Oberflächen ausgeliefert. Jede NUI hält zusätzlich eine eigene Kopie als Rückfallebene vor, damit nichts leer bleibt, falls der Core einmal nicht antwortet.

Empfehlung für den Upload:

  • Format PNG mit Transparenz
  • Höhe mindestens 400 Pixel, Breite nach Bedarf
  • Ränder knapp beschneiden, die Oberflächen setzen ihren eigenen Abstand
  • Helligkeit hell genug für dunkle Flächen, das Framework ist durchgehend dunkel

Sprache

Jedes Modul bringt Sprachdateien für Deutsch und Englisch mit. Beschriftungen stehen nie im Code, sondern immer als Schlüssel in diesen Dateien — auch Item-Namen. Ein eigener Item-Name ist also eine Textänderung, kein Eingriff in die Logik.

{
  "item.lockpick.label": "Dietrich",
  "item.water.label": "Wasser"
}

Du kannst die vorhandenen Texte anpassen, wenn dein Server einen eigenen Ton hat. Eine dritte Sprache ergänzt du, indem du eine weitere Datei nach demselben Muster anlegst.

Farben

Die Akzentfarbe wirkt auf aktive Zustände, Balken und Chips. Die Flächen bleiben neutral anthrazit — dieser Aufbau ist Absicht und der Grund, warum das Framework mit jeder Markenfarbe funktioniert, ohne bunt zu wirken. Wie du tiefer eingreifst, steht unter Design-Tokens.