56 lines
2.9 KiB
Markdown
56 lines
2.9 KiB
Markdown
# Alchemist (Ultrahand v2.1.0+)
|
|
An Ultrahand package for managing, converting, and installing mods on the Nintendo Switch.
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
Alchemist is a comprehensive mod management package designed to streamline mod organization, conversion, and deployment. It supports exeFS patches, content mods, pchtxt conversion to IPS or cheat formats, and integrates utilities for maintaining a clean SD card environment. Mod repositories are managed dynamically, ensuring users can download, update, and install mods efficiently.
|
|
|
|
## Configuration
|
|
|
|
All options are accessible through `package.ini` and its included forwarders.
|
|
|
|
### Core Features
|
|
|
|
#### Title ID
|
|
- Dynamically tracks the current game using `Title ID`.
|
|
- Automatically updates mod selection and installation paths based on the active title.
|
|
|
|
#### Mod Management
|
|
- `[*exeFS Patches]` and `[*Contents Mods]`: Forwarded sections to toggle, enable, or delete patches or content mods.
|
|
- Search patterns can filter mods for bulk operations.
|
|
- `Enable All` / `Disable All` options apply actions across filtered mods.
|
|
|
|
#### Mod Conversion
|
|
- `[*pchtxt -> ips]`: Converts `.pchtxt` files to IPS patches, creating the required folder structure automatically.
|
|
- `[*pchtxt -> cheat]`: Converts `.pchtxt` files into cheat code format.
|
|
- `[*Delete pchtxt]`: Cleans up `.pchtxt` files after conversion or installation.
|
|
|
|
#### Mod Installation
|
|
- `[*Install pchtxt]` and `[*Install Contents]`: Forwarded sections that install mods from the configured repositories.
|
|
- Supports installation by title ID or search pattern.
|
|
|
|
#### Miscellaneous Tools
|
|
- `Dot Clean` removes macOS metadata files (`._*`) from `/atmosphere/`, `/switch/`, `/config/`, or the entire SD card.
|
|
- `Software Update` integrates automatic updating of the Alchemist package and all associated mod repositories.
|
|
|
|
## Obtaining Mods
|
|
|
|
Alchemist does not include mods directly. Mods are distributed through the Alchemist repositories:
|
|
|
|
- **Pchtxt Mods**: Available in [Alchemist Repos](https://github.com/ppkantorski/Alchemist-Repos). Users can download individual author packs or use the “Update All” feature within Alchemist.
|
|
- **Content Mods**: Organized by title ID in the same repositories. Use the “Install Contents” section to deploy content mods to the correct directories.
|
|
- Format for adding content mods is as follows:
|
|
- `/switch/.packages/Alchemist/contents/{TITLE_NAME} - {MOD_NAME}/{TITLE_ID}/...`
|
|
|
|
## Installation
|
|
|
|
1. Unzip `Alchemist.zip` to the root of your SD card. The `Alchemist` folder will appear under `/switch/.packages/`.
|
|
2. Ensure that mods are organized in the `repos` subfolders as outlined above.
|
|
3. Use the package menus to manage, convert, or install mods as needed.
|
|
|
|
## Additional Information
|
|
|
|
For detailed instructions, feature documentation, and support, see [Ultrahand Overlay](https://github.com/ppkantorski/Ultrahand-Overlay).
|