PAM Profiles
A profile sets how a ship works: its role, speeds, cargo limit, station, and when it goes home.
"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.
!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 job | Profile | |
|---|---|---|
| Answers | Where 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 by | Started with !pam start "<job>" [profile] [grid]. | Named on the start command. |
!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
| Role | The ship needs | What it does |
|---|---|---|
| Miner | Drills facing one way with no gap, and a connector. | Mines asteroids and docks to unload. |
| Battleship | AI Flight (Move), AI Offensive or AI Defensive, and weapons. | Fights and holds a target. |
| Fighter | AI Flight (Move), AI Offensive or AI Defensive, and weapons. | Fast attack and interception. |
| Scout | AI Flight (Move) and AI Defensive, with no AI Offensive. | Patrols and watches, without attacking. |
| Patrol | AI Flight (Move), AI Offensive or AI Defensive, and weapons. | Flies between two or more GPS points. |
| Escort | AI Flight (Move), AI Offensive or AI Defensive, and weapons. | Guards another of your ships. |
| Shuttle | A 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
| Setting | Values | Meaning |
|---|---|---|
role | miner, shuttle, battleship, fighter, scout, patrol, escort | The ship's role. |
cargo | 0–100 | How full the cargo gets before the ship leaves. |
miningspeed | m/s | Highest speed while drilling. 0 lets PAM choose. |
manoeuvrespeed | m/s | Highest speed to and from the rock. 0 lets PAM choose. |
dockingspeed | m/s | Highest speed near a dock. 0 lets PAM choose. |
radius | 0–25 m | Drill radius. 0 uses the size the game reports. |
overlap | 0–50 % | How much neighbouring tunnels overlap. |
clear | m or off | Clear stone without keeping it, until this many metres before the ore. |
minjump | km | End the job and go home when jump range falls below this. 0 is off. |
returnafter | minutes | Go 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. |
evade | km | How far an evasive jump goes. |
logores | on / off | Log ore found by the ship's ore detector. Needs a working ore detector; the job scan does not. |
returnenemy | on / off | Go home when an enemy is seen. |
returnore | on / off | Go home when the ore detector finds ore. Combat roles only. Needs a working ore detector. |
jumps | on / off | Jump instead of flying when the ship can. |
station | grid name or none | Where the ship docks to unload and charge. |
dock | connector names or any | Which 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 90Leaves 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 onLogs 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.
!pam home, empty it, then !pam resume.
🛡️ Warships: escort groups and “mayday”
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, orany. - If the ship cannot unload, it leaves with its ore so the dock stays free.
- Use
!pam stationsto 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.
🤖 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.