🏷️
Names used in the examples: "Thorium Test" is a saved job; "Miner Test" is a profile; "Sens Miner" is the ship's grid name; "sens station" is the station's grid name; "PAM Dock 1" is a connector.
🧭
Change profiles with !pam profile set "<name>" <setting> <value>. A change reaches the ships using the profile immediately.

🧭 What a profile is — and is not

A profile is a named set of settings. It answers how a ship works. It does not say where to mine or what to mine; that is a saved job.

Saved jobProfile
AnswersWhere and what: GPS, ores, shuttle route, patrol/escort objective.How: role, speeds, cargo, station, connectors, return rules, AI profile.
Example"Thorium Test, Thorium, at this GPS.""Miner, 90% cargo, dock at sens station, use any connector."
Used byStarted with !pam start "<job>" [profile] [grid].Named on the start command.
⚠️
A GPS start uses default settings and cannot take a profile. This is the most common surprise. To use a profile, save the job first: !pam job new "Thorium Test" "GPS:thor:35875.86:12311.12:26887.91:" Thorium, then !pam start "Thorium Test" "Miner Test" "Sens Miner".

Changing a profile reaches the ships using it a moment later, including running jobs. The built-in profiles are shared: if several ships use Miner and you change Miner, all of them change. Use !pam profile new "<name>" to make your own.

🎭 Roles

RoleThe ship needsWhat it does
MinerDrills facing one way with no gap, and a connector.Mines asteroids and docks to unload.
BattleshipAI Flight (Move), AI Offensive or AI Defensive, and weapons.Fights and holds a target.
FighterAI Flight (Move), AI Offensive or AI Defensive, and weapons.Fast attack and interception.
ScoutAI Flight (Move) and AI Defensive, with no AI Offensive.Patrols and watches, without attacking.
PatrolAI Flight (Move), AI Offensive or AI Defensive, and weapons.Flies between two or more GPS points.
EscortAI Flight (Move), AI Offensive or AI Defensive, and weapons.Guards another of your ships.
ShuttleA connector on each stop's station, cargo space, and a route.Carries cargo between stations. See Shuttle routes.

Taxi and Grinder are accepted by the profile editor but those jobs are not built yet. Shuttle routes are built; see Shuttle routes.

Escort can be a group. Start the escort job on several warships with !pam group, and each takes a place in the ring around the guarded ship. The group does not answer a mayday from elsewhere; it stays with the ship it was assigned to.

⚙️ Profile settings

SettingValuesMeaning
roleminer, shuttle, battleship, fighter, scout, patrol, escortThe ship's role.
cargo0–100How full the cargo gets before the ship leaves.
miningspeedm/sHighest speed while drilling. 0 lets PAM choose.
manoeuvrespeedm/sHighest speed to and from the rock. 0 lets PAM choose.
dockingspeedm/sHighest speed near a dock. 0 lets PAM choose.
radius0–25 mDrill radius. 0 uses the size the game reports.
overlap0–50 %How much neighbouring tunnels overlap.
clearm or offClear stone without keeping it, until this many metres before the ore.
minjumpkmEnd the job and go home when jump range falls below this. 0 is off.
returnafterminutesGo home this long after reaching the job. Combat roles only.
lowammo%Go home when only this share of weapons has ammo. 0 is off.
lowshield%Go home when the shield falls to this. 0 is off.
lowhull%Go home when the hull falls to this. 0 is off.
lowpower%Go home when stored power or fuel falls to this. 0 is off.
evadekmHow far an evasive jump goes.
logoreson / offLog ore found by the ship's ore detector. Needs a working ore detector; the job scan does not.
returnenemyon / offGo home when an enemy is seen.
returnoreon / offGo home when the ore detector finds ore. Combat roles only. Needs a working ore detector.
jumpson / offJump instead of flying when the ship can.
stationgrid name or noneWhere the ship docks to unload and charge.
dockconnector names or anyWhich connectors at the station the ship may use.

For numbers, 0 means “automatic” for speeds and limits, and “off” for return rules. Negative values are refused.

🔧 Examples

Universal forms:

!pam profile new <profile> !pam profile set <profile> <setting> <value> !pam profile show <profile>

Angle brackets are placeholders; quote names with spaces.

For these examples: profile "Miner Test"; job "Thorium Test"; ship grid "Sens Miner"; station "sens station"; connector "PAM Dock 1".

!pam profile new "Miner Test"

