# Ship Editor

Opens by double-clicking a ship in the viewport, or via Editors › Ships.

The Ship Editor configures individual ships. When multiple ships are selected in the viewport, editing a field applies the change to all of them simultaneously; some fields are disabled during multi-ship editing (such as Name, which must be unique). Some fields also behave differently or are unavailable when the selected ship is a Player Start.

## General fields

Field | Description
--- | ---
Name | Unique identifier used to reference this ship in SEXPs and mission log entries. Often visible to the player in the targeting HUD.
Display name | If set, shown to the player instead of the ship name in the targeting HUD and other player-facing contexts.
Ship class | The ship class from the game tables, defining the model, stats, and weapon hardpoints.
Callsign | Short identifier appended to the ship name in HUD target boxes (e.g. the ship name may read "Alpha 1 (Braveheart)" if a callsign is set).
Alt name | If set, replaces the ship's class name in HUD target boxes. Use this to display a different class name to the player without changing the actual ship class.
AI class | Overrides the AI skill level for this ship, independent of the mission's global AI profile.
Team | IFF team (Friendly, Hostile, Neutral, etc.) determining which ships treat this one as ally or enemy.
Cargo | Text displayed to the player when the ship is scanned. Use Nothing for ships with no cargo.
Cargo Title | Text title displayed to the player when the ship is scanned. This is the text before the ":" and defaults to "Cargo:" if not set.
Wing | Read-only. Shows which wing this ship belongs to, if any.
Hotkey | Function key (F5–F12) that selects this ship during play.
Persona | Voice persona used when this ship sends messages and when auto-selecting a wingmate sender for messages with a matching persona assigned.
Kill score | Points awarded to the player for destroying this ship.
Assist % | Percentage of the kill score awarded to players who earn an assist on this ship. For example, a value of 50 with a kill score of 100 gives assisters 50 points.
Respawn priority | In multiplayer, ships with higher values are prioritized when the engine selects which ship a player respawns into.
Player ship | Read-only indicator. Use Set Player Ship to change this.

## Buttons

Button | Description
--- | ---
Set Player Ship | Converts the selected ship between a Player Start and a regular ship. This changes the ship's internal object type and updates the player start count, affecting how the engine handles spawning and player-specific logic.
Prev / Next | Moves the selection to the previous or next ship in the mission, allowing quick sequential editing without switching back to the viewport.
Layer | The layer the ship is assigned to.
Delete Ship | Removes the selected ship from the mission.
Reset | Resets the selected ship(s) to their ship class defaults, including cargo, AI class, goals, hull and shield percentages, and weapon loadout.

## Subdialogs

Dialog | Description
--- | ---
Weapons | Primary and secondary weapon bank loadout.
Player Orders | Configures which comm menu orders the player can issue to this ship.
Texture Replacement | Overrides specific textures on this ship instance.
Initial Status | Starting hull, shields, subsystem damage, and weapon ammo.
Initial Orders | AI orders this ship follows at mission start.
Special Stats | Per-instance overrides for ship statistics.
Flags | Per-ship behavior flags.
Alt Ship Class | Fallback ship classes used if the primary class is unavailable at mission load.

## Arrival & Departure

Controls when and where this ship enters and leaves the mission. The cue SEXP must evaluate to true before the arrival or departure can occur. Most arrival locations require a target ship to be selected. Departure location options are limited to Hyperspace or To Dock Bay.

### Arrival locations

Location | Notes
--- | ---
Hyperspace | Warps in from hyperspace. No target required.
Near Ship | Appears near the target ship at the specified distance.
In Front of Ship | Appears in front of the target at the specified distance.
In Back of Ship | Appears behind the target at the specified distance.
Above Ship | Appears above the target at the specified distance.
Below Ship | Appears below the target at the specified distance.
To Left of Ship | Appears to the left of the target at the specified distance.
To Right of Ship | Appears to the right of the target at the specified distance.
From Dock Bay | Launches from the target ship's dock bay. Use Restrict Paths to limit which bay paths are used.

### Fields

Field | Description
--- | ---
Target | The ship this arrival or departure is relative to. Required for all locations except Hyperspace.
Distance | Distance from the target in meters. Arrival only; available for positional locations (Near Ship, In Front of Ship, etc.).
Delay | Seconds after the cue becomes true before the ship arrives or departs.
Restrict Paths | Selects which dock bay paths to use. Only available when the location is From Dock Bay or To Dock Bay.
Custom Warp Params | Opens a sub-dialog to configure custom warp appearance and behavior.
Cue | SEXP that must evaluate to true for arrival or departure to occur.
No warp effect | When checked, the ship appears or leaves without the visual warp effect.