MESHYMAX LITE
=============

Free 3ds Max plugin for Meshy.ai. Generate an AI 3D model from one
image and import it straight into your scene.


REQUIREMENTS
------------

- 3ds Max 2021 or newer
- A Meshy API key (free or paid) from https://www.meshy.ai/settings/api
- Internet access


INSTALL
-------

1. Extract this folder somewhere stable, e.g. C:\MaxScripts\MeshyMaxLite\
   Keep MeshyMaxLite_Install.ms next to the MeshyMaxLite subfolder.

2. Drag MeshyMaxLite_Install.ms onto a 3ds Max viewport.

3. Add the macro to a toolbar:
   Customize > Customize User Interface > Toolbars
   Set category to "MeshyMax", drag "MeshyMax Lite" onto a toolbar.


HOW TO USE
----------

1. Click the toolbar button.

2. Paste your Meshy API key, click Save. You only do this once.
   Tip: when you create your key on the Meshy website, copy it
   straight away - Meshy only shows it once.

3. Browse for a .jpg or .png image.

4. Set options if you want, or leave the defaults.

5. Click Generate & Import. The model generates, downloads, and
   imports into your scene.


WHAT'S IN LITE
--------------

- Single image to 3D generation
- Import straight into 3ds Max
- Quad or triangle topology
- Adjustable polycount
- PBR, texture, remesh options


WHAT THE FULL VERSION ADDS
--------------------------

MeshyMax (full) is built for production workflows:

- Asset library - every model saved with tags, search, thumbnails
- Batch generation - generate from a folder of images at once
- Multi-view - sharper geometry from multiple angles
- Real-world sizing - models import at correct scale
- Drag-to-scene from the library

The full version is free inside Future-Proofed:
https://future-proofed.luxuryvisuals.com/


TROUBLESHOOTING
---------------

- glTF importer missing (Max 2022 or older): the plugin falls back
  to FBX automatically.
- 401 error: check your API key, it should start with "msy_".
- 402 error: you're out of Meshy credits, top up at meshy.ai.


DISCLAIMER
----------

MeshyMax Lite is free and provided as-is, with no warranty. By using
it you accept that it spends your Meshy API credits, that 3D
generation and import can occasionally cause scene issues, and that
the author accepts no responsibility for spent credits, scene
problems, or data loss. Save your work before generating.
Use at your own risk.


FEEDBACK
--------

Found a bug or have an idea? Leave feedback in the community:
https://www.skool.com/3dartists
