PAM Safety & Limits
What PAM does when the server lags, a ship reaches a limit, or something is in the way.
The server plugin protects the server's sim speed and your ships. It watches lag, stops ships at limits, and releases anything it can no longer control safely.
📉 Lag safety
Sim speed is how fast the server runs. 1.00 is normal. When it drops, ships do not move as expected and can crash. PAM watches it.
| Sim speed | What PAM does |
|---|---|
| Below 0.70 | Warns all players with a Lag alert: “Warning: sim speed is 0.65. Ships stop at 0.50.” |
| Below 0.50 for 5 seconds | Stops all ships where they are. The ships show “Paused”. |
| Above 0.70 for 15 seconds | The ships go back to work. |
The server admin can change these numbers in the Torch settings.
⏸️ Admin pause
An admin can stop every PAM ship with !pam admin pause. The ships wait where they are with the status “Paused”. Players get an Admin alert.
!pam admin resume releases the hold. If lag safety still holds the ships, they wait until sim speed recovers.
⛏️ Limits while mining
PAM checks each mining ship once each second. A ship stops mining when:
| Limit | Example |
|---|---|
| Cargo reaches the profile's Cargo % | “Cargo full: …” |
| The ship is too heavy for its thrusters | “Too heavy: …” |
| Power or fuel is down to what the trip home needs | “Power is down to what the trip home needs: …” |
| Jump range falls below Min jump km | “Jump range is down to X km.” |
| Thrusters, gyros or drills are lost | “Damaged: … lost.” |
| A profile return rule triggers | “Returning: Low power.” |
- The ship stops its drills and backs out of the tunnel.
- With a station, it docks, unloads and charges. Cargo or charge trips go back to work by themselves; damage or a called return waits at the dock.
- Without a station, it waits next to the rock at Limit reached.
🚧 When something is in the way
- The ship looks ahead as far as it needs to stop.
- If something blocks it, the ship stops and holds. Its status says “Blocked by” and the obstacle.
- It goes on 5 seconds after the way is clear, and looks for a way around every 15 seconds.
- After 5 minutes you get a Blocked alert.
- If the ship pushes for 30 seconds without moving, it holds and alerts.
- If the drills make no progress for 45 seconds, PAM ends that tunnel and moves to the next.
🏗️ At the dock
| Situation | What PAM does |
|---|---|
| All docks are in use | The ship waits in line: “Waiting for a dock”. |
| The line has not moved for 5 minutes | A Blocked alert. |
| The ship cannot connect after 3 tries | “Couldn't connect at X after 3 tries.” It waits for you. |
| Unloading stops for 60 seconds | The ship leaves with its ore, so the dock stays free. A Limit alert. |
| Still charging after 5 minutes | A Limit alert. The ship waits at the dock. |
| Something blocks the way out | “No way out of …: something has been built around it. Waiting docked.” |
Charging ends when power and fuel reach 95%.
💥 If the ship breaks
- Split: the job ends. A piece that can hold itself still holds; other pieces are released with dampeners on. A Split alert.
- Grid removed or becomes static: PAM gives the ship back. A Damage alert.
- Sold or given away: its job ends.
🚫 Server limits
The server admin can set these to protect server sim speed:
| Limit | What happens |
|---|---|
| Max ships per player | “This server allows N active ships per player.” 0 means no limit. Mining and role ships count together. |
| Max armed ships per player | “This server allows N armed ships per player.” 0 means no limit. |
| Keep-out distance | “That's within … of another player's grid, and this server keeps ships out.” Your grids, allies' grids and NPC grids do not count. |
| Allow combat roles | When off: “This server doesn't allow combat roles.” |
📏 Fixed limits
| What | Limit |
|---|---|
| Ship to job GPS | 5 km (a jump drive can jump there first) |
| GPS to asteroid | 200 m |
| Saved jobs per player | 200 |
| Profiles per player | 50 |
| Alerts per player | 200 |
| Logged ore deposits per player | 500 |
| GPS points in one job | 64 |
| Ships on one job | 50 |
| Drill radius | 25 m |
| Tunnel overlap | 50% |
See also: