Plugins + Scripts Clothing Plugin Injector

Clothing Plugin Injector​

Purpose​

Clothing Plugin Injector is a Windows utility that automates the repetitive process of adding Clothing Plugin Manager references to existing VaM clothing packages.
Normally, this requires manually opening a clothing .var, finding each clothing .vaj file, editing it with a text editor, inserting the required JSON references, and repacking the archive. This Tool performs those steps automatically.
It is intended to make local clothing setup easier and to help clothing creators reduce repetitive preparation and testing time.

How It Works​

The Tool:

1. Opens an existing clothing .var.
2. Finds supported clothing .vaj files inside the package.
3. Adds a reference to an installed Stopper or Ashu Clothing Plugin Manager.
4. Optionally adds references to compatible clothing plugins in the Expansion Edition.
5. Updates dependency information in meta.json when that option is enabled.
6. Repackages the clothing .var.

The Tool does not copy plugin code or plugin .var files into the clothing package. All manager and plugin packages remain separate dependencies and must be installed in the user’s AddonPackages folder.

Included Editions​

Basic Edition​

ClothingPluginInjector_basic.cmd
Adds an installed Clothing Plugin Manager reference to supported clothing items. This is the simplest version.

Expansion Edition​

ClothingPluginInjector_expansion.cmd
Adds the manager and optional compatible clothing plugins. It also provides backup, safe restore, dependency, cache-clearing, folder-selection, and list-refresh controls.

Main Features​

• Supports Stopper and Ashu Clothing Plugin Manager.
• Adds manager and optional clothing-plugin references automatically.
• Processes clothing .vaj files only.
• Does not modify hair .vaj files.
• Preserves creator-supplied plugins and storables.
• Edits only an appropriate plugin block inside an ItemControl storable.
• Never changes the target clothing package’s own licenseType.
• Copies dependency license information from each dependency package’s own meta.json.
• Does not assign or guess CC BY or any other license on behalf of a creator.
• Reports a missing target meta.json instead of creating one or assigning a license.
• Preserves non-English filenames inside VAR/ZIP archives.
• Completes a temporary archive before replacing the original file.
• Supports exact restoration of files modified by the current version.

Requirements​

• Virt-A-Mate 1.x for Windows
• Windows PowerShell 5.1
• At least one supported manager package installed:
  • Stopper Clothing Plugin Manager
  • Ashu Clothing Plugin Manager

The required manager and optional plugin packages must be installed separately in the AddonPackages folder used by the same VaM installation.

Quick Start​

1. Close VaM completely.
2. Make an independent copy of the clothing .var.
3. Run ClothingPluginInjector_expansion.cmd.
4. Select Stopper’s or Ashu’s manager.
5. Select any optional compatible clothing plugins.
6. Drop one or more clothing .var files into the large box.
7. Leave Backup enabled.
8. Press Apply.
9. Start VaM and test the clothing.

Begin with one copied file. Processing no more than 30 files per run is recommended.
Both editions stop without modifying files if VaM is running.

Backup and Safe Restore​

When Backup is enabled, the untouched source .var is copied to:
<VaM>\_var_backup_before_plugin
An existing backup with the same filename is not overwritten.
Before its first successful modification, the current version stores the exact original bytes of only the files it changes in:
ClothingPluginInjector/restore-v1.json
Restore writes those exact bytes back and removes the restore record. It does not search for and delete generic plugin fields, creator plugins, or unrelated storables.
Packages modified by an older version do not contain safe restore data. The current Tool will report that safe restore data is unavailable and leave the package unchanged. Restore the original package from your own backup before applying the current version.
The built-in backup and restore functions are convenience measures, not guarantees. Always keep a second independent backup outside the Tool’s backup folder.

Third-Party Content and User Responsibility​

This Tool does not include Clothing Plugin Manager, optional plugin code, clothing, hair, textures, models, or other third-party VaM content.
The Tool grants no rights to any clothing, plugin, or other third-party material. Before distributing a processed package, users must verify that they have every right or permission required by the applicable licenses and VaMHub rules.
Adding dependency metadata does not grant permission to redistribute clothing or other content.
For all VaMHub license definitions and distribution rules, refer directly to the official VaMHub license guide:
https://hub.virtamate.com/wiki/license_help/
When uncertain, contact the relevant rights holder or a VaMHub moderator before publishing.
Clothing creators and authorized rights holders may use the Tool to prepare their own free or paid releases, provided that all applicable licenses, permissions, credits, dependencies, platform rules, and laws are followed.
Users are responsible for:

• Selecting and backing up files
• Verifying ownership, licenses, and permissions
• Providing required credits and links
• Testing the final package
• Checking dependency and version requirements
• Ensuring that distributed output complies with VaMHub rules

The Tool does not audit third-party plugin code or guarantee future compatibility. Install plugins only from trusted sources and read VaM’s plugin confirmation before allowing them to run.

Tool License​

Clothing Plugin Injector is licensed under:
Creative Commons Attribution-NoDerivatives 4.0 International
(CC BY-ND 4.0)
Unmodified copies of the Tool may be copied and redistributed with appropriate attribution and a link to the license.
Modified versions of the Tool may not be distributed. Private modifications are permitted.
Official license:
https://creativecommons.org/licenses/by-nd/4.0/
This license applies only to Clothing Plugin Injector itself. It does not apply to clothing packages processed by the Tool or to separately installed third-party packages.
See LICENSE.txt and THIRD_PARTY_NOTICES.txt inside the download.

Disclaimer​

The Tool is provided as-is and without a guarantee of compatibility or error-free operation. To the extent permitted by law, the author is not responsible for file damage, data loss, compatibility problems, copyright or license disputes, moderation or account actions, financial loss, or other consequences resulting from use of the Tool or distribution of processed output.

Official References​

Clothing Plugin Manager:
https://hub.virtamate.com/resources/clothing-plugin-manager.37633/
Manual Clothing Plugins Setup Guide:
https://hub.virtamate.com/resources/clothing-plugins.37636/
VaMHub License Guide:
https://hub.virtamate.com/wiki/license_help/
Feedback, bug reports, and support are accepted only through the official Clothing Plugin Injector VaMHub resource page.
This is not an official Virt-A-Mate or VaMHub product.
The description above is already written entirely in English. Copy everything from “Clothing Plugin Injector” through “This is not an official Virt-A-Mate or VaMHub product.” into the Description field.