PAM Workflow
How the pieces fit together, with a full start-to-finish example for each capability.
!pam chat commands.
🧩 Visual map: what points at what
Read the arrows. A profile is how; a job is where and what; the ship is which grid. The start command names a job, a profile and a ship.
🏷️ The names, and what each one is
| Example name | Kind | Created or set by | Used in |
|---|---|---|---|
"Thorium Test" | Job (where/what) | !pam job new | !pam start, !pam group, !pam queue add |
"Miner Test" | Profile (how) | !pam profile new | !pam start, !pam group, !pam queue add |
"Sens Miner" | Ship (grid) | The grid's name in game | !pam start, !pam group, status/stop |
"sens station" | Station grid | The grid's name in game | The profile's station setting |
"PAM Dock 1" | Connector | A connector on the station | The profile's dock setting |
"GPS:thor:..." | Location | A GPS in the game | !pam job new |
!pam profile set "Sens Miner" ... fails because Sens Miner is a ship. !pam profile set "Thorium Test" ... fails because Thorium Test is a job. !pam job new "Miner Test" "Sens Miner" fails because the second value must be a GPS.
🗺️ The journey, as a board
Prepare
Ship with drills, connector, thrusters, gyro, power and cargo. Station with connectors. GPS at the rock.
Define
Profile: role, cargo, speeds, station, connector. Job: GPS and ore.
Start
!pam start, !pam group or !pam queue add. Job + profile + ship.
Work
Scan, plan, line up, drill, leave. Full cargo, damage, power or a block stops it.
Finish
Dock, unload, recharge, return to the rock; or finish and go home. Queue moves on.
🚀 Full examples, start to finish
Every example on this page uses the same cast, so there are no unexplained names:
| Name in the examples | What it is |
|---|---|
"Thorium Test" | The saved job. |
"Miner Test" | The profile. |
"Sens Miner" | The ship (its grid name). |
"sens station" | The station grid. |
"PAM Dock 1" | A connector on that station. |
"GPS:thor:35875.86:12311.12:26887.91:" | The GPS of the rock. |
Thorium | The ore to mine. |
Universal form: !pam start <job> <profile> <grid>. Angle brackets are placeholders: replace them with your names. Put quotes around a name that contains a space; a GPS is always in quotes.
A. Quick GPS mining (no saved job, no profile)
For this example: GPS "GPS:thor:35875.86:12311.12:26887.91:"; ore Thorium; grid "Sens Miner".
Syntax:
!pam start <gps> [ores] [grid]
<gps>— the rock, in quotes.[ores]— one ore, a list such asiron,nickel, or blank/allfor the whole asteroid.[grid]— the grid name of the ship. Leave it out if you are sitting in it or it is your only active ship.
Example:
!pam start "GPS:thor:35875.86:12311.12:26887.91:" Thorium "Sens Miner"
Starts mining Thorium on the grid "Sens Miner". Default settings are used.
A GPS start cannot take a profile, so it will not dock unless a station is set through a profile and a saved job.
B. Saved job + profile (no station)
For this example: job "Thorium Test"; profile "Miner Test"; grid "Sens Miner"; GPS "GPS:thor:35875.86:12311.12:26887.91:"; ore Thorium.
Syntax:
!pam job new <job> <gps> [ores]
!pam profile new <profile>
!pam profile set <profile> <setting> <value>
!pam start <job> <profile> <grid>
<job>— a name you choose for the saved job.<gps>— the rock's GPS, in quotes. It must be a GPS, not a ship name.<profile>— a name you choose for the profile.<grid>— the ship's grid name.
Example:
!pam job new "Thorium Test" "GPS:thor:35875.86:12311.12:26887.91:" Thorium
!pam profile new "Miner Test"
!pam profile set "Miner Test" role miner
!pam profile set "Miner Test" cargo 90
!pam profile set "Miner Test" miningspeed 1.5
!pam start "Thorium Test" "Miner Test" "Sens Miner"
Without a station, the ship stops at Limit reached when full. Use !pam home "Sens Miner", empty it, then !pam resume "Sens Miner".
C. Miner that docks, unloads and recharges by itself
For this example: job "Thorium Test"; profile "Miner Test"; grid "Sens Miner"; station "sens station"; connector "PAM Dock 1".
Syntax:
!pam stations
!pam profile set <profile> station <station grid>
!pam profile set <profile> dock <connector names|any|none>
!pam start <job> <profile> <grid>
<station grid>— the station's grid name, from!pam stations.<connector names>— names from!pam stations, comma-separated and in quotes.anyis the nearest free connector;noneclears the choice.
Example:
!pam stations
sens station: PAM Dock 1, PAM Dock 2 (in use)
!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"
To pin connectors instead of any free one:
!pam profile set "Miner Test" dock "PAM Dock 1,PAM Dock 2"
!pam profile set "Miner Test" dock none
The ship mines to 90%, docks at sens station, unloads, charges to 95% power and fuel, undocks and returns to the same rock. Cargo and charge trips resume by themselves; damage or a called-home stop waits at the dock for !pam resume.
Which connector does PAM choose? dock any = nearest free connector of the right size; if any station connector has [PAM] in its name, only those are used. A small ship needs a small connector; a large ship needs a large one.
D. Several miners on one rock
For this example: job "Thorium Test"; profile "Miner Test"; grids "Sens Miner" and "Sens Miner Two".
Syntax:
!pam group <job> <profile> "<grid one,grid two>"
<job>— an existing saved job.<profile>— an existing profile; it is required.<grid one,grid two>— the grid names of the ships, comma-separated inside one pair of quotes.
Example:
!pam job new "Thorium Test" "GPS:thor:35875.86:12311.12:26887.91:" Thorium
!pam profile new "Miner Test"
!pam profile set "Miner Test" role miner
!pam group "Thorium Test" "Miner Test" "Sens Miner,Sens Miner Two"
Each ship gets its own place and its own tunnels. “Sens Miner Two” is a second ship's grid name, not a job or profile.
E. Queue several jobs on one ship
For this example: jobs "Thorium Test" and "Nickel Test"; profile "Miner Test"; grid "Sens Miner".
Syntax:
!pam queue add <job> [<profile>] [<grid>]
!pam queue [<grid>]
<job>— the saved job to queue.<profile>— optional; the settings for that job.<grid>— optional; the grid that runs the queue.
Example:
!pam job new "Thorium Test" "GPS:thor:35875.86:12311.12:26887.91:" Thorium
!pam job new "Nickel Test" "GPS:nickel:4000:5000:6000:" nickel
!pam queue add "Thorium Test" "Miner Test" "Sens Miner"
!pam queue add "Nickel Test" "Miner Test" "Sens Miner"
!pam queue "Sens Miner"
The next job starts when the current one finishes. It must be within 5 km, or reachable by jump. !pam queue skip 1 "Sens Miner" removes one; !pam queue clear "Sens Miner" empties the queue; !pam stop "Sens Miner" also empties it.
F. Shuttle route between stations
Names in this example: "Ore Run" = the shuttle job; "Hauler" = the profile; "Shuttle One" = the shuttle's grid name; "sens station" and "Outpost" = station grid names.
Syntax:
!pam profile set <profile> role shuttle
!pam shuttle add <job> <station grid>
!pam shuttle set <job> <stop> <setting> <value> [kg]
!pam start <job> <profile> <grid>
<station grid>— a grid name with a connector; eachshuttle addis one stop.<stop>— the stop number, counting from 1.<setting>—leave,minutes,wait,unloadorload.
Example:
!pam profile new "Hauler"
!pam profile set "Hauler" role shuttle
!pam shuttle add "Ore Run" "sens station"
!pam shuttle add "Ore Run" "Outpost"
!pam shuttle set "Ore Run" 1 load "Thorium" 50000
!pam shuttle set "Ore Run" 2 unload on
!pam start "Ore Run" "Hauler" "Shuttle One"
“Ore Run” is the shuttle job, “Hauler” the profile, “Shuttle One” the ship, and “sens station”/“Outpost” are station grid names. !pam shuttle trips "Ore Run" 2 limits the route to two trips; 0 is until stopped.
G. Warship escort group on a miner
Names in this example: "Guard Duty" = the escort job; "Guard" = the profile; "Sens Miner" = the miner's grid name; "Warship One" and "Warship Two" = the warships' grid names.
Syntax:
!pam profile set <profile> role escort
!pam job escort <job> <guarded grid>
!pam group <job> <profile> "<grid one,grid two>"
<guarded grid>— the grid name of the miner being defended.<grid one,grid two>— the grid names of the escorts.
Example:
!pam gps "Sens Miner"
!pam profile new "Guard"
!pam profile set "Guard" role escort
!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"
Several warships can be assigned to one miner. They fly in formation and their AI blocks fight enemies in range. There is no mayday broadcast; the group stays with the miner it was assigned to. Set the AI blocks in each warship's control panel; PAM leaves them as set.
H. Status, stop, resume and home
For this example: grid "Sens Miner".
Syntax:
!pam status [<grid>]
!pam stop [<grid>]
!pam resume [<grid>]
!pam home [<grid>]
Example:
!pam status "Sens Miner"
!pam stop "Sens Miner"
!pam resume "Sens Miner"
!pam home "Sens Miner"
statusshows the job, cargo, power, health and the measured drill pace.stopstops the ship and ends the job; it also empties the queue.resumecontinues a ship waiting at a limit, a dock, or the job start.homebacks out of the tunnel and returns to the job start or station.
⌨️ Command options, one line each
| Command | Arguments and options |
|---|---|
!pam start <gps> [ores] [grid] | GPS start, default settings. ores: one ore, a list with commas/spaces, or leave out/all for the whole rock. ship: optional if sitting in it. |
!pam start <job> [profile] [grid] | Saved job. Add the profile for its settings; add the ship to choose the grid. Without a profile, default settings are used. |
!pam job new "<name>" <gps> [ores] | Saves the job. The second value must be a GPS, never a ship name. |
!pam profile new "<name>" | Creates a profile with default settings. |
!pam profile set "<name>" <setting> <value> | Changes the profile. Settings: role, cargo, miningspeed, manoeuvrespeed, dockingspeed, radius, overlap, clear, minjump, returnafter, lowammo, lowshield, lowhull, lowpower, evade, logores, returnenemy, returnore, jumps, station, dock. |
!pam group <job> <profile> "<grid1,grid2>" | Starts one saved job on several ships. Profile required; grid names comma-separated in one pair of quotes. |
!pam queue add <job> [profile] [grid] | Adds a saved job to a ship's queue; starts it now if the ship is idle. |
!pam stations | Lists your station grids and connector names, including (in use). |
!pam job escort <job> <grid> | Sets the ship an Escort job guards. |
!pam gps <grid> | Adds the ship's position to your GPS list. |
!pam shuttle add|list|set|trips|clear | Builds and edits a shuttle route. See the Shuttle section on Commands. |
🧹 List, show, change and remove
Two different things are easy to confuse: saved jobs are your stored recipes; active jobs are the jobs ships are running now.
| Thing | List / show | Remove or stop |
|---|---|---|
| Saved jobs | !pam job list!pam job show "<name>" |
!pam job delete "<name>"Rename: !pam job rename "<old>" "<new>"Change ore: !pam job ores "<name>" iron,nickel |
| Active jobs | !pam jobs!pam fleet!pam status <grid> |
!pam stop <grid> ends the active job (the saved job is kept).!pam home <grid> sends it home. |
| Profiles | !pam profile list!pam profile show "<name>" |
!pam profile delete "<name>"Change one setting: !pam profile set "<name>" <setting> <value> |
| Stations | !pam stations lists your station grids and connector names. |
There is no PAM command to delete a station; a station is a grid. Stop using it: !pam profile set <profile> station none.Use any connector again: !pam profile set <profile> dock none. |
| Queue | !pam queue <grid> |
!pam queue skip <number> <grid>!pam queue clear <grid> |
| Shuttle route | !pam shuttle list <job> |
!pam shuttle clear <job> removes every stop from that route. |
| Alerts and ore log | !pam alerts!pam ores |
!pam alerts clear!pam ores clear |
!pam profile list
!pam job list
!pam stations
!pam job delete "Old Iron Run"
!pam profile delete "Old Miner"
!pam profile set "Miner Test" station none
!pam queue clear "Sens Miner"