From 9beeb821b7c159c7a9de1a21a5e69191b21fe44c Mon Sep 17 00:00:00 2001 From: Zain Ali <55154081+ZainAallii@users.noreply.github.com> Date: Wed, 5 Aug 2026 19:59:36 +0000 Subject: [PATCH] docs: consolidate 3ds Max host config scripts and document Autodesk ADP issue Flatten each per-version subfolder into a single top-level .ps1, move the sunflower_sphere example to examples/, and consolidate all per-script READMEs into the 3dsmax/README.md index. Fold the Autodesk ADP 'Failed to start' known issue for 3ds Max 2027 into that README with root cause and workaround (mirrors deadline-cloud-for-3ds-max discussion #271). Signed-off-by: Zain Ali <55154081+ZainAallii@users.noreply.github.com> --- .../3dsmax/{3dsmax-2024 => }/3dsmax-2024.ps1 | 0 .../3dsmax/3dsmax-2024/README.md | 18 --- ...rona.ps1 => 3dsmax-2025-and-corona-13.ps1} | 0 .../3dsmax-2025-and-vray.ps1 | 0 .../3dsmax/3dsmax-2025-and-vray/README.md | 36 ------ .../3dsmax-2025-vray-and-aec-plugins.ps1 | 0 .../README.md | 37 ------ .../3dsmax-2025-vray-and-tyflow.ps1 | 0 .../3dsmax-2025-vray-and-tyflow/README.md | 23 ---- .../3dsmax-2027-and-corona-14.ps1 | 0 .../3dsmax-2027-and-corona-14/README.md | 14 -- .../3dsmax-2027-and-vray-and-tyflow.ps1 | 0 .../3dsmax-2027-and-vray-and-tyflow/README.md | 16 --- .../3dsmax-2027-and-vray.ps1 | 0 .../3dsmax/3dsmax-2027-and-vray/README.md | 15 --- .../3dsmax-2027-vray-and-aec-plugins.ps1 | 0 .../README.md | 17 --- .../3dsmax/{3dsmax-2027 => }/3dsmax-2027.ps1 | 0 .../3dsmax/3dsmax-2027/README.md | 15 --- host_configuration_scripts/3dsmax/README.md | 122 +++++++++++++++--- .../sunflower_sphere/asset_references.yaml | 0 .../sunflower_sphere/parameter_values.yaml | 0 .../scene/DeadlineTest_01.max | Bin .../shamblen-studios-AwnggmGaFms-unsplash.jpg | Bin .../sunflower_sphere/sunflower_sphere.mxp | Bin .../sunflower_sphere/template.yaml | 0 skills/3dsmax-host-config/SKILL.md | 47 +++---- .../3dsmax-host-config/add-ons/aec-plugins.md | 2 +- skills/3dsmax-host-config/add-ons/corona.md | 2 +- skills/3dsmax-host-config/add-ons/tyflow.md | 2 +- skills/3dsmax-host-config/add-ons/vray.md | 2 +- 31 files changed, 131 insertions(+), 237 deletions(-) rename host_configuration_scripts/3dsmax/{3dsmax-2024 => }/3dsmax-2024.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2024/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-corona-13/3dsmax-2025-and-corona.ps1 => 3dsmax-2025-and-corona-13.ps1} (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => }/3dsmax-2025-and-vray.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2025-vray-and-aec-plugins => }/3dsmax-2025-vray-and-aec-plugins.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2025-vray-and-tyflow => }/3dsmax-2025-vray-and-tyflow.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2027-and-corona-14 => }/3dsmax-2027-and-corona-14.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2027-and-vray-and-tyflow => }/3dsmax-2027-and-vray-and-tyflow.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2027-and-vray => }/3dsmax-2027-and-vray.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2027-vray-and-aec-plugins => }/3dsmax-2027-vray-and-aec-plugins.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2027 => }/3dsmax-2027.ps1 (100%) delete mode 100644 host_configuration_scripts/3dsmax/3dsmax-2027/README.md rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/asset_references.yaml (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/parameter_values.yaml (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/scene/DeadlineTest_01.max (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/scene/shamblen-studios-AwnggmGaFms-unsplash.jpg (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/sunflower_sphere.mxp (100%) rename host_configuration_scripts/3dsmax/{3dsmax-2025-and-vray => examples}/sunflower_sphere/template.yaml (100%) diff --git a/host_configuration_scripts/3dsmax/3dsmax-2024/3dsmax-2024.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2024.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2024/3dsmax-2024.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2024.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2024/README.md b/host_configuration_scripts/3dsmax/3dsmax-2024/README.md deleted file mode 100644 index 012b07df..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2024/README.md +++ /dev/null @@ -1,18 +0,0 @@ -# Sample Host Configuration scripts to install 3ds Max to Service Managed Fleets for AWS Deadline Cloud - -## 3ds Max -3ds Max is a popular Digital Content Creation tool provided by Autodesk. 3ds Max runs on Windows, and requires administrative access to install onto a host. Because of the administrative requirement, Deadline Cloud recommends installing 3ds Max on to the worker host using Host Configuration Scripts. - -- While the example installs 3ds Max 2024, Deadline Cloud's submitter supports 3ds Max 2025 and 2026 as well. The installation script should work equivalently for 3ds Max 2025 and 2026. - -## Installation guide -1. Create a S3 bucket in the same region as your farm. -2. Download the 3ds Max installer from Autodesk, and zip up the installer following [these steps](/host_configuration_scripts/3dsmax/README.md#creating-a-3ds-max-installer-archive-in-zip-format). -3. Upload to your S3 bucket and save the S3 URI. -4. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2024.ps1](./3dsmax-2024.ps1). -5. Save the fleet configuration. -6. Configure the Fleet IAM role to have S3 bucket access. -7. Recommendation: Set the fleet's min worker count to 1. Review a worker's CloudWatch log to ensure the script is executed successfully prior to production use. - -## Detailed Step by Step installation guide -Blog - [Coming soon] diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13/3dsmax-2025-and-corona.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13/3dsmax-2025-and-corona.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/3dsmax-2025-and-vray.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/3dsmax-2025-and-vray.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2025-and-vray.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/README.md b/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/README.md deleted file mode 100644 index 459b1589..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/README.md +++ /dev/null @@ -1,36 +0,0 @@ -# Sample Host Configuration scripts to install 3ds Max 2025 and V-Ray to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration scripts configures your Service Managed Fleet with 3ds Max 2025 and V-Ray to render your 3ds Max 2025 jobs with V-Ray. - -## V-Ray -V-Ray is a professional rendering engine developed by Chaos Group for 3D computer graphics applications. V-Ray integrates as a plugin with 3ds Max, providing photorealistic ray-traced rendering capabilities. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer according to [these steps](/host_configuration_scripts/3dsmax/README.md#creating-a-3ds-max-installer-archive-in-zip-format), and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2025 installer from Chaos and upload it to your S3 bucket - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2025-and-vray.ps1](./3dsmax-2025-and-vray.ps1). - - Note that there are placeholder variables at the start of the script marked with `TODO`. Please replace the values with ones matching your configuration. -5. Save the fleet configuration. -6. Configure your Fleet's IAM role to have read access to your S3 bucket. -7. Recommendation: Set the fleet's min worker count to 1. Review a worker's CloudWatch log to ensure the script is executed successfully prior to production use. - -## Test Job Bundle Submission - -You can submit a test job bundle included in this example script (`sunflower_sphere`) to make sure your workers have 3ds Max and V-Ray configured correctly before setting up your workstation. - -### Prerequisites - -- You either have the [AWS Deadline Cloud Client](https://pypi.org/project/deadline/) Python package installed, or the [Deadline Cloud Submitter](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html) installed -- You either have [Deadline Cloud Monitor](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/monitor-onboarding.html) installed and are logged into it or have AWS credentials available with sufficient permissions to submit the job (e.g. `deadline:CreateJob` and `s3:PutObject` to your Job Attachments bucket) - -### Job Bundle Submission Steps - -1. Open up a terminal -2. Navigate to the `sunflower_sphere` folder in this directory (e.g. `cd sunflower_sphere`) -3. Submit the bundle using the `deadline` CLI - - With a GUI: `deadline bundle gui-submit .` - - No GUI: `deadline bundle submit .` -4. Once the job submission completes, you can monitor job progress using the Deadline Cloud Monitor or the web monitor, or through the AWS Deadline Cloud APIs. -5. After the job completes, download the output. It should be a sphere with a sunflower texture pattern on it. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/3dsmax-2025-vray-and-aec-plugins.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/3dsmax-2025-vray-and-aec-plugins.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/README.md b/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/README.md deleted file mode 100644 index e5a601ab..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/README.md +++ /dev/null @@ -1,37 +0,0 @@ -# Sample Host Configuration scripts to install 3ds Max 2025, V-Ray, and AEC plugins to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2025, V-Ray, Forest Pack, RailClone, and additional AEC plugins to render your 3ds Max 2025 jobs with V-Ray and architectural visualization plugins. - -## V-Ray -V-Ray is a professional rendering engine developed by Chaos Group for 3D computer graphics applications. V-Ray integrates as a plugin with 3ds Max, providing photorealistic ray-traced rendering capabilities. - -## Forest Pack -Forest Pack is a plugin for 3ds Max that provides scattering and distribution tools for creating realistic forests, vegetation, and other scattered objects in architectural and environmental visualizations. - -## RailClone -RailClone is a parametric modeling plugin for 3ds Max that enables the creation of complex linear and area-based structures like fences, roads, buildings, and architectural elements. - -## Additional Plugins -This script also installs FloorGenerator and MultiTexture plugins for enhanced architectural visualization capabilities. - -## Version Compatibility -This script can be adapted for other compatible versions by updating the variable names and paths: -- 3ds Max 2026 or other versions -- V-Ray 7 or compatible versions -- Compatible versions of Forest Pack, RailClone, and other AEC plugins - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer following [these steps](/host_configuration_scripts/3dsmax/README.md#creating-a-3ds-max-installer-archive-in-zip-format), and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2025 installer from Chaos and upload it to your S3 bucket. - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Download the Forest Pack installer from iToo Software and upload it to your S3 bucket. -5. Download the RailClone installer from iToo Software and upload it to your S3 bucket. -6. Download the FloorGenerator and MultiTexture plugin files and upload them to your S3 bucket. -7. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2025-vray-and-aec-plugins.ps1](./3dsmax-2025-vray-and-aec-plugins.ps1). - - Note that there are placeholder variables at the start of the script marked with `TODO`. Please replace the values with ones matching your configuration. - - The plugin installation sections can be adapted for other 3ds Max versions by updating the plugins directory path to match your target version. -8. Save the fleet configuration. - - Configuration changes only affect Worker instances launched after this update is applied. Existing Workers will continue using the previous configuration. -9. Configure your Fleet's IAM role to have read access to your S3 bucket. -10. For testing: Set the fleet's min Worker count to 1 which will spin up a Worker and run the Host Configuration script on it. Review Worker's CloudWatch logs (found in the `/aws/deadline/farm-/fleet-` log group) to ensure the script is executed successfully on the Worker prior to production use. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/3dsmax-2025-vray-and-tyflow.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/3dsmax-2025-vray-and-tyflow.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/README.md b/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/README.md deleted file mode 100644 index baf57971..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/README.md +++ /dev/null @@ -1,23 +0,0 @@ -# Sample Host Configuration scripts to install 3ds Max 2025, V-Ray and tyFlow to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2025, V-Ray, and tyFlow to render your 3ds Max 2025 jobs with V-Ray and tyFlow plugins. - -## V-Ray -V-Ray is a professional rendering engine developed by Chaos Group for 3D computer graphics applications. V-Ray integrates as a plugin with 3ds Max, providing photorealistic ray-traced rendering capabilities. - -## tyFlow -tyFlow is a powerful particle system and physics simulation plugin for 3ds Max, enabling complex procedural animations and effects. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer following [these steps](/host_configuration_scripts/3dsmax/README.md#creating-a-3ds-max-installer-archive-in-zip-format), and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2025 installer from Chaos and upload it to your S3 bucket. - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Download the tyFlow plugin file and upload it to your S3 bucket. -5. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2025-vray-and-tyflow.ps1](./3dsmax-2025-vray-and-tyflow.ps1). - - Note that there are placeholder variables at the start of the script marked with `TODO`. Please replace the values with ones matching your configuration. - - The tyFlow installation section (lines 57-62) can be adapted for other 3ds Max versions by updating the plugins directory path to match your target version. -6. Save the fleet configuration. - - Configuration changes only affect Worker instances launched after this update is applied. Existing Workers will continue using the previous configuration. -7. Configure your Fleet's IAM role to have read access to your S3 bucket. -8. For testing: Set the fleet's min Worker count to 1 which will spin up a Worker and run the Host Configuration script on it. Review Worker's CloudWatch logs (found in the `/aws/deadline/farm-/fleet-` log group) to ensure the script is executed successfully on the Worker prior to production use. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/3dsmax-2027-and-corona-14.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/3dsmax-2027-and-corona-14.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/README.md b/host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/README.md deleted file mode 100644 index a66016f2..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2027-and-corona-14/README.md +++ /dev/null @@ -1,14 +0,0 @@ -# Sample Host Configuration script to install 3ds Max 2027 and Corona 14 to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2027 and Corona 14. Corona 14 is the first version to support 3ds Max 2027. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer, and upload it to your S3 bucket. -3. Download the Corona 14 for 3ds Max installer from Chaos and upload it to your S3 bucket. -4. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2027-and-corona-14.ps1](./3dsmax-2027-and-corona-14.ps1). - - Replace the `TODO` variables at the top with your S3 URIs. -5. Save the fleet configuration. -6. Configure your Fleet's IAM role to have `s3:GetObject` access to your S3 bucket. -7. Recommendation: Set the fleet's min Worker count to 1. Review the Worker's CloudWatch logs (`/aws/deadline/farm-/fleet-`) to verify the script runs successfully before production use. - - Configuration changes only affect Workers launched after the update is applied. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/3dsmax-2027-and-vray-and-tyflow.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/3dsmax-2027-and-vray-and-tyflow.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/README.md b/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/README.md deleted file mode 100644 index 74854fd9..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray-and-tyflow/README.md +++ /dev/null @@ -1,16 +0,0 @@ -# Sample Host Configuration script to install 3ds Max 2027, V-Ray, and tyFlow to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2027, V-Ray, and tyFlow. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer, and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2027 installer from Chaos and upload it to your S3 bucket. - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Download the tyFlow plugin file for 3ds Max 2027 and upload it to your S3 bucket. -5. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2027-and-vray-and-tyflow.ps1](./3dsmax-2027-and-vray-and-tyflow.ps1). - - Replace the `TODO` variables at the top with your S3 URIs. -6. Save the fleet configuration. -7. Configure your Fleet's IAM role to have `s3:GetObject` access to your S3 bucket. -8. Recommendation: Set the fleet's min Worker count to 1. Review the Worker's CloudWatch logs (`/aws/deadline/farm-/fleet-`) to verify the script runs successfully before production use. - - Configuration changes only affect Workers launched after the update is applied. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/3dsmax-2027-and-vray.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/3dsmax-2027-and-vray.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2027-and-vray.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/README.md b/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/README.md deleted file mode 100644 index 3466ae0c..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2027-and-vray/README.md +++ /dev/null @@ -1,15 +0,0 @@ -# Sample Host Configuration script to install 3ds Max 2027 and V-Ray to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2027 and V-Ray. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer, and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2027 installer from Chaos and upload it to your S3 bucket. - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2027-and-vray.ps1](./3dsmax-2027-and-vray.ps1). - - Replace the `TODO` variables at the top with your S3 URIs. -5. Save the fleet configuration. -6. Configure your Fleet's IAM role to have `s3:GetObject` access to your S3 bucket. -7. Recommendation: Set the fleet's min Worker count to 1. Review the Worker's CloudWatch logs (`/aws/deadline/farm-/fleet-`) to verify the script runs successfully before production use. - - Configuration changes only affect Workers launched after the update is applied. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/3dsmax-2027-vray-and-aec-plugins.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/3dsmax-2027-vray-and-aec-plugins.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/README.md b/host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/README.md deleted file mode 100644 index 8e345523..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2027-vray-and-aec-plugins/README.md +++ /dev/null @@ -1,17 +0,0 @@ -# Sample Host Configuration script to install 3ds Max 2027, V-Ray, and AEC plugins to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2027, V-Ray, Forest Pack, RailClone, FloorGenerator, and MultiTexture. - -## Installation guide -1. Create an S3 bucket in your AWS account. -2. Download the 3ds Max installer from Autodesk, zip up the installer, and upload it to your S3 bucket. -3. Download the V-Ray for 3ds Max 2027 installer from Chaos and upload it to your S3 bucket. - - WARNING: Do not rename the V-Ray installer executable. The installer may silently fail if you give it a new name after downloading it from the Chaos Group website -4. Download the Forest Pack and RailClone installers from iToo Software and upload them to your S3 bucket. -5. Download the FloorGenerator and MultiTexture plugin files and upload them to your S3 bucket. -6. Configure the Windows Service Managed fleet's host configuration using [3dsmax-2027-vray-and-aec-plugins.ps1](./3dsmax-2027-vray-and-aec-plugins.ps1). - - Replace the `TODO` variables at the top with your S3 URIs. -7. Save the fleet configuration. -8. Configure your Fleet's IAM role to have `s3:GetObject` access to your S3 bucket. -9. Recommendation: Set the fleet's min Worker count to 1. Review the Worker's CloudWatch logs (`/aws/deadline/farm-/fleet-`) to verify the script runs successfully before production use. - - Configuration changes only affect Workers launched after the update is applied. diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027/3dsmax-2027.ps1 b/host_configuration_scripts/3dsmax/3dsmax-2027.ps1 similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2027/3dsmax-2027.ps1 rename to host_configuration_scripts/3dsmax/3dsmax-2027.ps1 diff --git a/host_configuration_scripts/3dsmax/3dsmax-2027/README.md b/host_configuration_scripts/3dsmax/3dsmax-2027/README.md deleted file mode 100644 index f3977f13..00000000 --- a/host_configuration_scripts/3dsmax/3dsmax-2027/README.md +++ /dev/null @@ -1,15 +0,0 @@ -# Sample Host Configuration script to install 3ds Max 2027 to Service Managed Fleets for AWS Deadline Cloud - -This sample host configuration script configures your Service Managed Fleet with 3ds Max 2027 to render your 3ds Max 2027 jobs. - -## Installation guide -1. Create an S3 bucket in the same region as your Deadline Cloud farm. -2. Download the 3ds Max 2027 installer from Autodesk, zip up the installer folder, and upload it to your S3 bucket. -3. Configure the Windows Service Managed Fleet's host configuration using [3dsmax-2027.ps1](./3dsmax-2027.ps1). - - Note that there are placeholder variables at the start of the script marked with `TODO`. Replace the values with ones matching your configuration. -4. Save the fleet configuration. -5. Configure your Fleet's IAM role to have `s3:GetObject` access to your S3 bucket. -6. Recommendation: Set the fleet's min worker count to 1. Review a worker's CloudWatch log to ensure the script executes successfully prior to production use. - - Log group: `/aws/deadline/farm-/fleet-` - -> Host configuration changes only affect Workers launched after the update is applied. Existing workers will not be updated. diff --git a/host_configuration_scripts/3dsmax/README.md b/host_configuration_scripts/3dsmax/README.md index b815eda7..5302bb4f 100644 --- a/host_configuration_scripts/3dsmax/README.md +++ b/host_configuration_scripts/3dsmax/README.md @@ -2,24 +2,116 @@ These Windows host configuration scripts install 3ds Max and selected renderers or plugins on AWS Deadline Cloud service-managed fleet workers. 3ds Max requires administrative installation, so host configuration is the recommended delivery boundary. +Each script is self-contained: it downloads the installers you stage in your own S3 bucket and runs their silent installs. Replace the `TODO` variables at the top of the script with your S3 URIs before using it. + ## Sample index -This table covers every immediate sample directory in `host_configuration_scripts/3dsmax/`. +Scripts are grouped by 3ds Max version. Each installs the listed software. Some need extra vendor installers that you stage in S3 (see the notes column). + +### 3ds Max 2024 + +| Script | Installs | Extra installers to stage | +|---|---|---| +| [3dsmax-2024.ps1](3dsmax-2024.ps1) | Base 3ds Max 2024 | None | + +### 3ds Max 2025 -| Sample | What it demonstrates | Start here when | +| Script | Installs | Extra installers to stage | |---|---|---| -| [3ds Max 2024](3dsmax-2024/) | Installing the base 2024 application | You need 3ds Max 2024 without bundled render plugins | -| [3ds Max 2025 and Corona 13](3dsmax-2025-and-corona-13/) | Installing 3ds Max with Corona Renderer | Your 2025 scenes render with Corona 13 | -| [3ds Max 2025 and V-Ray](3dsmax-2025-and-vray/) | Installing 3ds Max and V-Ray together | Your 2025 scenes use V-Ray | -| [3ds Max 2025, V-Ray, and AEC plugins](3dsmax-2025-vray-and-aec-plugins/) | Adding Forest Pack, RailClone, and architectural visualization plugins | A 2025 V-Ray workload uses common AEC plugins | -| [3ds Max 2025, V-Ray, and tyFlow](3dsmax-2025-vray-and-tyflow/) | Installing V-Ray and tyFlow with 3ds Max | A 2025 workload combines rendering and particle simulation | -| [3ds Max 2027](3dsmax-2027/) | Installing the base 2027 application | You need 3ds Max 2027 without bundled render plugins | -| [3ds Max 2027 and Corona 14](3dsmax-2027-and-corona-14/) | Installing the first Corona version supporting 3ds Max 2027 | Your 2027 scenes render with Corona 14 | -| [3ds Max 2027 and V-Ray](3dsmax-2027-and-vray/) | Installing 3ds Max 2027 and V-Ray | Your 2027 scenes use V-Ray | -| [3ds Max 2027, V-Ray, and tyFlow](3dsmax-2027-and-vray-and-tyflow/) | Installing V-Ray and tyFlow with 3ds Max 2027 | A 2027 workload combines rendering and particle simulation | -| [3ds Max 2027, V-Ray, and AEC plugins](3dsmax-2027-vray-and-aec-plugins/) | Adding Forest Pack, RailClone, FloorGenerator, and MultiTexture | A 2027 V-Ray workload uses architectural visualization plugins | - -The samples currently cover 3ds Max 2024, 2025, and 2027. The Deadline Cloud submitter also supports 3ds Max 2026. Adapt the nearest script for that installer and verify all product-specific silent-install options. +| [3dsmax-2025-and-corona-13.ps1](3dsmax-2025-and-corona-13.ps1) | 3ds Max 2025 + Corona 13 | Corona 13 (Chaos) | +| [3dsmax-2025-and-vray.ps1](3dsmax-2025-and-vray.ps1) | 3ds Max 2025 + V-Ray | V-Ray (Chaos) | +| [3dsmax-2025-vray-and-aec-plugins.ps1](3dsmax-2025-vray-and-aec-plugins.ps1) | 3ds Max 2025 + V-Ray + Forest Pack + RailClone + FloorGenerator + MultiTexture | V-Ray (Chaos); Forest Pack & RailClone (iToo); FloorGenerator; MultiTexture | +| [3dsmax-2025-vray-and-tyflow.ps1](3dsmax-2025-vray-and-tyflow.ps1) | 3ds Max 2025 + V-Ray + tyFlow | V-Ray (Chaos); tyFlow | + +### 3ds Max 2027 + +| Script | Installs | Extra installers to stage | +|---|---|---| +| [3dsmax-2027.ps1](3dsmax-2027.ps1) | Base 3ds Max 2027 | None | +| [3dsmax-2027-and-corona-14.ps1](3dsmax-2027-and-corona-14.ps1) | 3ds Max 2027 + Corona 14 (first Corona to support 2027) | Corona 14 (Chaos) | +| [3dsmax-2027-and-vray.ps1](3dsmax-2027-and-vray.ps1) | 3ds Max 2027 + V-Ray | V-Ray (Chaos) | +| [3dsmax-2027-and-vray-and-tyflow.ps1](3dsmax-2027-and-vray-and-tyflow.ps1) | 3ds Max 2027 + V-Ray + tyFlow | V-Ray (Chaos); tyFlow | +| [3dsmax-2027-vray-and-aec-plugins.ps1](3dsmax-2027-vray-and-aec-plugins.ps1) | 3ds Max 2027 + V-Ray + Forest Pack + RailClone + FloorGenerator + MultiTexture | V-Ray (Chaos); Forest Pack & RailClone (iToo); FloorGenerator; MultiTexture | + +The samples cover 3ds Max 2024, 2025, and 2027. The Deadline Cloud submitter also supports 3ds Max 2026. Adapt the nearest script for that installer and verify all product-specific silent-install options. + +> **Using 3ds Max 2027?** Read [Known issue: Autodesk ADP "Failed to start"](#known-issue-autodesk-adp-failed-to-start-3ds-max-2027) before provisioning a fleet. + +## Installation guide + +The steps are the same for every script. Only the installers you stage in S3 differ (see the "Extra installers" column above). + +1. Create an S3 bucket in your AWS account (same region as your farm recommended). +2. Download the 3ds Max installer from Autodesk and zip it following [Creating a 3ds Max installer archive in .zip format](#creating-a-3ds-max-installer-archive-in-zip-format), then upload it to your S3 bucket. +3. Download any extra installers listed for your chosen script (V-Ray, Corona, tyFlow, Forest Pack, RailClone, FloorGenerator, MultiTexture) from their vendors and upload them to your S3 bucket. + - **V-Ray:** do not rename the V-Ray installer executable. It may silently fail if renamed after download from Chaos. +4. Configure the Windows service-managed fleet's host configuration with your chosen script, and replace the `TODO` variables at the top with your S3 URIs. +5. Save the fleet configuration. +6. Grant the fleet's IAM role `s3:GetObject` access to your S3 bucket. +7. Recommendation: set the fleet's min worker count to 1 and review the worker's CloudWatch logs (`/aws/deadline/farm-/fleet-`) to confirm the script runs successfully before production use. + +> Host configuration changes only affect workers launched after the update is applied. Existing workers are not updated. + +## Test job bundle (V-Ray) + +[`examples/sunflower_sphere/`](examples/sunflower_sphere/) is a ready-to-submit job bundle for verifying that a worker has 3ds Max and V-Ray configured correctly. + +### Prerequisites + +- The [AWS Deadline Cloud client](https://pypi.org/project/deadline/) or the [Deadline Cloud submitter](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html) installed. +- [Deadline Cloud monitor](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/monitor-onboarding.html) logged in, or AWS credentials with permission to submit the job (e.g. `deadline:CreateJob` and `s3:PutObject` to your job attachments bucket). + +### Steps + +1. From `examples/sunflower_sphere/`, submit with the `deadline` CLI: + - GUI: `deadline bundle gui-submit .` + - No GUI: `deadline bundle submit .` +2. Monitor progress in the Deadline Cloud monitor or through the APIs. +3. After the job completes, download the output, a sphere with a sunflower texture pattern. + +## Known issue: Autodesk ADP "Failed to start" (3ds Max 2027) + +3ds Max 2027 launched in server mode (`3dsmaxbatch.exe` / `3dsmaxcmd.exe`, as render nodes do) can abort during startup with `ADP Failed to start` (exit code `-12`) when the launching user is opted out of the Autodesk Analytics Program (ADP). This blocks all rendering on affected workers. It applies to every 3ds Max 2027 script above (`3dsmax-2027`, `3dsmax-2027-and-vray`, `3dsmax-2027-and-corona-14`, `3dsmax-2027-and-vray-and-tyflow`, `3dsmax-2027-vray-and-aec-plugins`). This mirrors [deadline-cloud-for-3ds-max discussion #271](https://github.com/aws-deadline/deadline-cloud-for-3ds-max/discussions/271). + +The 3ds Max log shows: + +``` +ADP Initialize: OptedOut +Starting network +ADP Failed to start +3ds Max Exit Code = -12 +``` + +### Root cause + +The failure occurs when the launching user is opted out of ADP. The opted-out path runs a "Starting network" step that cold-starts the Autodesk SSO server app `AdSSO.exe`. That executable is not installed: the ADP SDK bundled with 3ds Max 2027 still expects the legacy `AdSSO.exe`, but the installed Autodesk Identity Manager provides `AdSSOServices.dll` / `AdskIdentityManager.exe` and no `AdSSO.exe`. The SSO cold-start times out, ADP reports failure, and Max exits `-12`. The opted-in path (`ADP Initialize: Done`) skips the SSO step entirely. + +Render nodes hit this because they run in server mode and their service account defaults to opted out. It is not headless-specific (a server-mode launch while opted out fails on an interactive workstation too) and not a Deadline Cloud issue (it reproduces with a plain `3dsmaxbatch.exe` launch). + +### Workarounds + +1. **Use 3ds Max 2026 render nodes** (not affected). +2. **Record an ADP opt-in consent for the render user before launch**, if you agree to it. Writing `%APPDATA%\Autodesk\ADPSDK\UserConsent\UnNamed.json` with all `optIn: true` and `userActionRequired: false` makes ADP reach `Done` so 3ds Max starts normally. On a service-managed fleet, write the file into the Default user profile from your host configuration script so every new profile (including the render service account) inherits it: + + ```powershell + $consentDir = "C:\Users\Default\AppData\Roaming\Autodesk\ADPSDK\UserConsent" + New-Item -ItemType Directory -Path $consentDir -Force | Out-Null + $consent = @{ + preferences = @( + @{ consentId = "ADSK_PUD_CONTRACTUAL_NECESSITY_DESKTOP"; optIn = $true }, + @{ consentId = "ADSK_PUD_OPTIMIZATION_IMPROVEMENT_DESKTOP"; optIn = $true }, + @{ consentId = "ADSK_PUD_GO_TO_MARKET_DESKTOP"; optIn = $true } + ) + userActionRequired = $false + userId = "UnNamed" + } + $consent | ConvertTo-Json -Depth 5 | + Set-Content -Path (Join-Path $consentDir "UnNamed.json") -Encoding UTF8 + ``` + + Writing this file records consent to Autodesk's analytics program. Apply it only if you accept that. Tooling should not opt users in on their behalf. Recording consent is a host-configuration or administrator step, not something the submitter or adaptor does automatically. + +Opting out does not work: the same file with `optIn: false` still fails. A proper fix must come from Autodesk (make the opted-out server-mode path non-fatal, or provide a way to fully disable ADP). ## Generate a script for another version with Kiro @@ -37,7 +129,7 @@ The samples cover specific combinations. To create a script for another 3ds Max * `Create a host configuration script for 3ds Max 2026 and V-Ray 8` * `Create a host configuration script for 3ds Max 2027 and Corona 14` * `Add a host configuration script for 3ds Max 2026 with Forest Pack 10` -2. Kiro reads [`skills/3dsmax-host-config/SKILL.md`](../../skills/3dsmax-host-config/SKILL.md) and generates a script and README for the requested combination. +2. Kiro reads [`skills/3dsmax-host-config/SKILL.md`](../../skills/3dsmax-host-config/SKILL.md) and generates a `.ps1` script in this directory, then adds a row to the sample index above. 3. Review and test the generated script, replace its `TODO` values with your S3 bucket and installer names, and then configure the fleet. ## Common prerequisites diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/asset_references.yaml b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/asset_references.yaml similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/asset_references.yaml rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/asset_references.yaml diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/parameter_values.yaml b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/parameter_values.yaml similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/parameter_values.yaml rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/parameter_values.yaml diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/scene/DeadlineTest_01.max b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/scene/DeadlineTest_01.max similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/scene/DeadlineTest_01.max rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/scene/DeadlineTest_01.max diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/scene/shamblen-studios-AwnggmGaFms-unsplash.jpg b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/scene/shamblen-studios-AwnggmGaFms-unsplash.jpg similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/scene/shamblen-studios-AwnggmGaFms-unsplash.jpg rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/scene/shamblen-studios-AwnggmGaFms-unsplash.jpg diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/sunflower_sphere.mxp b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/sunflower_sphere.mxp similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/sunflower_sphere.mxp rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/sunflower_sphere.mxp diff --git a/host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/template.yaml b/host_configuration_scripts/3dsmax/examples/sunflower_sphere/template.yaml similarity index 100% rename from host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere/template.yaml rename to host_configuration_scripts/3dsmax/examples/sunflower_sphere/template.yaml diff --git a/skills/3dsmax-host-config/SKILL.md b/skills/3dsmax-host-config/SKILL.md index fbe463b6..233a7a09 100644 --- a/skills/3dsmax-host-config/SKILL.md +++ b/skills/3dsmax-host-config/SKILL.md @@ -51,7 +51,7 @@ use the `host-config-from-installer` skill instead. - `Path`: also add the Python and Scripts dirs - Every script MUST install `deadline-cloud-for-3ds-max` via the bundled Python pip - Scripts MUST end with `Exit 0` -- Each script lives in its own subfolder alongside a `README.md` +- Each script lives directly under `host_configuration_scripts/3dsmax/`; a single shared `README.md` there documents every script with one sample-index row ## Workflow @@ -68,20 +68,20 @@ Ask the user (if not already specified): Look in `host_configuration_scripts/3dsmax/` for the most similar existing script and read it in full. -**If updating an existing script** (e.g. bumping 3ds Max 2025 → 2026, or V-Ray 7 → 8): -- Create a new folder and script. Do not edit the existing one +**If updating an existing script** (e.g. bumping 3ds Max 2025 to 2026, or V-Ray 7 to 8): +- Create a new script at the directory root. Do not edit the existing one - Update every version occurrence: `$VARIABLES`, `Write-Host` messages, install paths, env var names - (e.g. `VRAY_FOR_3DSMAX2025_MAIN` → `VRAY_FOR_3DSMAX2026_MAIN`) + (e.g. `VRAY_FOR_3DSMAX2025_MAIN` to `VRAY_FOR_3DSMAX2026_MAIN`) -### Step 3: Determine folder and file names +### Step 3: Determine the script file name -Follow the existing naming convention: -- Base only: `3dsmax-/3dsmax-.ps1` -- One plugin: `3dsmax--and-/3dsmax--and-.ps1` -- Multiple plugins: `3dsmax---and-/...` +Scripts live directly under `host_configuration_scripts/3dsmax/` (no per-script subfolder). Follow the existing naming convention: -When in doubt, look at existing folder names in `host_configuration_scripts/3dsmax/`. +- Base only: `3dsmax-.ps1` +- One plugin: `3dsmax--and-.ps1` +- Multiple plugins: `3dsmax---and-.ps1` +When in doubt, look at the existing script names in `host_configuration_scripts/3dsmax/`. ### Step 4: Write the script Structure: @@ -96,14 +96,14 @@ Structure: Key patterns: ```powershell -# TODO variables — one full S3 URI per installer/plugin +# TODO variables: one full S3 URI per installer/plugin # Guide on how to create the 3ds Max installer zip file: https://github.com/aws-deadline/deadline-cloud-samples/blob/mainline/host_configuration_scripts/3dsmax/README.md $3DS_MAX_INSTALLER_ZIP_S3_URI="s3://your-bucket-name/path/to/3ds-max-.zip" # Download from S3 using the URI variable directly aws s3 cp --no-progress "$3DS_MAX_INSTALLER_ZIP_S3_URI" C:\3dsmax_setup\3dsmax.zip -# Install 3ds Max silently — Setup.exe is at the root after extracting +# Install 3ds Max silently. Setup.exe is at the root after extracting Start-Process "C:\3dsmax_setup\Setup.exe" -ArgumentList '-q' -Wait # Set env vars @@ -114,16 +114,14 @@ Start-Process "C:\3dsmax_setup\Setup.exe" -ArgumentList '-q' -Wait & "C:\Program Files\Autodesk\3ds Max $VERSION\Python\python.exe" -m pip install deadline-cloud-for-3ds-max ``` -### Step 5: Write the README.md +### Step 5: Document the script in the shared README -Follow the style of `3dsmax-2025-and-vray/README.md`. Include: -- Title and one-line description -- Brief description of any plugins -- Installation guide (S3 bucket, upload installers, configure fleet, save, IAM role, test) -- Note about TODO variables -- Note that config changes only affect Workers launched after the update -- CloudWatch log group: `/aws/deadline/farm-/fleet-` +All scripts share a single `host_configuration_scripts/3dsmax/README.md`. Do NOT create a per-script README. Add a row for the new script to the sample-index table under its 3ds Max version section (`### 3ds Max `) with: +- A link to the `.ps1` +- What it installs +- Extra vendor installers to stage in S3 (V-Ray, Corona, tyFlow, Forest Pack, RailClone, etc.), or a dash if none +If a `### 3ds Max ` section does not exist yet, add one in version order. ### Step 6: Test the script locally and on a fleet worker Before considering the script done: @@ -135,16 +133,11 @@ Before considering the script done: 3. Configure a Service Managed Fleet with the script, set min worker count to 1, and wait for a worker to start 4. If the script includes V-Ray, submit the `sunflower_sphere` test bundle against the fleet to verify rendering works end-to-end: ``` - deadline bundle submit host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/sunflower_sphere + deadline bundle submit host_configuration_scripts/3dsmax/examples/sunflower_sphere ``` The job should complete and produce a rendered sphere with a sunflower texture. 5. For other plugin combinations, create a minimal job bundle that exercises the plugin and submit it to the fleet to confirm the setup is good before production use. -### Step 7: Update the top-level README - -Check `host_configuration_scripts/3dsmax/README.md` and update if the new script introduces a -version or plugin not already listed. - ## Common Mistakes - Using a shared `$BUCKET_NAME` variable. Each installer must have its own full S3 URI variable instead @@ -154,4 +147,4 @@ version or plugin not already listed. - Using `&&` as a command separator. PowerShell uses `;` or separate lines - Forgetting `-m ensurepip` before `-m pip install` - When bumping versions: forgetting to update year suffixes in env var names - (e.g. `VRAY_FOR_3DSMAX2025_MAIN` → `VRAY_FOR_3DSMAX2026_MAIN`) + (e.g. `VRAY_FOR_3DSMAX2025_MAIN` to `VRAY_FOR_3DSMAX2026_MAIN`) diff --git a/skills/3dsmax-host-config/add-ons/aec-plugins.md b/skills/3dsmax-host-config/add-ons/aec-plugins.md index cb349b69..cbe6212a 100644 --- a/skills/3dsmax-host-config/add-ons/aec-plugins.md +++ b/skills/3dsmax-host-config/add-ons/aec-plugins.md @@ -5,7 +5,7 @@ and FloorGenerator and MultiTexture (by CG-Source). Use any combination as neede ## Reference Script -See `host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins/3dsmax-2025-vray-and-aec-plugins.ps1` for a working example. +See `host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-aec-plugins.ps1` for a working example. ## What to add to the script diff --git a/skills/3dsmax-host-config/add-ons/corona.md b/skills/3dsmax-host-config/add-ons/corona.md index a4e36ac3..b21ac727 100644 --- a/skills/3dsmax-host-config/add-ons/corona.md +++ b/skills/3dsmax-host-config/add-ons/corona.md @@ -5,7 +5,7 @@ It shares the same licensing structure as V-Ray. ## Reference Script -See `host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13/3dsmax-2025-and-corona.ps1` for a working example. +See `host_configuration_scripts/3dsmax/3dsmax-2025-and-corona-13.ps1` for a working example. ## What to add to the script diff --git a/skills/3dsmax-host-config/add-ons/tyflow.md b/skills/3dsmax-host-config/add-ons/tyflow.md index 0b82280d..23ccea37 100644 --- a/skills/3dsmax-host-config/add-ons/tyflow.md +++ b/skills/3dsmax-host-config/add-ons/tyflow.md @@ -5,7 +5,7 @@ tyFlow is a particle system and physics simulation plugin for 3ds Max. It comes ## Reference Script -See `host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow/3dsmax-2025-vray-and-tyflow.ps1` for a working example. +See `host_configuration_scripts/3dsmax/3dsmax-2025-vray-and-tyflow.ps1` for a working example. ## What to add to the script diff --git a/skills/3dsmax-host-config/add-ons/vray.md b/skills/3dsmax-host-config/add-ons/vray.md index 9bcfd691..14421c3b 100644 --- a/skills/3dsmax-host-config/add-ons/vray.md +++ b/skills/3dsmax-host-config/add-ons/vray.md @@ -4,7 +4,7 @@ V-Ray is a professional rendering engine by Chaos Group that integrates as a plu ## Reference Script -See `host_configuration_scripts/3dsmax/3dsmax-2025-and-vray/3dsmax-2025-and-vray.ps1` for a working example. +See `host_configuration_scripts/3dsmax/3dsmax-2025-and-vray.ps1` for a working example. ## What to add to the script