Weltenverwaltung - Benutzungsanleitung

Inhaltsverzeichnis

Übersicht
Weltenverwaltung öffnen
Für Lernende
- Lernwelt importieren
- Lernwelt löschen
- Speicherplatz verwalten
Für Lehrende / Dozenten
- Lernwelten testen
- Lernwelten aktualisieren
- Veröffentlichungsmodus
- Auf Webserver bereitstellen
Fehlerbehebung
Häufige Fragen (FAQ)

Übersicht

Die AdLer 3D-Lernumgebung unterstützt zwei Arten von Lernwelten:

Art	Beschreibung	Löschbar?
Vorinstalliert	Welten, die auf dem Webserver bereitgestellt sind	Nur von Server-Admins
Importiert	Welten, die Sie selbst als .mbz-Datei importiert haben	Ja

Was ist eine .mbz-Datei?
Eine .mbz-Datei ist ein Moodle-Backup-Format. In AdLer enthält sie eine komplette Lernwelt mit allen Lernelementen (Texte, Videos, H5P-Inhalte, 3D-Modelle etc.).

Weltenverwaltung öffnen

Öffnen Sie die AdLer 3D-Lernumgebung im Browser
Auf der Startseite finden Sie den Button „Weltenverwaltung"
Klicken Sie darauf, um das Verwaltungsfenster zu öffnen

Für Lernende

Als Lernende nutzen Sie die Weltenverwaltung hauptsächlich, um von Dozenten bereitgestellte Lernwelten zu importierenl, wenn diese nicht auf dem Server selbst bereitgestellt wurden.

Lernwelt importieren

Es gibt zwei Möglichkeiten, eine Lernwelt zu importieren:

Option A: Per Klick

Klicken Sie auf „Lernwelt importieren (.mbz)"
Wählen Sie die gewünschte .mbz-Datei aus
Der Import startet automatisch

Option B: Per Drag & Drop

Ziehen Sie die .mbz-Datei direkt in den markierten Bereich „Dateien hier ablegen"
Der Import startet automatisch

Import-Fortschritt

Während des Imports sehen Sie einen Fortschrittsbalken mit Statusmeldungen:

Phase	Beschreibung
Extrahiere Archiv	Die .mbz-Datei wird entpackt
Lese Weltdokument	Die Lernwelt-Struktur wird analysiert
Speichere Elemente	Lerninhalte werden im Browser gespeichert
Schließe Import ab	Abschlussarbeiten und Validierung

Nach erfolgreichem Import erscheint eine Erfolgsmeldung mit dem Namen der Lernwelt und der Anzahl der Elemente.

Lernwelt löschen

Finden Sie die gewünschte Lernwelt in der Liste
Klicken Sie auf den Löschen-Button rechts neben dem Eintrag

Bestätigen Sie die Löschung im erscheinenden Dialog

Speicherplatz verwalten

Am unteren Rand der Weltenverwaltung sehen Sie eine Speicheranzeige:

Speicher: 245 MB / 2.1 GB belegt (12%)
████░░░░░░░░░░░░░░░░

Diese zeigt an:

Wie viel Speicherplatz Ihre importierten Lernwelten belegen
Wie viel Speicherplatz insgesamt verfügbar ist
Den prozentualen Anteil der Nutzung

Browser-Speicherlimits:

Browser	Typisches Limit
Chrome	~60% des Festplattenspeichers
Firefox	~50% des Festplattenspeichers
Safari	~1 GB
Edge	~60% des Festplattenspeichers

Für Lehrende / Dozenten

Als Lehrende nutzen Sie die Weltenverwaltung zum Testen Ihrer mit dem AdLer-Autorentool erstellten Lernwelten und zur Bereitstellung auf Webservern.

Lernwelten testen

Der typische Workflow zum Testen einer neuen Lernwelt:

