Xzen Amethyst

Introduction

Xzen Amethyst is a powerful and user-friendly mod manager designed specifically for Smash Legends. It simplifies the process of installing, managing, and removing various types of mods, allowing you to personalize your game experience like never before. Say goodbye to manual file manipulation and hello to seamless modding!

Key Features

• Skins: Customize the appearance of your favorite legends with unique skins.
• Emotes: Add new emotes made by community
• Stages: Enhance your map looks with custom stage designs.
• Easy Installation: Import mod options for quick mod deployment.
• Mod Management: Enable, disable mods with ease.
• Automatic Updates For Skins: Keep your mod manager's skins support up-to-date automatically with 1 click.

Mod Types and Usage

Xzen Amethyst categorizes mods for easy management. Here's how each type works:

For advanced modding of Stages and Enhanced Skins, refer to the dedicated sections below.

Creating Stage Mods

For ambitious modders, Xzen Amethyst supports custom stage creations. These mods allow you to completely overhaul the environment of a battlefield. Stage mods typically involve custom meshes, textures, and lighting.

Required Tools & Concepts:

• Smash Legends Asset Export/Import Tools: (Hypothetical) Tools specific to Smash Legends for extracting and packaging game assets.
• 3D Modeling Software: Blender, Maya, 3ds Max (for creating custom meshes).
• Image Editing Software: Photoshop, GIMP (for creating custom textures).
• Understanding of Game Engines: Familiarity with concepts like UV mapping, material properties, and basic lighting.
• Knowledge of Unity Engine.

Stage Mod File Structure:

Stage mods should be packaged in a way that Xzen Amethyst can understand and deploy. The most common method is a `.zip` archive containing a specific folder structure, including a `paths.json` file.

If you're creating a folder-based mod for Xzen Amethyst to package, follow this structure (rename `YourCustomStageName.resS` with a unique identifier for your stage. Your `.resS` file will determine the Stage Mod's name):

YourCustomStageName.zip/
├── map
├── YourCustomStageName.resS
├── oneway_city_01
├── paths.json
└── sky_default

Note: In `paths.json` you MUST include this exact code and edit it slightly based on your file paths where they should be.

{
    "map": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\SMASH LEGENDS\\Smash_Legends_Data\\StreamingAssets\\AssetBundles\\map\\scenes",
    "oneway_city_01": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\SMASH LEGENDS\\Smash_Legends_Data\\StreamingAssets\\AssetBundles\\map\\scenes",
    "sky_default": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\SMASH LEGENDS\\Smash_Legends_Data\\StreamingAssets\\AssetBundles\\map\\shared"
}

Importing Stage Mods into Xzen Amethyst:

1. Package your mod: Compress your `Files yes directly files do not put them in a folder` and compress it into a `.zip` archive
2. Open Xzen Amethyst: Go to the "Add" tab and press Import Stage Mods.
3. Select the .zip file:After Importing Xzen must handle the setup itself if you did all correct
4. Verification: Xzen Amethyst will analyze the mod. If the structure is correct, it will work once you enable the mod.

Note: You can edit the existing files of the code like add more paths of modded files or remove just make sure it is in the correct format. You also must change the names of the paths if you not using " Map " and its path then rename it and edit the path or remove it for the code

Creating Enhanced Skins

Enhanced skins go beyond simple texture or model swaps. They can include custom SFX and they are slightly more complicated by folder structure

What Makes a Skin "Enhanced"?

• Custom Animations: New idle animations, attack animations, or unique emotes bundled with the skin.
• Particle Effects: Sparks, glows, aura, or other visual effects that play around the character.
• Shader/Material Overrides: Custom reflections, translucency, or other advanced rendering properties.
• Complex Model Changes: Additions of new mesh parts (e.g., capes, armor pieces, wings) that might require new rigging.

Note: Know that only SFX is supported for enhanced skins any skin made with vocals as long as it follows the " harman mod " file structure should be fine

