/** * All theseus API calls return serialized values (both return values and errors); * So, for example, addDefaultInstance creates a blank Profile object, where the Rust struct is serialized, * and deserialized into a usable JS object. */ import type { Labrinth } from '@modrinth/api-client' import type { ContentItem, ContentOwner } from '@modrinth/ui' import { invoke } from '@tauri-apps/api/core' import { install_to_existing_profile } from '@/helpers/pack' import type { CacheBehaviour, ContentFile, ContentFileProjectType, GameInstance, InstanceLoader, } from './types' // Add instance /* name: String, // the name of the profile, and relative path to create game_version: String, // the game version of the profile modloader: ModLoader, // the modloader to use - ModLoader is an enum, with the following variants: Vanilla, Forge, Fabric, Quilt loader_version: String, // the modloader version to use, set to "latest", "stable", or the ID of your chosen loader icon: Path, // the icon for the profile - icon is a path to an image file, which will be copied into the profile directory */ export async function create( name: string, gameVersion: string, modloader: InstanceLoader, loaderVersion: string | null, icon: string | null, skipInstall: boolean, linkedData?: { project_id: string; version_id: string; locked: boolean } | null, ): Promise { // Trim string name to avoid "Unable to find directory" name = name.trim() return await invoke('plugin:profile-create|profile_create', { name, gameVersion, modloader, loaderVersion, icon, skipInstall, linkedData, }) } // duplicate a profile export async function duplicate(path: string): Promise { return await invoke('plugin:profile-create|profile_duplicate', { path }) } // Remove a profile export async function remove(path: string): Promise { return await invoke('plugin:profile|profile_remove', { path }) } // Get a profile by path // Returns a Profile export async function get(path: string): Promise { return await invoke('plugin:profile|profile_get', { path }) } export async function get_many(paths: string[]): Promise { return await invoke('plugin:profile|profile_get_many', { paths }) } // Get a profile's projects // Returns a map of a path to profile file export async function get_projects( path: string, cacheBehaviour?: CacheBehaviour, ): Promise> { return await invoke('plugin:profile|profile_get_projects', { path, cacheBehaviour }) } // Get just the installed project IDs for a profile (lightweight, skips update checks) export async function get_installed_project_ids(path: string): Promise { return await invoke('plugin:profile|profile_get_installed_project_ids', { path }) } // Get content items with rich metadata for a profile // Returns content items filtered to exclude modpack files (if linked), // sorted alphabetically by project name export async function get_content_items( path: string, cacheBehaviour?: CacheBehaviour, ): Promise { return await invoke('plugin:profile|profile_get_content_items', { path, cacheBehaviour }) } // Linked modpack info returned from backend export interface LinkedModpackInfo { project: Labrinth.Projects.v2.Project version: Labrinth.Versions.v2.Version owner: ContentOwner | null has_update: boolean update_version_id: string | null update_version: Labrinth.Versions.v2.Version | null } // Get linked modpack info for a profile // Returns project, version, and owner information for the linked modpack, // or null if the profile is not linked to a modpack export async function get_linked_modpack_info( path: string, cacheBehaviour?: CacheBehaviour, ): Promise { return await invoke('plugin:profile|profile_get_linked_modpack_info', { path, cacheBehaviour }) } // Get content items that are part of the linked modpack // Returns the modpack's dependencies as ContentItem list // Returns empty array if the profile is not linked to a modpack export async function get_linked_modpack_content( path: string, cacheBehaviour?: CacheBehaviour, ): Promise { return await invoke('plugin:profile|profile_get_linked_modpack_content', { path, cacheBehaviour }) } // Convert a list of dependencies into ContentItems with rich metadata export async function get_dependencies_as_content_items( dependencies: Labrinth.Versions.v3.Dependency[], cacheBehaviour?: CacheBehaviour, ): Promise { return await invoke('plugin:profile|profile_get_dependencies_as_content_items', { dependencies, cacheBehaviour, }) } // Get a profile's full fs path // Returns a path export async function get_full_path(path: string): Promise { return await invoke('plugin:profile|profile_get_full_path', { path }) } // Get's a mod's full fs path // Returns a path export async function get_mod_full_path(path: string, projectPath: string): Promise { return await invoke('plugin:profile|profile_get_mod_full_path', { path, projectPath }) } // Get optimal java version from profile // Returns a java version export async function get_optimal_jre_key(path: string): Promise { return await invoke('plugin:profile|profile_get_optimal_jre_key', { path }) } // Get a copy of the profile set // Returns hashmap of path -> Profile export async function list(): Promise { return await invoke('plugin:profile|profile_list') } export async function check_installed(path: string, projectId: string): Promise { return await invoke('plugin:profile|profile_check_installed', { path, projectId }) } export async function check_installed_batch(projectId: string): Promise> { return await invoke('plugin:profile|profile_check_installed_batch', { projectId }) } // Installs/Repairs a profile export async function install(path: string, force: boolean): Promise { return await invoke('plugin:profile|profile_install', { path, force }) } // Updates all of a profile's projects export async function update_all(path: string): Promise> { return await invoke('plugin:profile|profile_update_all', { path }) } // Updates a specified project export async function update_project(path: string, projectPath: string): Promise { return await invoke('plugin:profile|profile_update_project', { path, projectPath }) } // Add a project to a profile from a version // Returns a path to the new project file export type DownloadReason = 'standalone' | 'dependency' | 'modpack' | 'update' export async function add_project_from_version( path: string, versionId: string, reason: DownloadReason, ): Promise { return await invoke('plugin:profile|profile_add_project_from_version', { path, versionId, reason, }) } // Add a project to a profile from a path + project_type // Returns a path to the new project file export async function add_project_from_path( path: string, projectPath: string, projectType?: ContentFileProjectType, ): Promise { return await invoke('plugin:profile|profile_add_project_from_path', { path, projectPath, projectType, }) } // Toggle disabling a project export async function toggle_disable_project(path: string, projectPath: string): Promise { return await invoke('plugin:profile|profile_toggle_disable_project', { path, projectPath }) } // Remove a project export async function remove_project(path: string, projectPath: string): Promise { return await invoke('plugin:profile|profile_remove_project', { path, projectPath }) } // Update a managed Modrinth profile to a specific version export async function update_managed_modrinth_version( path: string, versionId: string, ): Promise { return await invoke('plugin:profile|profile_update_managed_modrinth_version', { path, versionId, }) } // Repair a managed Modrinth profile export async function update_repair_modrinth(path: string): Promise { return await invoke('plugin:profile|profile_repair_managed_modrinth', { path }) } // Export a profile to .mrpack // included_overrides is an array of paths to override folders to include (ie: 'mods', 'resource_packs') // Version id is optional (ie: 1.1.5) export async function export_profile_mrpack( path: string, exportLocation: string, includedOverrides: string[], versionId?: string, description?: string, name?: string, ): Promise { return await invoke('plugin:profile|profile_export_mrpack', { path, exportLocation, includedOverrides, versionId, description, name, }) } // Given a folder path, populate an array of all the subfolders // Intended to be used for finding potential override folders // profile // -- mods // -- resourcepacks // -- file1 // => [mods, resourcepacks] // allows selection for 'included_overrides' in export_profile_mrpack export async function get_pack_export_candidates(profilePath: string): Promise { return await invoke('plugin:profile|profile_get_pack_export_candidates', { profilePath }) } // Run Minecraft using a pathed profile // Returns PID of child export async function run(path: string, serverAddress: string | null = null): Promise { return await invoke('plugin:profile|profile_run', { path, serverAddress }) } export async function kill(path: string): Promise { return await invoke('plugin:profile|profile_kill', { path }) } // Edits a profile export async function edit(path: string, editProfile: Partial): Promise { return await invoke('plugin:profile|profile_edit', { path, editProfile }) } // Edits a profile's icon export async function edit_icon(path: string, iconPath: string | null): Promise { return await invoke('plugin:profile|profile_edit_icon', { path, iconPath }) } export async function finish_install(instance: GameInstance): Promise { if (instance.install_stage !== 'pack_installed') { const linkedData = instance.linked_data if (linkedData) { await install_to_existing_profile( linkedData.project_id, linkedData.version_id, instance.name, instance.path, ) } } else { await install(instance.path, false) } }