VS: Ship Retrieval Service

## Ship Retrieval Service (Bevor your judge the new GUI Backround is comming soon) Ship Retrieval Service is an **admin and utility mod for Valkyrien Skies 2**. It provides tools to **view, manage, and recover Valkyrien Skies ships** through an in-game GUI and commands. This mod helps server administrators and technical players handle ships that are lost, bugged, or causing performance issues. This mod is intended for **server administrators, modpack creators, and technical players** who need admin-level control over Valkyrien Skies ships. --- ## What does this mod do? Ship Retrieval Service provides: **Ship Management GUI:** - View all Valkyrien Skies ships in the world - Search, filter (Static/Dynamic/All), and sort (Name/ID/Status) ships - See ship ID, position (X/Y/Z coordinates), dimension, and status - Click any ship to open a detailed view **Ship Details & Actions:** - Edit ship name, owner, and notes for identification - Teleport to a ship's location - Teleport a ship to your current position - Freeze or unfreeze ships (stop/allow physics) - Delete ships permanently with confirmation dialog - Copy ship coordinates to clipboard **Ship Namer Item:** - Survival-friendly item available to all players (no admin permissions required) - Allows every player to name and tag their own ships - Right-click on any ship to open the naming interface - Add owner and notes for better organization - Can be crafted or obtained in-game **Admin Commands:** - `/srs ships` - Open the ship management GUI - `/srs reload` - Reload configuration - `/srs toggle debug` - Toggle debug messages - `/srs debug` - Debug tools for troubleshooting **Configuration:** - Set command permission levels (OP-only or all players) - Choose from 10 supported languages - Enable/disable Ship Namer item - Configurable admin action permissions --- ## Why should I use this mod? You may want to use this mod if: - A ship has flown away or is unreachable - Ships are causing server lag or crashes - You need to organize and label ships on a server - Valkyrien Skies ships prevent world loading - You want admin control without third-party tools Ship Retrieval Service lets you **manage ships directly in-game** without external editors or world resets. --- ## Important Information **Before Using:** - This is an **admin/utility mod** - requires operator permissions by default - Deleted ships **cannot be restored** - always confirm before deleting - **Create world backups** before using delete functions - Only affects Valkyrien Skies ships (vanilla entities are not touched) **Permissions:** - Default: OP level 2 required for commands and GUI - Configurable in `config/srs-common.toml` (Forge) or mod config - Can be set to allow all players if desired **Language Support:** - English, German, Spanish, French, Italian, Portuguese, Russian, Chinese, Japanese, Korean - Change language in configuration file --- ## Requirements - Minecraft **1.20.1** - **Valkyrien Skies 2** (required dependency) - **Forge** or **Fabric** (depending on the build you download) --- ## How to Use Click to expand ### Opening the Ship Management GUI 1. Join your world with operator permissions (or configure permissions) 2. Run `/srs ships` command 3. The Ship Management GUI will open with a list of all ships ### Using the Ship List 1. Use the **search bar** to find ships by name 2. Use **filter buttons** to show only Static or Dynamic ships 3. Use **sort buttons** to sort by Name, ID, or Status 4. Click **Details** button next to any ship to view details ### Managing a Ship 1. In the detail screen, you can: - **Edit name, owner, and notes** in the text fields - **Save** - Click save button or press Ctrl+S - **Teleport to Ship** - Teleports you to the ship's location - **Teleport Ship Here** - Moves the ship to your position - **Freeze/Activate** - Toggle ship physics on/off - **Delete** - Permanently remove the ship (with confirmation) - **Copy Coords** - Copy ship coordinates to clipboard ### Using the Ship Namer Item 1. Obtain the "Ship Namer" item: - Survival: Craft it in-game (recipe available) - Creative: Find it in the Operator Utilities tab 2. Right-click on any Valkyrien Skies ship 3. Edit the ship's name, owner, and notes 4. Click Save or Cancel 5. **Note:** Ship Namer works for all players, not just admins ### Configuration 1. Find the config file: - Forge: `config/srs-common.toml` - Fabric: Mod Menu settings 2. Configure: - Command permission level (0-4, default: 2) - Admin actions permission level - Language preference - Enable/disable Ship Namer item - Debug mode ### Troubleshooting - Use `/srs debug list` to see all loaded ships - Use `/srs toggle debug` to enable detailed logging - Check server logs for error messages - Ensure you have proper permissions (OP level 2+ by default) --- ## Credits **Development:** Created for the Valkyrien Skies 2 community **Art & Design:** - **SuperHappyPurson** - Ship Namer item texture design - **SuperHappyPurson** - GUI background designs (coming soon) --- ## License This project is licensed under the **Apache License 2.0**.