🛡️
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 speedWhat PAM does
Below 0.70Warns all players with a Lag alert: “Warning: sim speed is 0.65. Ships stop at 0.50.”
Below 0.50 for 5 secondsStops all ships where they are. The ships show “Paused”.
Above 0.70 for 15 secondsThe 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:

LimitExample
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

SituationWhat PAM does
All docks are in useThe ship waits in line: “Waiting for a dock”.
The line has not moved for 5 minutesA 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 secondsThe ship leaves with its ore, so the dock stays free. A Limit alert.
Still charging after 5 minutesA 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:

LimitWhat 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 rolesWhen off: “This server doesn't allow combat roles.”

📏 Fixed limits

WhatLimit
Ship to job GPS5 km (a jump drive can jump there first)
GPS to asteroid200 m
Saved jobs per player200
Profiles per player50
Alerts per player200
Logged ore deposits per player500
GPS points in one job64
Ships on one job50
Drill radius25 m
Tunnel overlap50%