From 07e313bdbb7687f811c7946675577ce89d810859 Mon Sep 17 00:00:00 2001
From: sieadev <contact@siea.dev>
Date: Wed, 11 Mar 2026 14:50:12 +0000
Subject: [PATCH] Add default options.txt for new instances

---
 .../ui/settings/DefaultInstanceSettings.vue   | 55 ++++++++++++++++++-
 apps/app-frontend/src/helpers/settings.ts     |  4 ++
 .../app-frontend/src/locales/en-US/index.json |  9 +++
 apps/app/build.rs                             |  1 +
 apps/app/src/api/settings.rs                  |  8 ++-
 packages/app-lib/src/api/profile/create.rs    |  6 ++
 packages/app-lib/src/api/settings.rs          | 13 +++++
 packages/app-lib/src/state/dirs.rs            | 11 ++++
 8 files changed, 104 insertions(+), 3 deletions(-)

diff --git a/apps/app-frontend/src/components/ui/settings/DefaultInstanceSettings.vue b/apps/app-frontend/src/components/ui/settings/DefaultInstanceSettings.vue
index 18dfb68518..cd57c45f3b 100644
--- a/apps/app-frontend/src/components/ui/settings/DefaultInstanceSettings.vue
+++ b/apps/app-frontend/src/components/ui/settings/DefaultInstanceSettings.vue
@@ -1,11 +1,46 @@
 <script setup lang="ts">
-import { injectNotificationManager, Slider, StyledInput, Toggle } from '@modrinth/ui'
+import {
+	ButtonStyled,
+	defineMessages,
+	injectNotificationManager,
+	Slider,
+	StyledInput,
+	Toggle,
+	useVIntl,
+} from '@modrinth/ui'
 import { ref, watch } from 'vue'
 
 import useMemorySlider from '@/composables/useMemorySlider'
-import { get, set } from '@/helpers/settings.ts'
+import { ensure_default_options_file, get, set } from '@/helpers/settings.ts'
+import { openPath } from '@/helpers/utils.js'
 
 const { handleError } = injectNotificationManager()
+const { formatMessage } = useVIntl()
+
+const defaultOptionsMessages = defineMessages({
+	title: {
+		id: 'app.settings.default-options.title',
+		defaultMessage: 'Default options.txt',
+	},
+	description: {
+		id: 'app.settings.default-options.description',
+		defaultMessage:
+			'This file is copied to every new instance. Edit it to set default keybinds and other options.',
+	},
+	openFileLocation: {
+		id: 'app.settings.default-options.open-file-location',
+		defaultMessage: 'Open file location',
+	},
+})
+
+async function openDefaultOptionsLocation() {
+	try {
+		const path = await ensure_default_options_file()
+		await openPath(path)
+	} catch (e) {
+		handleError(e)
+	}
+}
 
 const fetchSettings = await get()
 fetchSettings.launchArgs = fetchSettings.extra_launch_args.join(' ')
