Upload a .glb file, drop the element on your page, done. Visitors spin the model with their mouse, zoom into the details, and on a phone they can drop it into their own living room with AR. It runs on your own site, no Sketchfab embed needed.
Set the starting angle so the front faces the camera. Give it a soft studio shadow, a coloured light, a slow turn. Or pick a look preset (Product Studio, Hero Showcase, Technical Viewer) and skip the fiddling entirely.
Pick a loader: progress bar, spinner, pulse, dots, or your own Lottie animation. Set the size and colour to match your site.
Refresh the page so you can see the loader again.
Line up as many models as you want and let people click through them like a photo gallery. Behind the scenes one viewer does all the work, so the page stays light even with 10 models loaded. Arrows, dots, thumbnails, autoplay, your call.
Tune the exposure, soften the shadows, tint the whole scene with a colour. The controls sit right next to the model, so you see every change as you make it.
On a phone, one tap opens the model in AR so people can place it on their real desk or floor at true size. Add a custom loading animation while big files download, and it quietly respects reduced-motion for anyone who needs the page to hold still.
Show a wall of product cards. Click one and the model opens big in a pop-up where people turn it around and zoom in. Haven't made a poster image for a card? The plugin snapshots the model itself and fills it in for you.
No settings match your search.
This manual documents PLG_SYSTEM_YC_EPIC3D, version 3.0.5.
Manager.** The plugin added them to the allowed-extension and MIME lists, but Joomla 4/5 also requires an upload to be in one of its image, audio, video or document lists, and rejected the files as "not supported". They are now added to the document list too, plus application/json for .gltf files, which most servers detect as JSON.
yet, the old code would have saved only the three Epic 3D types and dropped Joomla's own entries (pdf, doc and the rest).
plugin options.** The check ran on an admin page load behind a flag in the plugin settings, and the License tab's Save removed that flag. It now runs in the installer, on install and on every update, and never on a page load.
Manager upload limit to 50 MB when it is lower. A higher limit, or 0 (no limit), is left alone.
than 50 MB (upload_max_filesize, post_max_size), the install message says the real limit, because Joomla cannot go above it.
.sys.ini (four new keys) because they are shown during install; the three old .ini notice keys are gone. Six languages.
periodic check now also send the plugin, CMS, PHP and YOOtheme Pro versions to the YOOzeCase licence gateway, so it can show which version runs where. Deactivate sends none of them. Documented in NOTICE.txt.
LICENSE.txt now holds the full GPL-2.0 text and nothing else; the brand clause and commercial terms moved to NOTICE.txt. The Apache-2.0 licence of the bundled model-viewer ships in licenses/Apache-2.0.txt. NOTICE.txt no longer names a version and now has data-processing notes for the licence check and the optional Lottie loader (jsDelivr CDN).
and uninstalling said "YC 3D Model ...", and so did the three media notices about the .glb / .gltf / .hdr upload types. They now say Epic 3D, in all six languages. The plugin description in the plugin manager now names the three Epic 3D elements instead of "a 3D Model custom element". Text only: no change to the elements, rendering, licence or installer.
License fieldset with a masked key field, an Activate and a Deactivate button, and a status badge. Activation talks to the YOOzeCase gateway on updates.yoozecase.com/license/index.php?action=, never to the payment provider, and the plugin holds no provider secret.
src/Helper/YcLicense.php, copied from the extension skill v61 with onlythe namespace, the product slug and the plugin element adjusted.
src/Field/ycepic3dlicense.php for the status panel, plus media/plg_system_yc_epic3d/css/license-admin.css and js/license-admin.js for the panel behaviour.
_DATE_FORMAT key so the "last checked" line follows the country convention instead of showing an English date.
plugin is removed, so a reinstall does not run into the activation limit.
the WordPress edition of Epic 3D is refused with its own message instead of activating here; each edition has its own key.
update check.** The installer already disabled the predecessor plugins, but Joomla keeps polling the update site of a disabled extension, and the v2.x feed under /yoo3dmodel/ was retired with the 3.0.0 rename. Install and update now also switch off the update sites of both predecessors (the v2.x yc_yoo3dmodel and the Pastedog yoo3dmodel), plus any leftover site on the retired URL. Switched off, not deleted: uninstalling the old plugin removes it for good, and the Epic 3D feed is never touched. One new language key, PLG_SYSTEM_YC_EPIC3D_LEGACY_UPDATE_SITE_DISABLED, in all six locales. A "Rebuild" on the Update Sites page re-creates the old site from the old plugin's manifest for as long as that plugin is installed; uninstall it under System - Manage - Extensions ("3D Model YOOtheme Pro"). The retired feed URL now also serves an empty stub, so a rebuilt site no longer errors either.
and the download URL is guessable, so a key is a registration and not a lock. Key-gated feeds and tokenised downloads are phase 2 of the gateway roadmap. No product text may promise otherwise.
yc_epic3d is in the gateway PRODUCT_MAP (Lemon Squeezy products1234163 and 1285764, gateway v0.7.0, 2026-09-30), so the gateway checks that a key belongs to Epic 3D. The pre-release check passes on this point.
run-length markers for the generated Radiance HDR lighting environment used arithmetic inside chr(). That is the same construction packers use to conceal strings, so scanner heuristics report it as obfuscation - it surfaced as a CRITICAL Wordfence finding against the WordPress port on a customer site, and the Joomla build carried the identical code. The values are compile-time constants, so they are now byte literals. The generated HDR bytes are unchanged, verified identical across six colour and intensity combinations.
Licence change. No functional change: not a line of render, element or install logic differs from 3.0.0.
decision of 2026-08-02. The manifest licence tag, LICENSE.txt, COPYRIGHT.txt, NOTICE.txt, README.md and every source header were converted, and the previous closed-source and AI-restriction clauses were removed along with them.
TERMS.txt is no longer shipped in the package. The commercial terms live at <https://www.yoozecase.com/terms> and are referenced from NOTICE.txt and README.md instead. The manifest <files> block no longer lists it.
(MIT), the bundled model-viewer build (Apache-2.0, Google LLC) and dotlottie (MIT). So are the data-processing notes a site owner needs for their processing register.
NOTICE.txt version stamp corrected; it had been left at 2.4.5 throughseveral releases.
Where to find it Plugin settings › License › License Key
The key from your YOOzeCase order confirmation. Paste it here and press Activate, which ties the key to this site. Leave it empty if you have no subscription: Epic 3D keeps working without a key, because updates are not restricted yet, so a key is a registration and not a lock. One key covers 999 sites. Press Deactivate before you move it to another site.
passwordWhere to find it Plugin settings › License › Status
Shows the last answer from the licence server and lets you activate this site or release it again. Answers are cached for 24 hours, so these buttons are the only way to force a fresh check. When the server cannot be reached the status stays as it is for another seven days instead of switching itself off.
ycepic3dlicenseWhere to find it YOOtheme builder › Epic 3D: Model › Model › Model URL (.glb / .gltf)
Direct URL to a .glb or .gltf file. Upload via the Joomla media manager and link it here.
linkWhere to find it YOOtheme builder › Epic 3D: Model › Model › Poster Image
Optional. Image displayed while the model loads.
imageWhere to find it YOOtheme builder › Epic 3D: Model › Model › Alt Text
This setting has no help text in the plugin.
text3D Model
Where to find it YOOtheme builder › Epic 3D: Model › Model › Look Preset
Curated bundles of rotation, animation, camera and lighting settings. Product Studio: slow turn, soft studio shadow, zoom off - clean e-commerce look. Hero Showcase: gentle float and slow counter-turn for landing pages. Technical Viewer: no motion, full camera freedom for inspection. Minimal: static, rotate-only, shadowless. NOTE: any preset other than Custom overrides the Rotation and Animation settings and the camera/lighting settings; switch back to Custom to control those manually. Model, layout (Style tab) and Loader are never overridden.
selectCustom (manual settings)
customproduct_studiohero_showcasetechnical_viewerminimalWhere to find it YOOtheme builder › Epic 3D: Model › Model › Model Loading
Lazy (recommended): the 3D file only downloads when the element scrolls near the viewport - keeps initial page load fast when the model sits below the fold. Eager: start downloading immediately - use for above-the-fold hero elements so the model is ready the moment it is seen.
selectLazy - load when near viewport (recommended)
lazyeagerWhere to find it YOOtheme builder › Epic 3D: Model › Motion › Auto-Rotate
This setting has no help text in the plugin.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Model › Motion › Direction
This setting has no help text in the plugin.
selectClockwise
cwccwWhere to find it YOOtheme builder › Epic 3D: Model › Motion › Rotation Speed (deg / sec)
Higher = faster spin. 30 is a relaxed pace.
range30
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Auto-Rotate Delay (ms)
How long after user stops interacting before rotation resumes.
number0
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Wrapper Animation
CSS animation applied to the whole 3D viewer container.
selectpulsefloatswayglowbouncezoomtiltwobbleheartbeatshakeWhere to find it YOOtheme builder › Epic 3D: Model › Motion › Animation Speed
This setting has no help text in the plugin.
selectNormal
slownormalfastWhere to find it YOOtheme builder › Epic 3D: Model › Motion › Animation Intensity
This setting has no help text in the plugin.
selectMedium
subtlemediumstrongWhere to find it YOOtheme builder › Epic 3D: Model › Motion › Glow Color
Colour of the glow halo around the model. Default is a soft blue.
color#6496ff
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Glow Size
Multiplier on the glow blur radius. 1 = default, 2 = twice as big, 0.5 = half as big. Combine with Animation Intensity (Subtle/Medium/Strong) for full control.
range1
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Rotate Y (turn left/right)
Permanently rotates the model around its vertical axis. Use this to correct models that were exported facing the wrong direction. -180 deg to +180 deg. Most common fix: try 90, -90, or 180.
range0
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Rotate X (tilt up/down)
Permanently tilts the model forward or backward. Useful for models exported lying on their side. -90 deg to +90 deg.
range0
Where to find it YOOtheme builder › Epic 3D: Model › Motion › Advanced orientation (roll pitch yaw)
Optional. Direct orientation string in model-viewer format: "<roll> <pitch> <yaw>" with deg or rad units. Example: "0deg 90deg 0deg". When set, overrides the sliders above. Leave empty to use the sliders.
textWhere to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Camera Controls
Allow the visitor to drag and zoom the model.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Interaction Prompt
Subtle hint that the model can be rotated by the user.
selectAuto
autowhen-focusednoneWhere to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Allow Zoom
Mouse-wheel and pinch-to-zoom interaction.
select1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Allow Pan
Right-click drag (or two-finger drag) to pan the model.
select1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Allow Rotate
Click-and-drag to rotate. Note: turning this off snaps the camera to a front-facing view (theta 0deg, phi 75deg) and conflicts with Auto-Rotate (which animates the orbit). Disable Auto-Rotate too if you want a fully locked view.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › AR Button (mobile)
Show "View in your space" button on supported mobile devices.
select1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Pause animation when interacting
When on, the wrapper animation freezes the moment the user clicks or touches the model, so they can rotate/pan/zoom without the wrapper moving. Only meaningful when a Wrapper Animation is selected.
select1Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Resume after (seconds)
How long to wait after the user stops interacting before resuming the wrapper animation. Range 0-60. Set to 0 to never auto-resume (animation stays paused until the page is reloaded).
range4
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Shadow Intensity
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Shadow Softness
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Exposure
Brightness multiplier. 1 = neutral.
range1
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Environment Lighting
Lighting that affects the model's surface. Custom Color generates a real HDR (Radiance) data URI of the chosen colour - properly tints PBR materials including metals.
selectNeutral
neutrallegacycolorWhere to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Environment Color
Tints the model evenly from all directions. Pair with Tone Mapping = Neutral or AGX for best results.
color#cccccc
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Environment Intensity
How bright the environment is. The slider uses an exponential curve, so each step roughly doubles brightness: 3 = matte (LDR ceiling), 5 = noticeable, 7 = bright, 10 = studio-bright, 13+ = metallic-friendly. Models with metallic or rough surfaces typically need 10+. If your model still looks dark at 15, the issue is the model materials themselves, not this slider.
range5
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Show as Background
When on, the chosen environment colour is also painted as the background of the model viewer. Most useful as a diagnostic ("is the environment even applying?") and for product-style scenes where the model should sit inside a coloured space rather than floating on a transparent background.
checkbox0
Where to find it YOOtheme builder › Epic 3D: Model › Camera & Lighting › Tone Mapping
This setting has no help text in the plugin.
selectNeutral
neutralagxcommercereinhardcineonWhere to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Sizing Mode
Fixed Height: classic responsive width with fixed pixel height. Aspect Ratio: canvas scales proportionally with the parent div. Fill Container: canvas matches the parent div's exact dimensions (parent must have a height set).
selectFixed Height
fixedaspectfillWhere to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Aspect Ratio
This setting has no help text in the plugin.
select16:9 (widescreen)
16/94/33/21/13/421/99/16customWhere to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Custom Aspect Ratio
Format: width/height, e.g. 16/9, 5/3, 1.5/1.
text16/9
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Width
CSS width (e.g. 100%, 500px).
text100%
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Height
CSS height (e.g. 500px, 70vh).
text500px
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Background
This setting has no help text in the plugin.
selectTransparent
transparentsolidgradientWhere to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Background / Gradient Start
This setting has no help text in the plugin.
color#f5f5f5
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Gradient End
This setting has no help text in the plugin.
color#dfdfdf
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Border Radius
CSS value (e.g. 8px, 24px, 50%).
text0
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Loader Style
How to display the loading indicator while the model is downloading. "Default" keeps the built-in thin top bar. The other options replace it with a centred indicator. "Lottie" lets you use a custom animation file.
selectDefault (model-viewer top bar)
defaultspinnerpulsedotslottieWhere to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Loader Size
Width and height of the loader in pixels. Range: 16-300 (default 80). For Lottie animations, this is the bounding box - the animation will fit inside.
range80
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Loader Color
Colour of the spinner/pulse/dot strokes. Lottie animations have their own colours baked into the file, so this setting is ignored for Lottie.
color#888888
Where to find it YOOtheme builder › Epic 3D: Model › Style & Loader › Lottie Animation URL
Direct URL to a .lottie or .json file. Upload via the Joomla media manager and paste the link here. Free Lottie files: lottiefiles.com (sign-up required for download). If empty or invalid, falls back to a CSS spinner so the loader is never blank.
textWhere to find it YOOtheme builder › Epic 3D: Model › css
This setting has no help text in the plugin.
editorWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Models
The 3D models in this grid. Each item shows as a card using its Poster Image (items without a poster get a neutral cube placeholder - posters are strongly recommended here). Clicking a card opens the model in a modal viewer.
content-itemsWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Look Preset
Curated bundles of rotation, camera and lighting settings for the modal viewer. Product Studio: slow turn, soft studio shadow - clean e-commerce look. Hero Showcase: slow counter-turn, a touch dramatic. Technical Viewer: no motion, full camera freedom. Minimal: static, rotate-only, shadowless. NOTE: any preset other than Custom overrides the Rotation and Camera/Lighting settings; switch back to Custom to control those manually. Items, grid layout, modal layout and Loader are never overridden.
selectCustom (manual settings)
customproduct_studiohero_showcasetechnical_viewerminimalWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Columns (desktop)
Number of cards per row on desktop. Tablets show at most 2, phones always 1.
select3
Where to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Gap
This setting has no help text in the plugin.
selectMedium
smallmediumlargeWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Card Text
What to show under each thumbnail.
selectTitle
titletitle_captionnoneWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Card Title Display
Below the image: the title (and caption) sit under each thumbnail, centred. On hover: the text is hidden until the visitor hovers the card, then fades in over the bottom of the image. On touch devices, where hovering is not possible, the text stays visible. Keyboard users see it when the card receives focus.
selectBelow the image
belowhoverWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Thumbnail Fit
Fit whole image (recommended): the entire poster is always visible inside the card, with the card background showing around it - nothing is ever cut off the top or bottom. Fill card: the image is scaled to cover the whole card and the overflowing edges are cropped, giving uniform edge-to-edge cards.
selectFit whole image (no cropping)
containcoverWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Auto-generate Missing Thumbnails
On by default. When a model has no Poster Image, generate the card thumbnail from the 3D model itself. The model is loaded and snapshotted in the background, one at a time, only when its card scrolls into view, and the result is cached for the visit. Note: generating a thumbnail downloads that model file, so a real Poster Image is still lighter and usually looks better - treat this as a convenient fallback for models you have not given a poster.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Hover Effect
This setting has no help text in the plugin.
selectZoom image
zoomliftnoneWhere to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Card Border Radius
CSS value (e.g. 0, 8px, 16px).
text8px
Where to find it YOOtheme builder › Epic 3D: Grid › Content & Grid › Preload on Hover
Start downloading a card's model file the moment the cursor enters it, so the modal usually opens with the model already cached. Turn off to save bandwidth on very large models.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Modal › Modal Size
This setting has no help text in the plugin.
selectMedium (900px)
smallmediumlargefullWhere to find it YOOtheme builder › Epic 3D: Grid › Modal › Modal Viewer Aspect Ratio
This setting has no help text in the plugin.
select4:3 (classic)
4/316/91/13/4Where to find it YOOtheme builder › Epic 3D: Grid › Modal › Modal Background
Background colour of the modal viewer area.
color#ffffff
Where to find it YOOtheme builder › Epic 3D: Grid › Modal › Show Title & Caption in Modal
This setting has no help text in the plugin.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Auto-Rotate
The model spins in the modal until the visitor grabs it.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Direction
This setting has no help text in the plugin.
selectClockwise
cwccwWhere to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Rotation Speed (deg / sec)
Higher = faster spin. 30 is a relaxed pace.
range30
Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Auto-Rotate Delay (ms)
How long after user stops interacting before rotation resumes.
number0
Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Camera Controls
Allow the visitor to drag and zoom the model in the modal.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Interaction Prompt
Subtle hint that the model can be rotated by the user.
selectAuto
autowhen-focusednoneWhere to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Allow Zoom
Mouse-wheel and pinch-to-zoom interaction. Default ON in the grid modal: unlike an inline element, a modal is an explicit "inspect this" context where zoom is expected.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Allow Pan
Right-click drag (or two-finger drag) to pan the model.
select1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › Allow Rotate
Click-and-drag to rotate. Note: turning this off snaps the camera to a front-facing view (theta 0deg, phi 75deg) and conflicts with Auto-Rotate (which animates the orbit). Disable Auto-Rotate too if you want a fully locked view.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Grid › Motion & Camera › AR Button (mobile)
Show "View in your space" button on supported mobile devices for the model open in the modal.
select1Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Shadow Intensity
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Shadow Softness
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Exposure
Brightness multiplier. 1 = neutral.
range1
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Environment Lighting
Lighting that affects the model's surface in the modal. Custom Color generates a real HDR (Radiance) file of the chosen colour - properly tints PBR materials including metals.
selectNeutral
neutrallegacycolorWhere to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Environment Color
Tints the model evenly from all directions. Pair with Tone Mapping = Neutral or AGX for best results.
color#cccccc
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Environment Intensity
How bright the environment is. The slider uses an exponential curve, so each step roughly doubles brightness: 3 = matte (LDR ceiling), 5 = noticeable, 7 = bright, 10 = studio-bright, 13+ = metallic-friendly. Models with metallic or rough surfaces typically need 10+. If your model still looks dark at 15, the issue is the model materials themselves, not this slider.
range5
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Show as Background
When on, the chosen environment colour is also painted as the background of the modal viewer (on top of the Modal Background colour).
checkbox0
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Tone Mapping
This setting has no help text in the plugin.
selectNeutral
neutralagxcommercereinhardcineonWhere to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Loader Style
Loading indicator shown in the modal while the model downloads. "Default" keeps the built-in thin top bar. The other options replace it with a centred indicator. "Lottie" lets you use a custom animation file.
selectDefault (model-viewer top bar)
defaultspinnerpulsedotslottieWhere to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Loader Size
Width and height of the loader in pixels. Range: 16-300 (default 80). For Lottie animations, this is the bounding box - the animation will fit inside.
range80
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Loader Color
Colour of the spinner/pulse/dot strokes. Lottie animations have their own colours baked into the file, so this setting is ignored for Lottie.
color#888888
Where to find it YOOtheme builder › Epic 3D: Grid › Lighting & Loader › Lottie Animation URL
Direct URL to a .lottie or .json file. Upload via the Joomla media manager and paste the link here. Free Lottie files: lottiefiles.com (sign-up required for download). If empty or invalid, falls back to a CSS spinner so the loader is never blank.
textWhere to find it YOOtheme builder › Epic 3D: Grid › css
This setting has no help text in the plugin.
editorWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Models
The 3D models in this gallery. Each item has its own model file, poster image, caption and orientation. Camera, lighting, style and loader settings are shared by all slides (set them in the other tabs).
content-itemsWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Look Preset
Curated bundles of rotation, animation, camera and lighting settings, applied to every slide. Product Studio: slow turn, soft studio shadow, zoom off - clean e-commerce look. Hero Showcase: gentle float and slow counter-turn for landing pages. Technical Viewer: no motion, full camera freedom for inspection. Minimal: static, rotate-only, shadowless. NOTE: any preset other than Custom overrides the Rotation and Animation settings and the camera/lighting settings; switch back to Custom to control those manually. Items, layout (Style tab) and Loader are never overridden.
selectCustom (manual settings)
customproduct_studiohero_showcasetechnical_viewerminimalWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Model Loading
Lazy (recommended): the first 3D file only downloads when the gallery scrolls near the viewport. Eager: start downloading immediately - use for above-the-fold hero galleries. Later slides always load on navigation (see Preload Next Model in the Gallery tab).
selectLazy - load when near viewport (recommended)
lazyeagerWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Navigation
How visitors move between models. Thumbnails uses each item's poster image as a clickable strip (items without a poster show a numbered button) and includes arrows.
selectArrows + Dots
arrows_dotsarrowsdotsthumbnailsWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Show Captions
Display each item's title and caption text with the slide.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Caption Position
This setting has no help text in the plugin.
selectBelow the viewer
belowoverlayWhere to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Autoplay
Advance to the next model automatically. Pauses while the visitor interacts with the model, and is disabled entirely for visitors with the OS-level reduced-motion preference.
select1Where to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Autoplay Interval (seconds)
Time each model stays on screen before advancing. Remember each slide may need a moment to download first.
range6
Where to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Preload Next Model
After the current model finishes loading, quietly download the next item's file in the background so navigation feels instant. Turn off to save bandwidth on very large models.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Content & Gallery › Auto-generate Missing Thumbnails
On by default. Only used when Navigation is set to Thumbnails: when a model has no Poster Image, the thumbnail strip button is filled with a snapshot rendered from the model itself (lazy, one at a time, cached for the visit) instead of a plain number. A real Poster Image is still lighter and usually looks better.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Motion › Auto-Rotate
This setting has no help text in the plugin.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Motion › Direction
This setting has no help text in the plugin.
selectClockwise
cwccwWhere to find it YOOtheme builder › Epic 3D: Gallery › Motion › Rotation Speed (deg / sec)
Higher = faster spin. 30 is a relaxed pace.
range30
Where to find it YOOtheme builder › Epic 3D: Gallery › Motion › Auto-Rotate Delay (ms)
How long after user stops interacting before rotation resumes.
number0
Where to find it YOOtheme builder › Epic 3D: Gallery › Motion › Wrapper Animation
CSS animation applied to the whole gallery container.
selectpulsefloatswayglowbouncezoomtiltwobbleheartbeatshakeWhere to find it YOOtheme builder › Epic 3D: Gallery › Motion › Animation Speed
This setting has no help text in the plugin.
selectNormal
slownormalfastWhere to find it YOOtheme builder › Epic 3D: Gallery › Motion › Animation Intensity
This setting has no help text in the plugin.
selectMedium
subtlemediumstrongWhere to find it YOOtheme builder › Epic 3D: Gallery › Motion › Glow Color
Colour of the glow halo around the gallery. Default is a soft blue.
color#6496ff
Where to find it YOOtheme builder › Epic 3D: Gallery › Motion › Glow Size
Multiplier on the glow blur radius. 1 = default, 2 = twice as big, 0.5 = half as big. Combine with Animation Intensity (Subtle/Medium/Strong) for full control.
range1
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Camera Controls
Allow the visitor to drag and zoom the models.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Interaction Prompt
Subtle hint that the model can be rotated by the user.
selectAuto
autowhen-focusednoneWhere to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Allow Zoom
Mouse-wheel and pinch-to-zoom interaction.
select1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Allow Pan
Right-click drag (or two-finger drag) to pan the model.
select1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Allow Rotate
Click-and-drag to rotate. Note: turning this off snaps the camera to a front-facing view (theta 0deg, phi 75deg) and conflicts with Auto-Rotate (which animates the orbit). Disable Auto-Rotate too if you want a fully locked view.
selectOn
1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › AR Button (mobile)
Show "View in your space" button on supported mobile devices. Applies to the currently shown model.
select1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Pause animation when interacting
When on, the wrapper animation freezes the moment the user clicks or touches the model, so they can rotate/pan/zoom without the wrapper moving. Only meaningful when a Wrapper Animation is selected.
select1Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Resume after (seconds)
How long to wait after the user stops interacting before resuming the wrapper animation. Range 0-60. Set to 0 to never auto-resume (animation stays paused until the page is reloaded).
range4
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Shadow Intensity
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Shadow Softness
This setting has no help text in the plugin.
range1
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Exposure
Brightness multiplier. 1 = neutral.
range1
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Environment Lighting
Lighting that affects the models' surfaces, shared by every slide. Custom Color generates a real HDR (Radiance) file of the chosen colour - properly tints PBR materials including metals.
selectNeutral
neutrallegacycolorWhere to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Environment Color
Tints the models evenly from all directions. Pair with Tone Mapping = Neutral or AGX for best results.
color#cccccc
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Environment Intensity
How bright the environment is. The slider uses an exponential curve, so each step roughly doubles brightness: 3 = matte (LDR ceiling), 5 = noticeable, 7 = bright, 10 = studio-bright, 13+ = metallic-friendly. Models with metallic or rough surfaces typically need 10+. If your model still looks dark at 15, the issue is the model materials themselves, not this slider.
range5
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Show as Background
When on, the chosen environment colour is also painted as the background of the model viewer. Most useful as a diagnostic ("is the environment even applying?") and for product-style scenes where the models should sit inside a coloured space rather than floating on a transparent background.
checkbox0
Where to find it YOOtheme builder › Epic 3D: Gallery › Camera & Lighting › Tone Mapping
This setting has no help text in the plugin.
selectNeutral
neutralagxcommercereinhardcineonWhere to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Sizing Mode
Fixed Height: classic responsive width with fixed pixel height. Aspect Ratio: canvas scales proportionally with the parent div. Fill Container: canvas matches the parent div's exact dimensions (parent must have a height set). One size applies to every slide so the page never jumps between models.
selectFixed Height
fixedaspectfillWhere to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Aspect Ratio
This setting has no help text in the plugin.
select16:9 (widescreen)
16/94/33/21/13/421/99/16customWhere to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Custom Aspect Ratio
Format: width/height, e.g. 16/9, 5/3, 1.5/1.
text16/9
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Width
CSS width (e.g. 100%, 500px).
text100%
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Height
CSS height (e.g. 500px, 70vh).
text500px
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Background
This setting has no help text in the plugin.
selectTransparent
transparentsolidgradientWhere to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Background / Gradient Start
This setting has no help text in the plugin.
color#f5f5f5
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Gradient End
This setting has no help text in the plugin.
color#dfdfdf
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Border Radius
CSS value (e.g. 8px, 24px, 50%).
text0
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Loader Style
How to display the loading indicator while a model is downloading (shown on the first load AND on every slide change while the next model downloads). "Default" keeps the built-in thin top bar. The other options replace it with a centred indicator. "Lottie" lets you use a custom animation file.
selectDefault (model-viewer top bar)
defaultspinnerpulsedotslottieWhere to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Loader Size
Width and height of the loader in pixels. Range: 16-300 (default 80). For Lottie animations, this is the bounding box - the animation will fit inside.
range80
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Loader Color
Colour of the spinner/pulse/dot strokes. Lottie animations have their own colours baked into the file, so this setting is ignored for Lottie.
color#888888
Where to find it YOOtheme builder › Epic 3D: Gallery › Style & Loader › Lottie Animation URL
Direct URL to a .lottie or .json file. Upload via the Joomla media manager and paste the link here. Free Lottie files: lottiefiles.com (sign-up required for download). If empty or invalid, falls back to a CSS spinner so the loader is never blank.
textWhere to find it YOOtheme builder › Epic 3D: Gallery › css
This setting has no help text in the plugin.
editorWhere to find it YOOtheme builder › 3D Model › Model › Model URL (.glb / .gltf)
Direct URL to a .glb or .gltf file. Upload via the Joomla media manager and link it here.
linkWhere to find it YOOtheme builder › 3D Model › Model › Poster Image
Optional but recommended in a gallery: shown while this model loads, and used as the thumbnail when Navigation is set to Thumbnails.
imageWhere to find it YOOtheme builder › 3D Model › Model › Title
Shown as the caption heading when captions are on, and as this item's label in the list on the left.
textWhere to find it YOOtheme builder › 3D Model › Model › Caption
Optional text under the title when captions are on.
textareaWhere to find it YOOtheme builder › 3D Model › Model › Alt Text
This setting has no help text in the plugin.
text3D Model
Where to find it YOOtheme builder › 3D Model › Orientation › Rotate Y (turn left/right)
Permanently rotates this model around its vertical axis. Use this to correct models that were exported facing the wrong direction. -180 to +180. Most common fix: try 90, -90, or 180.
range0
Where to find it YOOtheme builder › 3D Model › Orientation › Rotate X (tilt up/down)
Permanently tilts this model forward or backward. Useful for models exported lying on their side. -90 to +90.
range0
Where to find it YOOtheme builder › 3D Model › Orientation › Advanced orientation (roll pitch yaw)
Optional. Direct orientation string in model-viewer format: "<roll> <pitch> <yaw>" with deg or rad units. Example: "0deg 90deg 0deg". When set, overrides the sliders above. Leave empty to use the sliders.
textWe use cookies and similar technologies to improve your experience on our website. Read our Privacy Policy.