Utilities

Debug

Stellt ein Tweakpane-Debug-UI-Panel bereit, das durch Anhängen von #debug an die URL aktiviert wird.

// Zugriff über game.debug
const debug = game.debug

if (debug.ui) {
  // Tweakpane-Panel ist verfügbar
  const folder = debug.ui.addFolder({ title: 'Meine Einstellungen' })
  folder.addBinding(myObject, 'speed', { min: 0, max: 10 })
}

debug.ui ist undefined, wenn nicht im Debug-Modus — immer dagegen absichern.

Sizes

Verfolgt die Fensterabmessungen und das Pixelverhältnis und sendet ein resize-Event.

// Zugriff über game.sizes
const sizes = game.sizes

console.log(sizes.width, sizes.height, sizes.pixelRatio)

sizes.on('resize', () => {
  // Fenster wurde skaliert
})

Logger

Ein Winston-Logger-Wrapper für strukturiertes serverseitiges Logging.

import { Logger } from '@mavonengine/core'

Logger.info('Server gestartet')
Logger.warn('Hohe Latenz erkannt', { ping: 200 })
Logger.error('Unbehandelter Fehler', { error })

LoadingScreen

Wird während des Asset-Ladens automatisch angezeigt und ausgeblendet, wenn alle Assets bereit sind. Es integriert sich intern mit Resources — kein manuelles Setup erforderlich.

// Zugriff über game.loadingScreen
const loadingScreen = game.loadingScreen

SkeletonAxesHelper

Visualisiert Skelettgelenke als Achsenhilfslinien in der Three.js-Szene. Nützlich zum Debuggen von Animations-Rigs.

import { SkeletonAxesHelper } from '@mavonengine/core'

Über die armature-Option im Debug-Panel unter Renderer umschalten.

Mathematik & Helfer

Die Engine exportiert einige Mathematik-Utilities und allgemeine Helfer, die intern verwendet werden:

import { Math, Helpers } from '@mavonengine/core'

Lies den Quellcode für die vollständige Liste der verfügbaren Funktionen.