User:Zamujasa/Mechanics

Most of the notes on this page are based off of the 2016 code release, and might not be accurate for the current world.
I'll try to note where things are known to have been updated.

This is a page that tries to explain how some of the more obscure parts of Space Station 13 work; mostly the underlying numbers powering mechanics or other details. In practice, it probably won't be too useful or life-changing, but if you're curious, this is a page for you!

[11:51 AM] NDFCNFNCD: Sometimes I get the feeling Zamujasa is a highly complex spreadsheet that's gained sapience.

Power

The station's power grid (also known as the "powernet" or "pnet" for short) has a few main components that govern how it works, and they are usually wired together by small red cables.

Power generally follows this pattern:

1. Power source (Engine, solar panels, etc)
2. "supply-side" wiring
3. SMES units
   • Optionally bypassed by connecting the supply and output networks directly, known as "hotwiring"
4. "output-side" wiring
5. APCs, which power areas

Very few things connect directly to the power part of the powernet outside of these; most equipment will draw from the local APC instead.

SMES units

Maximum capacity of 100,000,000 W (100 MW). Maximum input and output rates of 200,000 W (200 KW).

Charging

• Charges using the terminal-side interface only.
• Won't charge at all if input > available.
• Won't use extra power if available ≥ input.

Discharging

• Discharges using the cable-side interface only.
• Will output exactly how much power is specified in output, even if not needed.
• Attempts to reclaim unused power after discharging.
  • Basically, if it outputs 100,000 W but only 60,000 W is used, will try to remove 40,000 W and add it back to its storage.
  • Some notes on the wiki here suggest that this is kinda fucked up and can result in power dissipating into the void???
  • "Order" of SMES units is vaguely important. If two are outputting 100 KW (200 KW total) but only 150 KW is being used, only one of the SMES units will 'reclaim' that power.
• The amount of power being actively used is shown as the "load". You can intentionally lower the output to spread the load across multiple units.

If you can figure out the priority of the SMES units, you can set them up like this, assuming a 70 KW average load with occasional telescience nerds:

• Unit 1: Output 40,000 W
• Unit 2: Output 40,000 W
• Unit 3: Output 200,000 W

Assuming that all three SMES units are charging at 200 KW and the priority is right, unit 3 will stay fully charged most of the time but will handle excess load, while the former two stay fully powered indefinitely.

Not much of a reason to do this unless you like micromanaging things or ensuring that a loss of power doesn't cripple things.

APCs

Those little squares that regulate power for a room.

For automatic settings:

• Equipment: Turns off at < 15% power (probably). Usually stuff like doors, computers.
• Lighting: Turns off at < 30% power (probably). It's the lights.
• Environment: Turns off when there's no power at all. Not a lot of things use this, though.
  • Fire alarms
  • Pipes
  • Power gloves (possibly)

Power gloves are weird because the code seems to check if you're on a powered/connected wire (as expected) but then chooses to use 50,000 W Environmental from the local APC and disregards the power in the wire completely. This may have been changed since the 2016 release since otherwise it makes hotwiring the engine kinda pointless.

The powernet keeps track of how many APCs are attached to it as numapc, and how much power is available to each (avail ÷ numapc = perapc).

When an APC draws or gives power to a cell, the amount (W) is multiplied by CELLRATE (0.002). ^{The 2016 comments suggest this is supposed to be 2%, but 0.002 is 0.2%.)}

Operation

APC operation is a little complex:

1. If we have no cell at all, turn everything off and stop. Otherwise...
2. Calculate power usage ((Equipment + Lighting + Environment) W) as usage.
3. Draw usage from the cell.
4. If there is excess power in the powernet, or perapc > usage ...
   • Restore perapc to the cell.
   • Add perapc to the powernet load.
5. Otherwise, if (cell charge + perapc ≥ usage) ...
   • Restore perapc to the cell.
   • Add perapc to the powernet load.
6. Otherwise, turn everything off.
7. Auto-set options based on cell charge level.

Or in layman's terms:

