Jump to content

Template:ModelViewer

From Survivalcraft Wiki
Revision as of 19:41, 29 July 2025 by Noswad (talk | contribs)

This template displays an interactive 3D model using <model-viewer>. Works in VisualEditor. Be sure the site globally loads the model-viewer script (e.g. in `MediaWiki:Common.js`).

Usage

{{ModelViewer
 |src=https://survivalcraft.wiki/content/Models/Bear_Brown.glb
 |alt=Brown Bear
 |width=300px
 |height=300px
 |cameraOrbit=165deg 75deg 4m
 |autoRotate=yes
 |cameraControls=yes
 |backgroundColor=transparent
 |shadowIntensity=1
 |environmentImage=neutral
 |exposure=1
 |ar=yes
 |autoplay=no
 |poster=https://example.com/poster.png
 |loading=lazy
}}


<model-viewer src="{{{src}}}" alt="3D model" camera-orbit="165deg 75deg 4m" style="display: block; width: 300px; height: 300px; margin-left: auto; margin-right: auto;" background-color="transparent" shadow-intensity="1" environment-image="neutral" exposure="1" loading="eager"> id=modelViewer-ModelViewer </model-viewer>


Displays an interactive 3D model using <model-viewer>.

Template parameters

ParameterDescriptionTypeStatus
Model source URLsrc

URL of the .glb or .gltf file

Stringrequired
Alternative textalt

Accessibility text

Stringoptional
Widthwidth

Width of viewer (e.g., 300px)

Stringoptional
Heightheight

Height of viewer (e.g., 300px)

Stringoptional
Camera orbitcameraOrbit

Initial camera orbit (e.g., 165deg 75deg 4m)

Stringoptional
Background colorbackgroundColor

Background color (e.g., transparent, #ffffff)

Stringoptional
Shadow intensityshadowIntensity

Shadow intensity (0-1)

Stringoptional
Environment imageenvironmentImage

Environment image or 'neutral'

Stringoptional
Exposureexposure

Scene exposure value

Stringoptional
Loading modeloading

eager or lazy

Stringoptional
Poster imageposter

Poster image URL (displayed before load)

Stringoptional
Auto rotateautoRotate

yes to enable auto-rotate

Booleanoptional
Camera controlscameraControls

yes to enable user camera controls

Booleanoptional
Augmented realityar

yes to enable AR

Booleanoptional
Autoplayautoplay

yes to autoplay animations

Booleanoptional