Erstellen Sie die Lernwelt im AdLer-Autorentool
Exportieren Sie die Lernwelt als .mbz-Datei
Importieren Sie die .mbz-Datei in der Weltenverwaltung (siehe Lernwelt importieren)
Testen Sie die Lernwelt in der 3D-Umgebung
Nehmen Sie bei Bedarf Anpassungen im Autorentool vor

Lernwelten aktualisieren

Wenn Sie Änderungen an einer bereits importierten Lernwelt vorgenommen haben:

Exportieren Sie die aktualisierte Lernwelt erneut aus dem Autorentool
Importieren Sie die neue .mbz-Datei – die alte Version wird automatisch überschrieben

Veröffentlichungsmodus

Der Veröffentlichungsmodus (auch „Dozentenmodus") ermöglicht es, mehrere Lernwelten als Paket zu exportieren – ideal für die Bereitstellung auf einem Webserver.

Veröffentlichungsmodus aktivieren

Aktivieren Sie die Checkbox „Veröffentlichungsmodus (Dozenten)"

Lernwelten auswählen

Nach Aktivierung des Veröffentlichungsmodus haben Sie folgende Optionen:

Aktion	Beschreibung
Einzelne Welt auswählen	Klicken Sie auf die Checkbox neben der Lernwelt
Alle auswählen	Klicken Sie auf „Alle"
Alle abwählen	Klicken Sie auf „Keine"

Die Anzeige „X / Y ausgewählt" zeigt, wie viele Welten aktuell markiert sind.

Paket exportieren

Wählen Sie die gewünschten Lernwelten aus
Klicken Sie auf „Paket exportieren"

Warten Sie, bis der Export abgeschlossen ist
Eine Datei wird automatisch heruntergeladen

Das exportierte Paket enthält:

Alle ausgewählten Lernwelten
Eine aktualisierte worlds.json-Datei

Auf Webserver bereitstellen

Um Lernwelten auf einem Webserver als „vorinstallierte" Welten bereitzustellen, müssen Sie das exportierte Paket in das Verzeichnis LearningWorlds auf Ihrem Webserver kopieren.

Wichtig: Die worlds.json verstehen

Die worlds.json hat folgende Struktur:

{
  "worlds": [
    {
      "worldID": 1,
      "worldName": "Meine Lernwelt",
      "worldFolder": "Meine_Lernwelt",
      "elementCount": 42
    }
  ]
}

Szenario A: Publikation auf denselben Server (z.B. Test-Server)

Wenn Sie auf denselben Webserver publizieren, den Sie auch zum Testen verwenden:

Aktivieren Sie den Veröffentlichungsmodus
Wählen Sie ALLE Welten aus – sowohl Ihre neuen als auch die bereits vorhandenen
Exportieren Sie das Paket
Laden Sie das Paket auf den Server in das Verzeichnis LearningWorlds/

Szenario B: Publikation auf einen neuen/anderen Server

Wenn Sie auf einen separaten Produktions-Server publizieren:

Aktivieren Sie den Veröffentlichungsmodus
Wählen Sie nur die gewünschten Welten für diesen Server
Exportieren Sie das Paket
Laden Sie das Paket auf den Produktionsserver in das Verzeichnis LearningWorlds/

Hier müssen Sie die vorinstallierten Testwelten nicht mit exportieren, da der Ziel-Server unabhängig ist.

Verzeichnisstruktur auf dem Server

Nach dem Upload sollte die Struktur so aussehen:

/ihr-webserver/
├── index.html
├── ...
└── LearningWorlds/
    ├── worlds.json              ← Index aller Lernwelten
    ├── Lernwelt_A/
    │   ├── world.json           ← Lernwelt-Daten
    │   ├── manifest.json        ← Dateiliste
    │   └── elements/            ← Lerninhalte
    │       ├── 1.pdf
    │       ├── 2.jpg
    │       └── 5/               ← H5P-Inhalt (Ordner)
    └── Lernwelt_B/
        └── ...

Fehlerbehebung

Import-Fehler

Fehlermeldung	Ursache	Lösung
Datei ist zu groß	Die .mbz-Datei überschreitet 950 MB	Reduzieren Sie die Dateigröße im Autorentool oder entfernen Sie große Medien
Ungültiges Dateiformat	Die Datei ist keine .mbz-Datei	Stellen Sie sicher, dass Sie die richtige Datei ausgewählt haben
Ungültige MBZ-Datei	Die Datei ist beschädigt oder nicht im Moodle-Format	Exportieren Sie die Lernwelt erneut aus dem Autorentool
Kein gültiges Weltdokument	Die MBZ-Datei enthält keine AdLer-Lernwelt	Prüfen Sie, ob die Datei aus dem AdLer-Autorentool stammt
Nicht genug Speicherplatz	Der Browser-Speicher ist voll	Löschen Sie nicht benötigte Lernwelten

Speicherprobleme

Problem: Import bricht ab oder Browser wird langsam

Lösungen:

Schließen Sie andere Browser-Tabs
Löschen Sie nicht benötigte Lernwelten
Leeren Sie den Browser-Cache (andere Websites)
Versuchen Sie einen anderen Browser

Export-Fehler

Fehlermeldung	Ursache	Lösung
Export fehlgeschlagen	Allgemeiner Fehler beim Erstellen des Pakets	Versuchen Sie es erneut oder wählen Sie weniger Welten
Keine Welten ausgewählt	Button ist deaktiviert, weil keine Auswahl	Wählen Sie mindestens eine Lernwelt aus

Häufige Fragen (FAQ)

Allgemein

F: Wo werden meine importierten Lernwelten gespeichert?
A: Im lokalen Browser-Speicher (IndexedDB). Die Daten bleiben erhalten, solange Sie den Browser-Cache nicht löschen.

F: Kann ich Lernwelten zwischen Browsern übertragen?
A: Nicht direkt. Exportieren Sie die Lernwelt als Paket und importieren Sie sie im anderen Browser neu (sofern Sie die Original-.mbz-Datei noch haben).

F: Funktionieren importierte Lernwelten offline?
A: Ja, nach dem Import sind alle Inhalte lokal verfügbar und funktionieren ohne Internetverbindung.

Für Lernende

F: Mein Dozent hat mir eine .mbz-Datei gegeben. Was soll ich tun?
A: Öffnen Sie die Weltenverwaltung und importieren Sie die Datei per Klick oder Drag & Drop. Danach können Sie die Lernwelt starten.

F: Kann ich meinen Lernfortschritt sichern?
A: Der Lernfortschritt wird automatisch im Browser gespeichert. Beim Löschen einer Lernwelt geht jedoch auch der Fortschritt verloren.

F: Warum kann ich manche Lernwelten nicht löschen?
A: Welten mit dem Label „Vorinstalliert" sind auf dem Webserver hinterlegt und können nicht gelöscht werden. Nur selbst importierte Welten sind löschbar.

Für Lehrende

F: Warum muss ich beim Export alle Welten auswählen?
A: Die exportierte worlds.json definiert, welche Welten auf dem Webserver verfügbar sind. Fehlende Einträge führen dazu, dass Welten nicht gefunden werden.

F: Kann ich die worlds.json manuell bearbeiten?
A: Ja, technisch ist das möglich. Stellen Sie sicher, dass die Struktur korrekt bleibt und alle referenzierten Ordner existieren.

F: Wie verteile ich Lernwelten an meine Studierenden?
A: Sie haben zwei Optionen:

Vorinstalliert: Stellen Sie die Welten auf dem Webserver bereit (Veröffentlichungsmodus)
Individuell: Geben Sie den Studierenden die .mbz-Datei zum selbst importieren

F: Was ist der Unterschied zwischen ATF- und DSL-Format?
A: ATF (AdLer Transfer Format) ist das aktuelle Standardformat. DSL (Domain Specific Language) ist ein älteres Format, das weiterhin unterstützt wird. Beim Export aus aktuellen Autorentool-Versionen erhalten Sie automatisch das ATF-Format.