@@ -52,6 +87,22 @@ watch(
 
 <template>
 	<div>
+		<h2 class="m-0 text-lg font-extrabold text-contrast">
+			{{ formatMessage(defaultOptionsMessages.title) }}
+		</h2>
+		<p class="m-0 mt-1 mb-2 leading-tight text-secondary">
+			{{ formatMessage(defaultOptionsMessages.description) }}
+		</p>
+		<div class="mt-2 flex flex-wrap gap-2">
+			<ButtonStyled>
+				<button type="button" @click="openDefaultOptionsLocation">
+					{{ formatMessage(defaultOptionsMessages.openFileLocation) }}
+				</button>
+			</ButtonStyled>
+		</div>
+
+		<hr class="mt-4 bg-button-border border-none h-[1px]" />
+
 		<h2 class="m-0 text-lg font-extrabold text-contrast">Window size</h2>
 
 		<div class="flex items-center justify-between gap-4">
diff --git a/apps/app-frontend/src/helpers/settings.ts b/apps/app-frontend/src/helpers/settings.ts
index 768a4f3016..20ff39547c 100644
--- a/apps/app-frontend/src/helpers/settings.ts
+++ b/apps/app-frontend/src/helpers/settings.ts
@@ -85,3 +85,7 @@ export async function set(settings: AppSettings) {
 export async function cancel_directory_change(): Promise<void> {
 	return await invoke('plugin:settings|cancel_directory_change')
 }
+
+export async function ensure_default_options_file(): Promise<string> {
+	return await invoke('plugin:settings|ensure_default_options_file')
+}
diff --git a/apps/app-frontend/src/locales/en-US/index.json b/apps/app-frontend/src/locales/en-US/index.json
index 5a28850b1c..7f0988c17a 100644
--- a/apps/app-frontend/src/locales/en-US/index.json
+++ b/apps/app-frontend/src/locales/en-US/index.json
@@ -59,6 +59,15 @@
   "app.modal.update-to-play.updated-count": {
     "message": "{count} updated"
   },
+  "app.settings.default-options.description": {
+    "message": "This file is copied to every new instance. Edit it to set default keybinds and other options."
+  },
+  "app.settings.default-options.open-file-location": {
+    "message": "Open file location"
+  },
+  "app.settings.default-options.title": {
+    "message": "Default options.txt"
+  },
   "app.settings.developer-mode-enabled": {
     "message": "Developer mode enabled."
   },
diff --git a/apps/app/build.rs b/apps/app/build.rs
index 665e50c11f..53cac01195 100644
--- a/apps/app/build.rs
+++ b/apps/app/build.rs
@@ -204,6 +204,7 @@ fn main() {
                         "settings_get",
                         "settings_set",
                         "cancel_directory_change",
+                        "ensure_default_options_file",
                     ])
                     .default_permission(
                         DefaultPermissionRule::AllowAllCommands,
diff --git a/apps/app/src/api/settings.rs b/apps/app/src/api/settings.rs
index ccfcdf38ab..f484f61c91 100644
--- a/apps/app/src/api/settings.rs
+++ b/apps/app/src/api/settings.rs
@@ -6,7 +6,8 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
         .invoke_handler(tauri::generate_handler![
             settings_get,
             settings_set,
-            cancel_directory_change
+            cancel_directory_change,
+            ensure_default_options_file
         ])
         .build()
 }
@@ -35,3 +36,8 @@ pub async fn cancel_directory_change() -> Result<()> {
     settings::cancel_directory_change(identifier).await?;
     Ok(())
 }
+
+#[tauri::command]
+pub async fn ensure_default_options_file() -> Result<std::path::PathBuf> {
+    Ok(theseus::settings::ensure_default_options_file().await?)
+}
diff --git a/packages/app-lib/src/api/profile/create.rs b/packages/app-lib/src/api/profile/create.rs
index e017f3d93c..8c60b9da1c 100644
--- a/packages/app-lib/src/api/profile/create.rs
+++ b/packages/app-lib/src/api/profile/create.rs
@@ -146,6 +146,12 @@ pub async fn profile_create(
             crate::launcher::install_minecraft(&profile, None, false).await?;
         }
 
+        let default_opts = state.directories.default_options_file_path();
+        let instance_options = full_path.join("options.txt");
+        if default_opts.exists() && !instance_options.exists() {
+            io::copy(&default_opts, &instance_options).await?;
+        }
+
         Ok(profile.path)
     }
     .await;
diff --git a/packages/app-lib/src/api/settings.rs b/packages/app-lib/src/api/settings.rs
index b79e2e524c..2cefd1e52a 100644
--- a/packages/app-lib/src/api/settings.rs
+++ b/packages/app-lib/src/api/settings.rs
@@ -1,10 +1,23 @@
 //! Theseus profile management interface
 
+use std::path::PathBuf;
+
 pub use crate::{
     State,
     state::{Hooks, MemorySettings, Profile, Settings, WindowSize},
 };
 
+/// Ensures the default options file exists; creates it empty if missing. Returns its path.
+#[tracing::instrument]
+pub async fn ensure_default_options_file() -> crate::Result<PathBuf> {
+    let state = State::get().await?;
+    let path = state.directories.default_options_file_path();
+    if !path.exists() {
+        tokio::fs::write(&path, []).await?;
+    }
+    Ok(path)
+}
+
 /// Gets entire settings
 #[tracing::instrument]
 pub async fn get() -> crate::Result<Settings> {
diff --git a/packages/app-lib/src/state/dirs.rs b/packages/app-lib/src/state/dirs.rs
index b098dbcac0..2fed898a7c 100644
--- a/packages/app-lib/src/state/dirs.rs
+++ b/packages/app-lib/src/state/dirs.rs
@@ -54,6 +54,11 @@ impl DirectoryInfo {
             ))
         })?;
 
+        let default_opts = settings_dir.join("options.txt.default");
+        if !default_opts.exists() {
+            let _ = fs::write(&default_opts, []).await;
+        }
+
         let config_dir =
             config_dir.map_or_else(|| settings_dir.clone(), PathBuf::from);
 
@@ -178,6 +183,12 @@ impl DirectoryInfo {
             .map(|d| d.join(LAUNCHER_LOGS_FOLDER_NAME))
     }
 
+    /// Path to the global default options.txt copied into new instances when they have none.
+    #[inline]
+    pub fn default_options_file_path(&self) -> PathBuf {
+        self.settings_dir.join("options.txt.default")
+    }
+
     /// Get the cache directory for Theseus
     #[inline]
     pub fn caches_dir(&self) -> PathBuf {