Enhanced Skin Mod File Structure:

Enhanced skins require a more detailed file structure to accommodate all their components.

ModName.zip/
├── Mods/
│   ├── NameOfResourceFile.resource
│
├── StreamingAssets/
│   └── AssetBundles/
│       └── characters/
│           └── the character folder name (example: marina )
│               └── the character skin file itself (example: skin004)
│
│
└── AssetBundles/ (also include a sfx folder)
    └── sfx
        └── game
            └── character
                └── (character folder name, example: marina) and in it:
                    └── audioevent folder
                    └── clip
                    └── data
                    └── voice/ (in voice make sure to include the game's language based folders like " enus ")
                        └── enus/
                            └── audioevent

Importing Enhanced Skins into Xzen Amethyst:

1. Package your mod: Select both of `Mods folder and StreamingAssets` folders and compress into a `.zip` archive (e.g., `CoolSkinMod.zip`).
2. Open Xzen Amethyst: Go to the "Add" tab and Select " Import Skin Mods " this time keep it in default so in popup window only shows .zip files.
3. Select the .zip: After selecting your .zip file all should be fine
4. Automatic Detection: Xzen Amethyst will detect the `.zip` folder and recognize it as an "Enhanced Skin." It will then integrate all specified assets to storage.

File Paths and Structure

Understanding where Xzen Amethyst places and manages your mods can be helpful for advanced users or troubleshooting. While Xzen Amethyst handles the complexities of mod deployment, it's good to know the underlying structure.

Xzen Amethyst creates a dedicated folder within mod Manager's directory This typically looks like:

[Smash Legends Installation Path]
└───Xzen4.0-Extended/
    ├─── Core/   -- The core functionality of Mod Manager
    │
    ├─── Mods/   -- This is where all Mods & Backups contained
    │   ├─── characters/      (All Modded Skin files under a special folder structure for each character a folder)
    │   ├─── emotes/ (All Emote Modded Files)
    │   ├─── special/ (All Enhanced Skin Files)
    │   ├─── stages/ (All Stage Mods Folders)
    │   └─── ui/ (All Modded UI Files)
    │
    │
    │  --v--all original files stored here--v--
    │
    │   ├─── og_characters/
    │   ├─── og_sfx/
    │   ├─── og_emotes/
    │   └─── og_stages

Each mod, when installed, is usually placed in its own sub-folder within its respective category (`Skins`, `Emotes`, `Stages`). Xzen Amethyst then uses an internal system named " Zen Mod Manager Engine " to make these mods accessible to the game.

Support List:

Disclaimer: Specific internal file structures within mod folders might vary depending on the mod itself. Xzen Amethyst handles the complexities, so you generally don't need to manually interact with these folders unless troubleshooting. Refer to the "Creating Mod" sections for structures Xzen Amethyst expects for new mods.

Troubleshooting

If you encounter any issues, try these common solutions:

• Mod not appearing in game:
  • Ensure the mod is enabled in Xzen Amethyst.
  • Verify the mod file is not corrupted.
  • Check if the mod is compatible with your current Smash Legends version.
  • Try restarting Smash Legends and Xzen Amethyst.
• Game crashing after mod installation:
  • Disable the most recently installed mods such as stage mods and Mods that are a "sharedassets.assets" file type mods .
  • Ensure your game files are not corrupted (Steam "Verify Integrity of Game Files" option) you can do that in Mod Manager by pressing CTRL+R or Navigate to " file " tab and choose "Restore Files "
• Xzen Amethyst not launching:
  • Most likely libraries arent installed. Make sure you have Python installed
  • In case of it appears for just a second run " Setup " so it gets the required Python Libraries.
  • Re-download and reinstall Xzen Amethyst make sure you follow the installation Guide properly.

For further assistance, please visit our Discord Server

or use the built-in option for feedback if possible for any issues or suggestions. CTRL+F or Navigate to " file " tab and choose feedback

Frequently Asked Questions (FAQ)