# Spacepod Expansion Design Document for Skyrat

### Introduction:

This document aims to explain the goals and purpose of spacepods.

## Spacepods:

Spacepods will enable players to engage in thrilling space combat, both against other players and AI-controlled opponents. They will provide a new method for mining, offering players an alternative to traditional mining techniques. Spacepods will use physics-based movement, allowing for smoother and more realistic navigation in contrast to the typical tile-based movement system. Jetpacks will be slowed down, making spacepods a more meaningful and efficient choice for navigating through space.
* Space combat with player and AI-controlled opponents
* New method for mining
* Physics-based movement for smoother and more realistic navigation
* Slower jetpacks for more meaningful spacepod usage

### Seegson Drive
The Seegson Drive will be the core mechanic for traversing hyperlinks.

Seegson drives will require fuel in the form of fuel cells. These can be created with the fuel cell recipie.

They simply enable you to access the space charter at hyperlinks.

## New enemies:

### Drones
Drones are a new enemy type that will fill space. They are mindless and only want to kill things that arent part of their faction. They have the ability to patrol a set amount of nodes or wander about aimlessly. Once they see you they will engage and try to kill you.

### Missile towers
Missile towers or launchers will automatically fire physics missiles towards you.

## Space Exploration:

### Space ruins

Space ruins will be split into a few categories:
1. Disabled: This means the ruin cannot be changed or is beyond saving, thus has been disabled and will not spawn.
2. Filler: These ruins are generally useless and add no content aside from filling the space.
3. Ghostrole: These ruins will have a guaranteed spawn of 1 upto 2. They will likely be placed in different spacenode.
4. Adventure: These ruins are generally linear and may not have combat, they have a start point and an end point, or may not. These are things that have well thought out design and are generally fun just to experience.
5. Easy: These ruins are easy to beat, with a few enemies scattered about.
6. Medium: Slightly harder to beat, with quite a few enemies scattered about.
7. Hard: These are hard to beat, may require a lot of skill, and have a lot of enemies everywhere.

The spacenode will dictate where it's spawned and when.

All skyrat ruins will be overhauled to be usable, and only TG maps will be disabled if required.

Current list of ruins:
TG Maps:

| Disabled | Filler | Ghost Role | Adventure | Medium | Easy | Hard |
| --------------------- | ------------------------- | ---------- | --------- | ------ | ---- | ---- |
| wayhome.dmm | abandonedteleporter.dmm | | | | | |
| whiteshipruin_box.dmm | allamericandiner.dmm | | | | | |
| | anomaly_research.dmm | | | | | |
| | asteroid1-6.dmm | | | | | |
| | atmosasteroidruin.dmm | | | | | |
| | botanical_haven.dmm | | | | | |
| | bus.dmm | | | | | |
| | derelict_construction.dmm | | | | | |
| | derelict_sulaco.dmm | | | | | |
| | ALL DJSTATION | | | | | |
| | emptyshell.dmm | | | | | |
| | | | | | | |

### Space levels(spacenodes)
Space levels will disconnected from one another(no z-linkage) aside from ONE immediate space level that is accessible. This immediate space level(named level 0) will contain the first hyperlink node that you can fly to.

Each new level of space accessible from the first node will have an entry point at one corner of the map, and an exit point on the opposite corner. The exit point is another hyperlink node.

All space levels will have randomly generated drones in, these drones will roam about the level and "patrol" areas. Depending on the difficulty of the spacenode there will be more or less.

Hyperlinks will be "linear" in the fact that the further you go, the hardest the spacenodes get.

Space levels will be split into these categories:
Safe: There will not be many drone patrols and most ruins will be easy or adventure.
Destiny: This will be the space level that will contain the next hyperlink.
Dangerous: This will contain mostly hard ruins with a very high presence of drones.
Final: This is the final spacenode, there will likely be a very hard to kill boss here.

Each progressive hyperlink node in a destiny level will have three options:
A safe spacenode.
A destiny spacenode.
A dangerous spacenode.

You can pick which one you warp to. If the spacenode is not a destiny node, its hyperlink will return you to the previous hyperlink.

### Hyperlinks
Hyperlinks are structures that you can find in space that are essentially "portals" to the next level. When you approach and interact with one you will be presented with the space charter, which shows what nodes are available to jump to from this hyperlink.

Hyperlinks can only be traversed using jump drives that pods have.

### Space Charter
The space charter will be available at the hyperlink node as a basic GUI showing what space nodes you can jump to.

## New Job - Spacepod Pilot:

A new job, the Spacepod Pilot, will be introduced as part of the station security team. Spacepod Pilots will be responsible for defending the station against hostile forces in space, pursuing criminals attempting to escape, and supporting other security personnel. They will start in a dedicated hangar within the security area, which houses their pre-built spacepod. The spacepod will require initial setup by the Spacepod Pilot, adding depth to the role and providing a sense of ownership and responsibility for the spacepod.

* Part of the station security team
* Defend the station against hostile forces in space
* Pursue criminals attempting to escape
* Start in a dedicated hangar with a pre-built spacepod
* Initial spacepod setup required