← Übersicht

MC Voxel Studio – Bedienung

Wandle .bbmodel-Projekte (auch komprimiert), GLB/GLTF-, OBJ- und STL-Modelle im Browser in Bedrock-Add-ons, einen Custom-Block oder ein VoxelForge-Projekt um. Eingebettete .bbmodel-Texturen werden direkt übernommen; externe Bilddateien bitte zusammen mit dem Projekt auswählen oder gemeinsam hineinziehen. Lokale Uploads werden auf deinem Gerät verarbeitet und nicht hochgeladen. Für URL-Importe ruft dein Browser die angegebene Adresse ab; externe GLTF-Ressourcen benötigen CORS-Freigabe.

Online oder offline starten

Offline-Kopie als ZIP

Das Desktop-ZIP wird im bereinigten Workspace nicht mitgeführt. Bei Bedarf im Projekt-Stamm mit python3 werkzeuge/baue_voxelstudio_offline.py neu erzeugen. Danach MC-Voxel-Studio-offline.zip entpacken und darin starten:

Dafür ist Python 3 nötig. Das Skript startet einen nur auf deinem eigenen Gerät erreichbaren lokalen Webserver und öffnet die App. Nach dem Entpacken funktionieren Konvertierung, Beispiele und Exporte ohne Internet. Die HTML-Datei sollte nicht direkt per Doppelklick (file://) geöffnet werden: Browser blockieren dort häufig die benötigten JavaScript-Module.

Offline nach einem Online-Besuch (PWA)

Öffne MC Voxel Studio einmal online über HTTPS oder localhost und warte auf die grüne Anzeige „Offline bereit“. Danach kann die App im selben Browser auch ohne Internet geöffnet werden; die Oberfläche und die kleinen Beispielmodelle sind im Cache. Das große Demomodell wird erst offline verfügbar, nachdem es einmal online geladen wurde. In unterstützten Browsern lässt sich die App zusätzlich über „Zum Startbildschirm“/„Installieren“ ablegen.

Der URL-Import braucht Internet und funktioniert offline nicht. Lokale Modell-Dateien und die Exportfunktionen bleiben verfügbar.

Auf Android und iPhone installieren

Die Oberfläche ist für schmale Displays ausgelegt. Für echte Offline-Nutzung auf dem Smartphone muss die App einmal online über eine HTTPS-Adresse geladen werden; localhost zählt nur auf demselben Gerät als sicherer Ursprung.

Das ZIP und STARTEN.cmd/starten.sh sind lokale Desktop-Startwege und laufen nicht direkt auf iOS. Ein einzelnes index.html aus Dateien-App/file:// reicht nicht, weil Safari die benötigten ES-Module und den Offline-Service-Worker dort nicht bereitstellt. URL-Importe brauchen weiterhin Netz; die App-Shell, Demos (und nach erster Nutzung das große Demo) sowie lokale Umwandlung/Exporte sind offline nutzbar.

Starten ohne ZIP

Bedienen

  1. Modell laden – Tippe auf das Datei-Feld, um auf Handy/iPhone die Dateien-Auswahl zu öffnen; am Rechner kannst du Dateien hineinziehen oder ebenfalls antippen. Für .bbmodel-Projekte können eingebettete oder gemeinsam ausgewählte externe Texturen verarbeitet werden; auch komprimierte Projekte mit <lz> werden erkannt. Alternativ ein Beispiel verwenden. GLB ist für einzelne lokale 3D-Dateien weiterhin am zuverlässigsten. Die Seitenleiste zeigt eine Modelltyp-Schätzung (z. B. Fahrzeug oder humanoide Figur), die Dateinamen, Mesh-Namen und grobe Abmessungen nutzt; sie ist kein KI-Klassifikator und kann falsch liegen.
  2. Qualität wählen – „Schnell“, „Ausgewogen“ oder „Detailliert“; unter „Weitere Qualitätsstufen“ gibt es höhere Profile. Rastergröße und Zellzahl sind Schätzwerte, keine Anzahl gesetzter Minecraft-Weltblöcke.
  3. Größe und Exporte einstellen – Höhe und optionale Custom-Block-/VoxelForge-Ausgabe wählen. Erweiterte Optionen umfassen bis zu 4.096 Palettenfarben.
  4. Umwandeln – die Vorschau und Ergebniszahlen werden aktualisiert. Nach einer Einstellungsänderung werden alte Downloads bis zur Neuberechnung gesperrt.
  5. Exportieren – .mcaddon öffnet das Paket direkt in einer unterstützten Minecraft-Installation; .zip bleibt für den manuellen Import verfügbar. Einzelne Downloads umfassen Custom-Block, Geometry, Palette und .bbmodel.

Für den Farbexport werden Basisfarb-Texturen materialweise ausgewertet; Materialgruppen pro Dreieck, UV-Kanäle/-Transformationen, Materialfarben und Deckkraft fließen ein. Sehr große Texturbilder werden für das Sampling auf maximal 1.024 Pixel Kantenlänge verkleinert, um den Speicherbedarf auf Smartphones zu begrenzen. Das Ziel bleibt eine Minecraft-Farbpalette: Animationen, Normal-/Roughness-Maps und sämtliche PBR-Effekte werden nicht 1:1 in Voxel-Geometrie übertragen.

Was der Custom-Block bedeutet

Der Custom-Block-Export erzeugt einen einzelnen platzierbaren 1×1-Block mit dem Modell. Er ist keine Statue aus vielen normalen Minecraft-Weltblöcken. Ein chunkbarer Export als mehrteilige Weltblock-Statue ist derzeit nicht enthalten.

Beispiele und Faustregeln