From MediaWiki.org
Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
български • ‎čeština • ‎English • ‎español • ‎français • ‎日本語 • ‎русский • ‎中文
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png

Release status:Extension status experimental

3d extension screenshot.png
ImplementationTemplate:Extension#type Media
DescriptionTemplate:Extension#description Provides support for 3d file formats.
Author(s)Template:Extension#username Gilles Dubuc
Latest versionTemplate:Extension#version 0.0.1
MediaWikiTemplate:Extension#mediawiki 1.29.0+
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Hooks usedTemplate:Extension#hook

Translate the 3D extension if it is available at translatewiki.net

Check usage and version matrix.
Vagrant roleMediaWiki-Vagrant#Using roles three_d


Open tasks · Report a bug

The 3D extension gives the user of a wiki support for uploading and viewing 3D models. See Help:Extension:3d for documentation.

It currently supports the AMF and STL file formats from the 3d printing world.

Short-term plan for Wikimedia production release[edit]

  1. YesY Done Upload and hooks for 2D rendering code made into this extension
  2. YesY Done Code review for phab:T132064 (gerrit:282211) - "Make Media Viewer pluggable for the 3d extension, videos, …"
  3. YesY Done Deploy to Beta Cluster for testing, bug-discovery, and further editor feedback
  4. Request UI/UX input on possible fixes & improvements, in the short-term and medium-term

Rotation and zooming[edit]

It is possible to rotate the 3D object using either the keyboard (using arrow keys) or the mouse. Zooming in and out is also possible using the mouse.

Action Controls
Camera rotate Left mouse key hold and move
Camera rotate in place Right mouse key hold and move
Camera zoom Mouse wheel, hold wheel and move
Model rotate ←↑→↓ keys


  • Download and place the file(s) in a directory called 3D in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( '3D' );
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Related tasks[edit]

Deployment of this tool:

  • phab:T132058 - 3d extension supporting AMF and STL (3d printing files)
    • phab:T54655 - Add support for thumbnails and interactive views of 3D models
    • phab:T132064 - Make Media Viewer pluggable for the 3d extension, videos, …
    • phab:T132063 - Security review of 3d2png

Other 3D file support:

  • phab:T3790 - Allow uploading of 3D files to Wikimedia Commons
    • phab:T131723 - Provide a mechanism to sanitise user-generated 3D files to meet security requirements