@bobschlowinskii/clicraft 0.4.0

package/docs/commands/auth.md

@@ -0,0 +1,376 @@
+---
+layout: default
+title: auth
+parent: Commands
+nav_order: 4
+description: "Manage Minecraft accounts"
+permalink: /commands/auth
+---
+
+# auth Command
+
+Manage your Microsoft/Minecraft accounts. CLIcraft supports multiple accounts with easy switching between them.
+
+## 📝 Synopsis
+
+```bash
+clicraft auth [action] [args...] [options]
+```
+
+## 📖 Description
+
+The auth command provides a unified interface for managing Microsoft account authentication. You can have multiple accounts saved and easily switch between them.
+
+### Available Actions
+
+| Action | Description |
+|--------|-------------|
+| `login` | Add a new account or update existing |
+| `logout [account]` | Remove an account |
+| `switch [account]` | Switch to a different account |
+| `status [account]` | Show all accounts or specific account details |
+| `list` | List all saved accounts |
+
+## 🎯 Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-f, --force` | Skip confirmation prompts | false |
+| `--verbose` | Enable verbose output | false |
+
+## 📋 Examples
+
+### Add a new account
+```bash
+clicraft auth login
+```
+
+### Check all accounts
+```bash
+clicraft auth status
+```
+Output:
+```
+🎮 Account Status
+
+2 account(s) saved:
+
+▶ Player123 (4a903277...) (valid)
+  AltAccount (8b374a68...) (expired)
+
+Use "clicraft auth status <username>" for detailed info.
+```
+
+### View specific account details
+```bash
+clicraft auth status Player123
+```
+Output:
+```
+🎮 Account Status
+
+Username: Player123 (active)
+UUID: 4a903277a1014eaebc5a82f746e36682
+Authenticated: 2026-01-19T16:13:46.840Z
+Token valid for 45 minutes
+```
+
+### Switch between accounts
+```bash
+clicraft auth switch AltAccount
+```
+Or interactively:
+```bash
+clicraft auth switch
+```
+
+### Remove an account
+```bash
+clicraft auth logout Player123
+```
+Or remove current account:
+```bash
+clicraft auth logout
+```
+
+### List all accounts
+```bash
+clicraft auth list
+```
+
+## 🎮 Login Process
+
+### Step-by-Step
+
+```bash
+$ clicraft auth login
+
+🔐 Microsoft Login
+
+You have 1 account(s) saved.
+This will add a new account or update an existing one.
+
+Please open this URL in your browser to login:
+
+https://login.live.com/oauth20_authorize.srf\?...
+
+(Browser opened automatically)
+
+After logging in, you will be redirected to a blank page.
+Copy the ENTIRE URL from your browser's address bar and paste it below:
+
+Paste the redirect URL here: 
+```
+
+1. **Browser Opens**: Your default browser opens to Microsoft's login page
+2. **Sign In**: Login with your Microsoft account (the one that owns Minecraft)
+3. **Authorization**: Approve the authentication request
+4. **Copy URL**: After approval, you'll be redirected - copy the entire URL
+5. **Paste URL**: Paste it into the terminal
+6. **Complete**: Account is saved and set as active
+
+### Example Session
+
+```bash
+$ clicraft auth login
+
+🔐 Microsoft Login
+
+Please open this URL in your browser to login:
+
+https://login.live.com/oauth20_authorize.srf\?...
+
+Paste the redirect URL here: https://login.live.com/oauth20_desktop.srf\?code\=M.R3_BAY...
+
+Getting Microsoft token...
+Getting Xbox Live token...
+Getting XSTS token...
+Getting Minecraft token...
+Getting Minecraft profile...
+
+✅ Successfully added account: Player123
+   UUID: 4a903277a1014eaebc5a82f746e36682
+   Total accounts: 2
+   This account is now active.
+```
+
+## 🔀 Switching Accounts
+
+### Interactive Switch
+```bash
+$ clicraft auth switch
+
+🔄 Switch Account
+
+? Select an account to switch to:
+❯ Player123 (current)
+  AltAccount
+  TestPlayer
+```
+
+### Direct Switch
+```bash
+$ clicraft auth switch AltAccount
+
+🔄 Switch Account
+
+✅ Switched to: AltAccount
+```
+
+### Switch by UUID
+```bash
+clicraft auth switch 8b374a68-9338-41b9-81a1-c65e5a02fedf
+```
+
+## 🚪 Logging Out
+
+### Remove Specific Account
+```bash
+$ clicraft auth logout AltAccount
+
+🔐 Logout
+
+✔ Are you sure you want to logout AltAccount? Yes
+✅ Logged out: AltAccount
+   Remaining accounts: 1
+   Active account: Player123
+```
+
+### Interactive Selection (Multiple Accounts)
+```bash
+$ clicraft auth logout
+
+🔐 Logout
+
+? Which account do you want to logout?
+❯ Player123 (4a903277...)
+  AltAccount (8b374a68...)
+  Cancel
+```
+
+### Force Logout (Skip Confirmation)
+```bash
+clicraft auth logout AltAccount --force
+```
+
+## 📊 Status Display
+
+### All Accounts
+```bash
+$ clicraft auth status
+
+🎮 Account Status
+
+2 account(s) saved:
+
+▶ Player123 (4a903277...) (valid)
+  AltAccount (8b374a68...) (expired)
+
+Use "clicraft auth status <username>" for detailed info.
+```
+
+**Legend:**
+- `▶` - Currently active account
+- `(valid)` - Token is still valid
+- `(expired)` - Token needs refresh (automatic on launch)
+
+### Specific Account
+```bash
+$ clicraft auth status Player123
+
+🎮 Account Status
+
+Username: Player123 (active)
+UUID: 4a903277a1014eaebc5a82f746e36682
+Authenticated: 2026-01-19T16:13:46.840Z
+Last Refreshed: 2026-01-22T14:30:00.000Z
+Token valid for 45 minutes
+```
+
+## 🔒 Token Storage
+
+### Storage Location
+Authentication data is stored at:
+```
+~/.clicraft/auth/accounts.json
+```
+
+### Structure
+```json
+{
+  "accounts": {
+    "uuid1": { "username": "Player123", ... },
+    "uuid2": { "username": "AltAccount", ... }
+  },
+  "currentAccount": "uuid1"
+}
+```
+
+### Security
+- **Keep this file secure/home/benjamin/GitHub/clicraft/docs/commands/login.md /home/benjamin/GitHub/clicraft/docs/commands/auth.md* It contains authentication tokens
+- Tokens are automatically refreshed when they expire
+- Old tokens are invalidated when you logout
+
+## 🔄 Token Management
+
+### Automatic Refresh
+CLIcraft automatically refreshes tokens when:
+- They're about to expire (within 5 minutes)
+- You launch the game
+- The token check during game launch
+
+### Manual Refresh
+Re-login to force a fresh token:
+```bash
+clicraft auth login
+# Login with the same account to refresh
+```
+
+## 🎯 Use Cases
+
+### Multiple Players on Same Computer
+```bash
+# Add first account
+clicraft auth login
+# Login as Player1
+
+# Add second account  
+clicraft auth login
+# Login as Player2
+
+# Switch between them
+clicraft auth switch Player1
+clicraft launch
+
+clicraft auth switch Player2
+clicraft launch
+```
+
+### Development/Testing
+```bash
+# Use test account for mod testing
+clicraft auth switch TestAccount
+clicraft launch
+
+# Switch back to main account
+clicraft auth switch MainAccount
+```
+
+### Shared Computer
+```bash
+# Each user logs in with their own account
+clicraft auth login
+
+# Before leaving, remove your account
+clicraft auth logout YourUsername
+```
+
+## ⚠️ Common Issues
+
+### "Token expired"
+Tokens automatically refresh on launch. If issues persist:
+```bash
+clicraft auth login
+# Re-login with the same account
+```
+
+### "Account not found"
+Check available accounts:
+```bash
+clicraft auth list
+```
+
+### "No accounts logged in"
+Add an account:
+```bash
+clicraft auth login
+```
+
+### "Browser didn't open"
+Copy the URL manually:
+```bash
+clicraft auth login
+# Copy the URL shown and paste in browser
+```
+
+## 🔗 Migration from Legacy Format
+
+If you used an older version of CLIcraft, your existing auth is automatically migrated:
+- Old file: `~/.clicraft/auth.json`
+- New location: `~/.clicraft/auth/accounts.json`
+- A backup is created at `~/.clicraft/auth.json.backup`
+
+## 📚 Related Commands
+
+- [`clicraft launch`](launch.md) - Launch requires login for online play
+- [`clicraft config`](config.md) - CLI configuration
+
+## 🔗 External Resources
+
+- [Microsoft Account](https://account.microsoft.com/)
+- [Minecraft Account](https://www.minecraft.net/profile)
+- [Get Minecraft](https://www.minecraft.net/get-minecraft)
+
+---
+
+[← Back to Commands](../commands.md) | [Next: launch →](launch.md)

package/docs/commands/config.md

@@ -0,0 +1,294 @@
+---
+layout: default
+title: config
+parent: Commands
+nav_order: 8
+description: "Manage CLI settings and game settings"
+permalink: /commands/config
+---
+
+# config Command
+
+Manage CLIcraft settings and Minecraft game settings.
+
+## 📝 Synopsis
+
+```bash
+clicraft config [action] [args...] [options]
+```
+
+## 📖 Description
+
+The `config` command provides access to:
+- **CLI Settings** - Global CLIcraft configuration (Java path, memory, etc.)
+- **Game Settings Ignore List** - Control which Minecraft settings are captured
+- **Game Settings** - Capture and manage Minecraft options in mcconfig.json
+
+## 🎯 Options
+
+| Option | Description |
+|--------|-------------|
+| `-i, --instance <path>` | Path to instance directory (for game settings actions) |
+| `--verbose` | Show detailed output |
+
+## 📋 Actions
+
+### `show` (default)
+
+Display current CLI settings.
+
+```bash
+clicraft config
+clicraft config show
+```
+
+**Output:**
+```
+⚙️  CLI Settings
+
+   Config directory: /home/user/.clicraft
+
+   checkUpdates: true
+   autoSaveToConfig: true
+   *...other config options*
+```
+
+### `set <key> <value>`
+
+Modify a CLI setting.
+
+```bash
+# Set maximum memory
+clicraft config set checkUpdates false
+
+# Reset to auto-detect
+clicraft config set checkUpdates auto #sets to true
+```
+
+**Available Settings:**
+
+| Key | Description | Example Values | Default|
+|-----|-------------|----------------|--------|
+| `checkUpdates` | whether to check for updates | `true, false` | `true` |
+| `autoSaveToConfig` | whether to automatically save minecraft settings to mcconfig.json | `true, false` | `true` |
+
+*Do NOT change settingsVersion, unless you want to mess around and fix my bugs ;)*
+
+### `ignore`
+
+Show the game settings ignore list. These patterns determine which Minecraft settings are excluded when capturing.
+
+```bash
+clicraft config ignore
+```
+
+**Output:**
+```
+🚫 Game Settings Ignore List
+
+   File: /home/user/.clicraft/game-settings-ignore.json
+   These settings are excluded when saving game settings to mcconfig.json
+
+   - fullscreen
+   - overrideWidth
+   - overrideHeight
+   - key_*
+   - narrator
+   ...
+
+   Tip: Use * as wildcard (e.g., key_* ignores all keybinds)
+```
+
+### `ignore-add <pattern>`
+
+Add a pattern to the ignore list.
+
+```bash
+# Ignore mouse sensitivity
+clicraft config ignore-add mouseSensitivity
+
+# Ignore all sound categories (wildcard)
+clicraft config ignore-add soundCategory_*
+```
+
+### `ignore-remove <pattern>`
+
+Remove a pattern from the ignore list.
+
+```bash
+# Stop ignoring keybinds (include them when capturing)
+clicraft config ignore-remove key_*
+```
+
+### `defaults`
+
+Show default game settings that are applied to all new instances.
+
+```bash
+clicraft config defaults
+```
+
+**Output:**
+```
+🎮 Default Game Settings
+
+   File: /home/user/.clicraft/default-game-settings.json
+   These settings are applied to all new instances
+
+   renderDistance: 16
+   fov: 80
+```
+
+### `defaults-set <key> <value>`
+
+Set a default game setting. This will be applied to all new instances.
+
+```bash
+# Set render distance
+clicraft config defaults-set renderDistance 16
+
+# Set field of view
+clicraft config defaults-set fov 80
+
+# Disable auto-jump
+clicraft config defaults-set autoJump false
+```
+
+### `defaults-remove <key>`
+
+Remove a default game setting.
+
+```bash
+clicraft config defaults-remove renderDistance
+```
+
+### `defaults-clear`
+
+Clear all default game settings.
+
+```bash
+clicraft config defaults-clear
+```
+
+### `capture`
+
+Capture game settings from an instance's `options.txt` and save them to `mcconfig.json`.
+
+```bash
+# In an instance directory
+clicraft config capture
+
+# Or specify instance
+clicraft config capture --instance ~/my-instance
+
+# With verbose output to see all captured settings
+clicraft config capture --verbose
+```
+
+**Requirements:**
+- Must have an `mcconfig.json` in the instance
+- Must have an `options.txt` (run Minecraft at least once)
+
+**What it does:**
+1. Reads `options.txt` from the instance
+2. Filters out settings in the ignore list
+3. Saves remaining settings to `mcconfig.json` as `gameSettings`
+
+### `game-settings`
+
+Show game settings saved in an instance's `mcconfig.json`.
+
+```bash
+clicraft config game-settings
+clicraft config game-settings --instance ~/my-instance
+```
+
+**Output:**
+```
+⚙️  Game Settings (15 saved)
+
+   renderDistance: 12
+   fov: 70
+   guiScale: 2
+   gamma: 0.5
+   ...
+```
+
+### `clear-game-settings`
+
+Remove all game settings from an instance's `mcconfig.json`.
+
+```bash
+clicraft config clear-game-settings
+```
+
+## 💡 Examples
+
+### Set up for a powerful machine
+```bash
+clicraft config set maxMemory 8G
+clicraft config set minMemory 4G
+```
+
+### Configure default game settings for new instances
+```bash
+# Set your preferred defaults
+clicraft config defaults-set renderDistance 16
+clicraft config defaults-set fov 80
+clicraft config defaults-set guiScale 2
+clicraft config defaults-set autoJump false
+
+# Now all new instances will have these settings
+clicraft create
+```
+
+### Capture and share settings
+```bash
+# Play Minecraft and configure your preferred settings
+# Then capture them
+cd my-instance
+clicraft config capture --verbose
+
+# Your mcconfig.json now includes gameSettings
+# Share it with others
+```
+
+### Include keybinds in shared config
+```bash
+# By default, keybinds are ignored
+# Remove them from ignore list to include
+clicraft config ignore-remove key_*
+
+# Now capture will include keybinds
+clicraft config capture
+```
+
+### Check what will be captured
+```bash
+# First, see what's ignored
+clicraft config ignore
+
+# Then capture with verbose to see what's included
+clicraft config capture --verbose
+```
+
+## 📁 Config Files
+
+All global config files are stored in `~/.clicraft/`:
+
+| File | Description |
+|------|-------------|
+| `settings.json` | CLI settings (memory, Java path, etc.) |
+| `default-game-settings.json` | Default Minecraft settings for new instances |
+| `game-settings-ignore.json` | Patterns to exclude when capturing |
+| `auth.json` | Authentication tokens |
+
+## 🔗 See Also
+
+- [Configuration Guide](../configuration.md) - Full configuration documentation
+- [create Command](create.md) - Uses game settings when creating from config
+- [info Command](info.md) - Shows instance information
+
+---
+
+[← Back to Commands](../commands.md)