Documentation

1. Getting Started

UNCHAINED 3D is a marketplace for premium 3D live wallpapers and a companion Android launcher that brings your entire home screen to life — wallpapers, icons, widgets, and docks, all rendered in real 3D with depth, lighting, and gyroscope-driven parallax.

Install the Android Launcher

1. Download the APK from the UNCHAINED 3D GitHub release.
2. On your Android device, allow installs from "Unknown sources" for your browser/file manager when prompted.
3. Open the APK and install. Launch UNCHAINED 3D and set it as your default home/launcher when asked.
4. Browse the in-app marketplace or visit this website, tap a wallpaper, and apply it as your live wallpaper.

The launcher runs a native OpenGL renderer on-device. Wallpapers and launcher packs you purchase or download are streamed/deep-linked directly into the app.

2. For Users

Explore the Feed to discover content. Filter by type to find exactly what you want: wallpapers, 3D videos, icons, motion icons, widgets, or docks.

Applying content

• Wallpapers: open the wallpaper, tap Apply, and confirm the live wallpaper prompt. Move your phone to see the parallax.
• Docks & Widgets: long-press the home screen to enter edit mode, then drag, reposition, or drop on the trash to remove.
• Media widgets: grant the notification listener permission so play/pause, next/previous, and volume controls respond to your music.
• Free vs Premium: free items apply instantly. Premium items require connecting a wallet and completing purchase (settled on Polygon).

3. Content Specifications

These are the technical requirements the renderer expects. Creators should match them when exporting; users can use this as a reference for what each file contains.

Frame counts are the platform defaults. 3D wallpapers are rendered at a fixed 121-frameloop for smooth parallax; 3D videos use 21 angle folders so the gyroscope can switch perspective. The renderer selects the active angle from device orientation.

4. For Creators

The workflow is simple: Create → Publish → Earn.

1. Create — render in Blender with the True3D template, generate with the in-site AI tools (3D Photo, TripoSplat, Scene Splat, Ernie Image), or design widgets in the Widget Maker.
2. Publish — go to Studio, pick a content type, upload your file (see specs above), add a title/category, and set a price or mark it free.
3. Earn — receive automated payouts via a Splits contract on Polygon. You price in USD; payment settles in POL at purchase time. Creators keep 70%, the platform takes 30%. With an influencer referral, the split is 70% creator / 10% influencer / 20% platform.

Per-type upload guide

• 3D Wallpaper: MP4 or ZIP, 121 frames.
• 3D Video: a single ZIP (or 21 MP4s) containing one subfolder per camera angle (21), each with its frames.
• 3D Icon / Motion Icon / Dock: a single ZIP of the rendered asset.
• 3D Widget: a single ZIP plus native width/height and grid width/height (used by the launcher to place it on the home grid).

5. Widget Maker & Interactive Widgets

The Studio includes a built-in Widget Maker for designing 3D widgets and docks. A widget is a layout of elements with optional interaction zones:

• Buttons — tap zones mapped to functions (e.g. play, pause, next, previous).
• Sliders / Volume — drag zones for continuous control.
• D-Pad (X-Cross) — directional pads that resolve up/down/left/right.
• Media bindings — connect a zone to an app, folder, or emulator ROM (APP:, FOLDER:, ROM:).

On the home screen, long-press enters edit mode: drag widgets/docks to reposition (they snap to the grid), and drop on the trash to delete. Interactive widgets read zones from a bundled layout.svg and element map.

6. Bundles

Creators can group their existing uploads into a single Bundle product — a curated collection of wallpapers, icons, widgets, docks, and motion icons sold together, often at a discount.

• Create a bundle: open the Studio and switch to the Bundle Publisher tab. Select items from your uploads, then set a bundle name, description, and price (or mark it free).
• Buy a bundle: browse bundles in the Feed under the Bundle filter. Purchasing unlocks every item inside the bundle at once.
• Earnings: bundle sales settle the same way as individual items — via a Splits contract on Polygon (70% creator / 30% platform, or 70/10/20 with an influencer referral).

7. Influencer Referral Program

Influencers can earn a 10% commission by referring buyers to the UNCHAINED 3D marketplace. Visit the Influencer page, connect your Web3 wallet, and register a unique referral code. Share your custom link — unchained3d.xyz/?ref=YOURCODE — across your social media, YouTube descriptions, Discord, or website.

• Commission: Influencers earn 10% of the purchase price on every paid item or bundle.
• 48-Hour Attribution Window: When a user clicks your link, their session attributes all purchases made within 48 hours to your referral code.
• Site-Wide Multi-Item Attribution: Your referral applies to any item the buyer purchases on the platform — not just a specific product you shared.
• Automated 0xSplits Payouts: Revenue is split directly on-chain via Polygon smart contracts. Referred purchases automatically use a 3-way split: 70% Creator / 10% Influencer / 20% Platform (compared to the standard 70% Creator / 30% Platform). Splits are pre-deployed by the platform; funds accumulate on-chain and distribute automatically via platform cron or on-demand via dashboard.
• Real-Time Dashboard: View your live referral link, total earnings, click counts, conversions, 30-day performance charts, and top-converting items on your Profile page under the Dashboard tab.
• Anti-Fraud Policy: Self-referral purchases (buying using your own referral code) are automatically detected and excluded from commission payouts.

8. FAQ & Troubleshooting