Makes a new profile.

!pam profile set "Miner Test" cargo 90

Leaves the rock at 90% cargo.

!pam profile set "Miner Test" station "sens station"

Docks, unloads and recharges at sens station.

!pam profile set "Miner Test" logores on

Logs the ore its ore detector finds.

!pam profile show "Miner Test"

Shows every setting on the profile.

🏗️ A complete miner that docks by itself

This is the full setup. Run these once; reuse the profile and job afterwards.

!pam stations sens station: PAM Dock 1, PAM Dock 2 (in use)

The reply gives you the grid name (sens station) and the connector names. The profile uses the grid name for station, and connector names only for dock.

!pam profile new "Miner Test" !pam profile set "Miner Test" role miner !pam profile set "Miner Test" cargo 90 !pam profile set "Miner Test" station "sens station" !pam profile set "Miner Test" dock any
!pam job new "Thorium Test" "GPS:thor:35875.86:12311.12:26887.91:" Thorium !pam start "Thorium Test" "Miner Test" "Sens Miner"

PAM fills to 90% cargo, flies to sens station, docks, unloads, charges to 95% power and fuel, undocks, and returns to the same rock. Cargo and charge trips go back to work by themselves; a damage or called-home stop waits at the dock for Resume.

🅿️
No station: the ship holds at Limit reached beside the rock. Use !pam home, empty it, then !pam resume.

🛡️ Warships: escort groups and “mayday”

🛡️
Several warships can be put on one miner as an Escort group. They fly in formation around that miner and their AI blocks fight enemies that come into range. There is no mayday broadcast: the group is assigned when it starts, and does not jump to another ship on a distress call.

How to start the group

For this example: profile "Guard"; job "Guard Duty"; miner grid "Sens Miner"; warship grids "Warship One" and "Warship Two".

Syntax:

!pam profile set <profile> role escort !pam job escort <job> <guarded grid> !pam group <job> <profile> "<grid one,grid two>"

An escort job needs a valid GPS only because every saved job does; the role uses the guarded ship, not that GPS. The miner's position is convenient: !pam gps "Sens Miner" adds it to your GPS list.

!pam profile new "Guard" !pam profile set "Guard" role escort !pam profile set "Guard" manoeuvrespeed 30 !pam job new "Guard Duty" "GPS:Sens Miner:1000:2000:3000:" !pam job escort "Guard Duty" "Sens Miner" !pam group "Guard Duty" "Guard" "Warship One,Warship Two"

The group flies in formation around Sens Miner. The game's AI blocks decide when to fire; set them on each warship in the ship's control panel. PAM leaves them as set, and chat has no AI-setting command.

Patrol

A patrol needs two or more GPS points. !pam job new saves one GPS, and there is no chat command to add the extra points, so a Torch-only patrol is limited to what the saved job already holds. Start it with !pam start <job> <profile> <grid>; the ship flies between the points and its AI blocks fight what comes into range.

🏗️ Station and connectors

For this example: profile "Miner Test"; station "sens station"; connector "PAM Dock 1".

Syntax:

!pam stations !pam profile set <profile> station <station grid> !pam profile set <profile> dock <connectors|any|none>

The station is where mining ships unload and charge. It must be your grid, or your faction's, with working connectors that fit your ships.

  • If no connector is chosen, the ship uses the nearest free connector of the right size.
  • If any connector at the station has [PAM] in its name, only those are used.
  • Use !pam profile set "<profile>" dock "Connector One,Connector Two" to choose connectors, or any.
  • If the ship cannot unload, it leaves with its ore so the dock stays free.
  • Use !pam stations to list grids and connectors where you can dock.
!pam stations sens station: PAM Dock 1, PAM Dock 2 (in use) !pam profile set "Miner Test" station "sens station" !pam profile set "Miner Test" dock "PAM Dock 1" !pam profile set "Miner Test" dock any

The station value is a grid name. The dock value is a comma-separated list of connector names, or any / none. A small ship needs a small connector; a large ship needs a large one.

⚠️
Mining ships and shuttle jobs use the station; combat ships do not. Charging ends at 95% power and fuel.

🤖 AI blocks

Combat roles use the game's AI blocks. Set them on each warship in the ship's control panel; the Torch plugin leaves them as set and there is no chat command for AI settings.

The role tells the ship where to fly: Escort keeps it with a guarded ship, Patrol flies between GPS points. The AI blocks decide what to attack and when to fire.