1. Remove usage from the APC's cell.
2. Is the per-APC power allocation (perapc) higher than what we're using (usage)?
   • Yes: Draw that amount from the pnet and restore the perapc to the cell. (Basically: Cell doesn't discharge.)
   • No: Draw (usage - perapc) from the cell, and remove perapc from the powernet.

After determining if the area is powered, check if the cell should charge:

1. If the cell is charging...
   • If there's excess in the powernet...
     1. Find whichever is lowest of the remaining capacity of the cell, perapc, or the cell's max capacity × CHARGELEVEL (0.001). ^{The 2016 code comments suggest that 0.001 here is supposed to be 1%, but 0.001 = 0.1%. ?????}
     2. Draw that amount from the pnet.
     3. Add that amount to the cell.
   • Otherwise, stop charging.
2. Otherwise, if the cell is full, stop charging.
3. Otherwise...
   • If the excess power > (the cell's max capacity × CHARGELEVEL), start the charge counter.
   • Otherwise, reset the counter.
   • If the charge counter is at 10, start charging and reset the counter.

In layman's terms:

• If there's enough power to charge the cell...
  • If we're already charging, charge the cell more.
  • Otherwise, wait 10 ticks, and then start charging.
• Otherwise, stop charging.

Power cells

Come in a few varieties:

• 2,500: Standard APC cells.
• 4,000: AI shell cells.
• 7,500: Higher-capacity cells. Round-start Cyborgs and the AI start with these.
• 15,000: Standard regular power cells, found all over the station. Comes in two special flavors:
  • Cerenkite: Recharges 2 per tick.
  • Erebite: Violently explodes if you look at it funny. Otherwise, charges 10 per tick.
• Artifact cells can be anywhere from (15 ≤ x ≤ 1000) × 100, i.e. 1500 to 100,000. They always charge 50 per tick.

As noted above in the APC section, for the purposes of charging and discharging in APCs, the capacity is effectively divided by CELLRATE, 0.002 (i.e. multiplied by 500):

• 2,500: 1,250,000 W capacity
• 4,000: 2,000,000 W capacity
• 7,500: 3,750,000 W capacity
• 15,000: 7,500,000 W capacity
• Artifact cells can range from 750,000 W to 50,000,000 W (!) and recharge 25,000 W per tick.
  • Putting one of these in an APC will power pretty much everything indefinitely except for the Telescience portal.

Given that an SMES unit stores 100,000,000 W, these little batteries aren't too shabby.

Power usage across the station

Eventually, the amount of power used by various components will be here.

Fun facts about power sinks, based on the 2016 code:

• Can drain 200,000,000 W before exploding; basically, two full SMES units.
• Drains up to 400,000 W from powernet per tick.
• If powernet has < 400,000 W, starts draining up to 50 charge from APCs per tick until it reaches the limit.
  • This seems to be in cell units, not funny-watts like above.
  • A side effect of this is that the power sink will eat 25,000 W from a cell, but consider it as having eaten only 50.
  • It also considers any drain from an APC cell to be 50 units, even if the APC cell had less, though this doesn't matter as much since the effect APCs have on the limit is minimal.
• At 190,000,000 W (95%), the power sink will start making some horrible noises. If you hear those, you should probably run.

If you're dealing with a power sink, dump an additional 400 KW into the grid above what you normally would, and the power sink should stop draining APCs — you'll lose a lot less power this way due to the above!

I should ask a coder if any of this has changed since, welp

Lights

Power usage

Power usage of a light: light.brightness × LIGHTING_POWER_FACTOR (40)

Type	Brightness	Power Use
Light tube	1.6	64 W
Light bulb	1.2	48 W
Emergency light	1.0	40 W
"Exit sign" (unused?)	1.3	52 W
Runway Lights	0.5	20 W
Tripod Light	1.5	60 W
Desk and lava lamp	1.0	40 W

Colors

General manufacturers can make replacement light tubes and bulbs in varying colors. Some pre-made light fixtures have different, unique lights, generally darker and crappier for ambience.

All replacement lights look the same and are only differentiated by their name, except for blacklights, which have a unique name. Maybe someone could patch making lights actually look like the color they generate! Maybe you!

Light tubes

Type	Color
Regular
Red
Yellow
Green
Cyan
Blue
Purple
Blacklight1
Blacklight2

Light bulbs

Type	Color
Regular
Red
Yellow
Green
Cyan
Blue
Purple
Blacklight1
Blacklight2
Emergency

Other

Type	Color
Big bulbs

Notes:

1. Due to a bug, this is what happens in the 2016 code. Specifically, due to a typo, color_r is assigned to twice, and color_b is left default.
2. This is assumedly what it should be if the second color_r is changed to color_b.

This chart might actually be a little misleading, as the way light usually works in this game is that colors are subtracted from full-brightness, so e.g. a white light wouldn't remove any, while a red light would remove all blue and green coloring, rather than adding red everywhere.

Cyborgs

Cyborg health display:

• Structural Integrity: total_brute_damage / total_max_hp
• Circuitry Integrity: total_burn_damage / total_max_hp

This can be very misleading, as readouts of "60%" and "50%" might look like half health, but in reality the actual damage is 90%!

Different parts also have different health pools. Damage is either targeted at a single part, or spread equally among all parts. If you have a Light Cyborg and hit it with 150 BRUTE damage in one tick (somehow):

• 150 damage ÷ 6 total parts = 30 damage per part
• Head: 50 → 20
• Chest: 75 → 45
• Left Arm: 25 → 0 (Destroyed)
• Right Arm: 25 → 0 (Destroyed)
• Left Leg: 25 → 0 (Destroyed)
• Right Leg: 25 → 0 (Destroyed)

There is no way to determine the individual remaining HP of a part beyond using a Cyborg Docking Station, with the sole exclusion of when that part hits 0 (because it ceases to exist).

Part stats

All of this is from the 2016 code, of course, and may be different.

Cyborg parts

Part	Type	Max HP	Notes
Head	Light	50	Speed: +0.20
	Antique	150	Speed: +0.20
	Standard	175
	Sturdy	225	Penalty: +0.50
	Heavy	350	Penalty: +1.00
Chest	Light	75	Speed: +0.20
	Standard	250
Arms	Light	25	Speed: +0.20
	Standard	60
	Sturdy	100	Penalty: +0.50
	Heavy	175	Penalty: +1.00
Legs	Light	25	Speed: +0.20
	Standard	60
	Tread	100	Speed: +0.25 (and see below)

Special notes for treads:

• Increases power drain by 2.5 units per tick, each
• If at least one tread is equipped, reduces penalty by two-thirds (~67%)

When determining a Cyborg's movement delay:

1. If oiled, reduce delay by 0.5
2. For each leg, if that leg is missing, increase delay by 2.5
   • If the corresponding arm is also missing, increase delay by a further 1.0
3. Sum the penalty of all parts
4. If at least one tread is installed, divide penalty by 3
5. Add penalty to delay
6. Subtract total speed from delay
7. If the speed upgrade is equipped and active:
   • Reduce delay by 2.5 for each installed leg/tread part

Functionally:

• Light and round-start cyborgs will have a maximum HP of 225 and a +1.0 speed bonus
• Full Standard Cyborgs will have a maximum HP of 665 and no speed modifiers
• Full Heavy Cyborgs will have a maximum HP of 1,150, a total penalty of 1, and a +0.5 speed bonus

AI

AI Core:

• 100 max HP.
  • Each tick the AI is under 0 HP decrements a death timer, which starts at 100 ticks.
  • If the death timer hits zero or the AI reaches -100 HP, it dies.
  • When the AI's health is above zero, every tick will increase the death timer back towards 100, in increments of five.
• The AI power cell has 7500 charge.
  • If the AI is in an APC-powered area, it will regain 5 charge each tick. (Unlike most things, being out in space doesn't count as being powered.)
  • Otherwise, the AI will lose 5 charge each tick.
  • If the AI reaches 0 charge, it will be permanently stunned.
  • If the AI recharges to at least 100 charge, it will recover from the stun.

AI eyebots:

• 60 max HPl; starts with 40 HP.
  • I'm not sure if this is an oversight, bug, or of I'm just misunderstanding it.
• Starts with 4000 charge, follows typical Cyborg power cell rules. Probably.

Mechanics

You know, the Mechanic.

Reverse Engineering

Some notes:

• The ruckingeur kit shares its list across all kits. If you scan something into one, it'll be available to print from every other kit, on and off station. This includes things things scanned with the Syndicate scanner like crushers.
• You can print blueprints and insert them into pretty much any fabricator, not just the reverse-engineering one the Mechanics Lab starts with.
• Every item has a set "materials cost". When adding a blueprint...
  1. If the cost is ≥ 3, one of each material category is added and the cost is reduced by 3
  2. For every remaining cost, a random material category is added
• The time to fabricate is directly based on the cost.

Item costs

Each item, when reverse-engineered, costs a set amount of materials. The list is pretty big, so here's a spreadsheet.

The "average per type" column is just the average amount you'll need for metal, crystal, and conductive, the three types of materials that blueprints require. The list is missing newer-than-2016 items and updates, like drains or Syndicate drones.

Spawning

Each crewmember will generally start with a backpack containing a "starter" box. The starter box will contain:

• a Breath Mask (100%)
• an Emergency Oxygen Tank (15%)
• a full Emergency Suit set (10%)

Certain jobs also spawn with guaranteed items. This list isn't complete, and only features items that spawn in backpacks, not pockets or other equipment slots. For now.

• Captain, Head of Personnel
  • Emergency oxygen tank
  • Spare ID box
  • Flash

• Head of Security, Security Officer
  • Emergency oxygen tank
  • Security Starter Kit box

• Chief Engineer, Research Director, Medical Director
  • Emergency oxygen tank
  • Flash

• Detective
  • Emergency oxygen tank
  • Detective's VR goggles

• Roboticist
  • Crowbar

• Medical Doctor
  • Emergency oxygen tank, stolen from Roboticists by some jerk
  • Crowbar

• Miner
  • Emergency oxygen tank (not stolen)
  • Crowbar

• Mechanic, Engineer
  • Emergency oxygen tank

• Chef
  • Rolling pin

• Barman
  • Riot shotgun

• Clown
  • No backpack, but they do get a funny pack with some of its own crap.

^{2016+ update} Jobs that spawn with an emergency oxygen tank will instead have that tank placed in their starter box. This does not affect the random chance for the starter box's emergency oxygen tank, so it is entirely possible to end up with two of them.

Etc

(reserved for easy adding of new sections)