Files
Aurora.3/code/modules/overmap
naut 6c079c4e1b Sensor relay refit (#19021)
Overhauls the sensor relay away site to be up to modern standards. It's
now more practical, more decrepit, and has more facilities for things
while retaining the old loot and goodies it had before.

The place starts depowered, save for the airlocks, which are powered by
default to allow entry without having to bust down a
window/wall/inflatable and vent the place.

In addition this PR adds a special sprite for the sensor array the relay
uses, and tweaks its stats:
* Now has a maximum range of 24.
* Has a stable range of 10.
* Cannot deep scan at all.
* Overheats very quickly at high ranges.
* Detects passing ships slower than a standard relay.

The above should make it more worthwhile to capture and use, as when
datalinked it provides visibility of a large portion of the sector.


![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/e53fd13e-ca7c-402e-9605-c213f729df7d)


![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/8d09db8e-b688-4dca-84b1-2945dc70f702)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/9e644f4c-1cf4-4fbc-8119-1cbfbba59a15)

# Before powering

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/156b61bd-eb7b-4cfc-8eca-5a752c4c4bea)

# After powering
<details><summary>Click to expand</summary>
<p>


![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/357f01fc-c0ce-46ca-9869-3ec4bdd6a14e)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/b3f74c29-14ad-4765-94b8-81b0591e5916)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/d155dd5f-69ff-4171-a0e0-ac871cff3415)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/e1db7407-8e7a-4c54-bfe4-0103000fc317)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/ffb63725-a34f-4743-a82c-c780a11421c0)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/59aeedae-7d3c-458b-bea5-5fe8cc94ebf0)

![image](https://github.com/Aurorastation/Aurora.3/assets/55491249/10f2cfba-fb80-4f2e-b8e4-d74a95f6830c)

</p>
</details>
2024-05-05 01:16:24 +00:00
..
2024-05-05 01:16:24 +00:00
2024-04-19 21:56:26 +00:00

/*
The overmap system allows adding new maps to the big 'galaxy' map.
There's overmap zlevel, that looks like a map. On it, token objects (overmap objects) are moved, representing ship movement etc.
No actual turfs are moved, you would need exploration shuttles or teleports to move atoms between different sectors/ships.
Unless stated otherwise, you just need to place any of things below somewhere on the map and they'll handle the rest.

*************************************************************
# How to make new sector
*************************************************************
0. Map whatever.
1. Make /obj/effect/overmap/visitable/sector/[whatever]
	If you want explorations shuttles be able to dock here, remember to set waypoints lists
2. Put /obj/effect/overmap/visitable/sector/[whatever] on the map. Even if it's multiz, only one is needed, on any z.
3. Done.

*************************************************************
# How to make new ship
*************************************************************
0. Map whatever.
1. Make /obj/effect/overmap/visitable/ship/[whatever]
	If you want explorations shuttles be able to dock here, remember to set waypoints lists
2. Put /obj/effect/overmap/visitable/ship/[whatever] on the map. If it's multiz, only one is needed, on any z.
3. Put Helm Console anywhere on the map.
4. Put Engines Control Console anywhere on the map.
5. Put some engines hooked up to gas supply anywhere on the map.
6. Done.

*************************************************************
# Overmap object
*************************************************************
/obj/effect/overmap/visitable
### WHAT IT DOES
Lets overmap know this place should be represented on the map as a sector/ship.
If this zlevel (or any of connected ones for multiz) doesn't have this object, you won't be able to travel there by ovemap means.
### HOW TO USE
1. Create subtype for your ship/sector. Use /ship one for ships.
2. Put it anywhere on the ship/sector map. It will do the rest on its own during init.
If your thing is multiz, only one is needed per multiz sector/ship.

If it's player's main base (e.g Aurora), set 'base' var to 1, so it adds itself to station_levels list.
If this place cannot be reached or left with EVA, set 'in_space' var to 0
If you want exploration shuttles (look below) to be able to dock here, set up waypoints lists.
generic_waypoints is list of landmark_tags of waypoints any shttle should be able to visit.
restricted_waypoints is list of 'shuttle name = list(landmark_tags)' pairs for waypoints only those shuttles can visit

*************************************************************
# Helm console
*************************************************************
/obj/machinery/computer/ship/helm
### WHAT IT DOES
Lets you steer ship around on overmap.
Lets you use autopilot.
### HOW TO USE
Just place it anywhere on the ship.

*************************************************************
# Engines control console
*************************************************************
/obj/machinery/computer/ship/engines
### WHAT IT DOES
Lets use set thrust limits for engines of your ship.
Lets you shutdown/restart the engines.
Lets you check status of engines.
### HOW TO USE
Just place it anywhere on the ship.

*************************************************************
# Thermal engines
*************************************************************
/obj/machinery/atmospherics/unary/engine
### WHAT IT DOES
Lets your ship move on the map at all.
### HOW TO USE
Put them on map, hook up to pipes with any gas. Heavier gas (CO2/plasma) + More pressure = more thrust.

*************************************************************
# Exploration shuttle terminal
*************************************************************
/obj/machinery/computer/shuttle_control/explore
### WHAT IT DOES
Lets you control shuttles that can change destinations and visit other sectors/ships.
### HOW TO USE
1. Define starting shuttle landmark.
2. Define a /datum/shuttle/autodock/overmap for your shuttle. Same as normal shuttle, aside from 'range' var - how many squares on overmap it can travel on its own.
3. Place console anywhere on the ship/sector. Set shuttle_tag to shuttle's name.
4. Use. You can select destinations if you're in range (on same tile by defualt) on the map and sector has waypoints lists defined
*/