Skip to content

Cargo Design Doc Proposal#618

Open
TiniestShark wants to merge 2 commits intospace-wizards:masterfrom
TiniestShark:CargoProposal
Open

Cargo Design Doc Proposal#618
TiniestShark wants to merge 2 commits intospace-wizards:masterfrom
TiniestShark:CargoProposal

Conversation

@TiniestShark
Copy link
Member

Cargo is currently in an interesting position in terms of how it relates to the station. Despite their role as the primary supplier of resources: many of its mechanics encourage it to operate on its own terms which typically creates quite a bit of friction between it and the departments its supposed to assist. It also gigantic points of failure in both the ATS and Cargo Shuttle that are frequently exploited by antags and used to shut the department down entirely. Other departments rarely have much say in how Cargo operates due to Department Economy not having many mechanics to support it, and their orders still need approval by Cargo in order to be processed. Bounties don't encourage cooperation as much as they rely on a promise that filling one out for Cargo might get you materials later if they feel it. Deliveries are poorly encouraged and typically very uninteresting to engage with.

Cargo's my favorite department because the loop absolutely can work, but it working is usually in despite how it's designed. My favorite rounds are always the ones where all of Cargo is being proactive in attempting to anticipate what other departments need, or maneuvering around dangers through alternate paths to deliver crucial resources in tight situations, or simply having to improvise after the ATS or Shuttle were sabotaged and danger immediately followed.

This is my attempt to rework Cargo into a more cooperative form to ideally promote and emphasize what really works about the department and create a more engaging back and forth with the rest of the station.

Basic doc created
@TiniestShark
Copy link
Member Author

I've also got two spreadsheets already made detailing Cargo's entire catalogue and their list of bounties. Even if my proposal is rejected, hopefully those can still be useful in some way.

@lilian-paddleston
Copy link

This doc doesn’t touch well on the ATS or the Cargo shuttle, two areas of the Cargo gameplay loop that have caused distinct concerns with cross-station accessibility and antagonism what with space gameplay. I think it would be worthwhile to cover these as part of your document.

Some parts of this document could also use touching up. What is a shipment? How are they of fixed size? How do you intend to rotate offerings? What does emergency supplies look like to you?

Go through the doc and ask yourself, “why this solution to this problem, instead of another one?” It’s a good tool to evaluate if you have justified your design, and to look frankly at your ideas.

That being said, I do like some of this document though. Good bones I think.

@Djungelskog2
Copy link

some minor issues ive thought of

  1. With supplies being more limited, I think it should be mostly limited to luxury items opposed to anything beyond simple, unless the rotating shop rotates fairly often and is extremely expansive like, 1/3 of the original catalogue at any given time massive. mainly so people dont have to gamble their time or wait for specific time stamps to get what they want while still making it so that if they dont orger something in time they gotta wait another 15 minutes. I think departments not having funds for something in the store for a limited time would also be super punishing. I also think resource management boiling down to station wide chair dismantling every round would be very fun. It all just really depends on how much is in rotation and how often it rotates.
  2. the variations of deliveries seem quite shallow, deliveries of multiple crates seem extremely trivial to solve, you either put them all in one crate to avoid the undescribed penalty or just use the tool provided. there isnt really a detriment to either or substantial gameplay difference that would make it any different from being a single crate. heavy/hazardous deliveries are a cool concept, especially if they have visual clarity, but its specifically the heavy ones that I take issue with because of how scarce mechs are and how easy to outright steal they are. I would suggest forklifts or mech revisions but those are whole separate, massive things.

Also, with how deliveries are reworked does this make them more akin to most 13 servers' cargo ship?

@Djungelskog2
Copy link

Djungelskog2 commented Mar 18, 2026

other than those two things though i love it

Copy link
Member

@iaada iaada left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have two main concerns with the doc. The first is that it relies on a lot of existing knowledge for how cargo plays, and the second is how it's straddling between a design document and a design proposal. That second part is probably just semantics but to explain myself, it's equal parts "what Cargo should be" and "how to turn it into what it should be."

Because you're defining both parts in one place, you need to spend a lot of words painting the picture. Separated, a design document can be unburdened with how to achieve its goals and focused on the ideal concept. On the other hand, A proposal can shortcut a lot of its justifications by citing design pillars and focusing on how it's an improvement over current implementations.

All said though I like the proposal part. I think limiting the market gives Cargo an urgency they lack and injects variety by surfacing unknown options. Removing the massive points of failure that constantly hamstring the department is sorely needed. Though not strongly touched on, I agree on the design that cargo should be the source of materials needed throughout the station.

@@ -0,0 +1,100 @@
# Cargo Rework Proposal
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd prefer a less generic name for the proposal so that we're more clear on what's being proposed.


## Overview

This rework is intended as a foundational reinterpretation of Cargo’s gameloop that focuses on creating a more dynamic back and forth with the station and its flow of resources. Emphasis will be placed on Cargo’s interaction with other departments and the ability for the station to quickly acquire materials and resources will be limited to encourage improvisation, pro-active thinking and gameplay, and add to the level of unpredictability a round may face. Cargo’s gameplay should be simple on the surface but more malleable than most departments through station hazards and antagonists due to the importance of their job on station.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This rework is intended as a foundational reinterpretation of Cargo’s gameloop

It's this line that makes me wonder why you wrote this as a proposal instead of Department Design. I feel that the design elements throughout should be in a different doc than the implementation specifics. A proposal should be about fulfilling the design document, not as an authority of the design.


> IE: The Ripley is their primary form of moving heavy cargo. The Ripley is a large, unarmored mech with a thin canopy, and two large claws for holding large objects. While there is technically a Mk 2 Ripley, this would be a new version specifically made by Science. If Cargo wished to upgrade Ripley on their own, it would be the addition of scrounged materials like welded plates to increase its armor, purchased tools crudely swapped between arms and likely some degree of paint to keep its color scheme.

Cargo itself is divided into three main roles:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel it's too specific a design to talk about jobs in a foundational document, at least not as something which certainly exists. Jobs could be removed or new jobs could be added, which would require a change to the document (and foundational documents need to be rock solid). I for one have an argument for rezoning Hydroponics as part of Cargo I've been itching to sell.

Jobs should probably be in their own document, but this all speaks to a convention for organizing the docs repo which doesn't exist.


In terms of visuals: Cargo’s primary colors are Yellow-Tan and Brown, with Salvage having purple added to distinguish their sub-department. The basic cargo outfit is a yellow vest on top of a grey jumpsuit to emphasize their civilian disposition, they have few dedicated tools unique to their department and primarily acquire more by their dealings with other departments or the things they are able to purchase on the market. This creates an “Everything in the kitchen sink” aesthetic where their base look is frequently blended with other departments or groups. They are last in line for fancy new tech and that should be reflected in their design.

> IE: The Ripley is their primary form of moving heavy cargo. The Ripley is a large, unarmored mech with a thin canopy, and two large claws for holding large objects. While there is technically a Mk 2 Ripley, this would be a new version specifically made by Science. If Cargo wished to upgrade Ripley on their own, it would be the addition of scrounged materials like welded plates to increase its armor, purchased tools crudely swapped between arms and likely some degree of paint to keep its color scheme.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> IE: The Ripley is their primary form of moving heavy cargo. The Ripley is a large, unarmored mech with a thin canopy, and two large claws for holding large objects. While there is technically a Mk 2 Ripley, this would be a new version specifically made by Science. If Cargo wished to upgrade Ripley on their own, it would be the addition of scrounged materials like welded plates to increase its armor, purchased tools crudely swapped between arms and likely some degree of paint to keep its color scheme.
\```admonish example
The Ripley is their primary form of moving heavy cargo. The Ripley is a large, unarmored mech with a thin canopy, and two large claws for holding large objects. While there is technically a Mk 2 Ripley, this would be a new version specifically made by Science. If Cargo wished to upgrade Ripley on their own, it would be the addition of scrounged materials like welded plates to increase its armor, purchased tools crudely swapped between arms and likely some degree of paint to keep its color scheme.
\```

(Without the slashes)

The repo has a fancier way to do a quote block you might like. You can see it and others on https://docs.spacestation14.com/en/meta/docs-example-page.html


# Design Breakdown

This section will break down the major parts of Cargo and their intended operation. This system should be paired with some increased level of resource consumption on station, or the lessening of many resources that let departments operate for most if not all shifts without the need for resupply.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a big ask to actually get done, but I absolutely agree it needs to happen. With the core concept of cargo being, "we have the things you want," it greatly undermines their place when people barely need them.


As Cargo is the direct supplier of materials on station, balance must be carefully considered at all levels of its implementation. Supply lines will always be a priority target for Antagonists and this should be a considered design choice, but something possible to work around. Points of failure should account for this factor and include alternative methods of being worked around or allowing Cargo to improvise in some manner.

## Item Catalog and Ordering
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section feels a little long. It's about just one implementation specific and spends a lot of time justifying the change. I see the merit and think it's an interesting change, but it feels more like a design pillar.


Fun options should still always be available as they are still core to the Space Station experience (Although still shuffled around to create some degree of randomization).

## Station Item Delivery
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section reads completely as proposal to remove the cargo shuttle and ATS, without actually saying so. It's an explanation of exactly how items are brought to the station and how to implement it. I think it would be a good change.

As a design document, it's so busy explaining the technical aspects that it has very little explanation of the player. How are players meant to interact with this design? How does this design make improvements over past pitfalls?


Telepads will continue to be a distinct upgrade for Departments to allow them to bring in items directly if need be. To keep this upgrade from circumventing the system entirely and to encourage its use more carefully: Telepads should have a cooldown between uses with distinct visuals to communicate this to the crew.

## Department Delivery
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a lot said over what feels like a very simple statement; Deliveries should have varied challenges and varied solutions. I think you're going too in-depth on what we want players to do, and in a sense dictating a meta on how we want players to act. All we really need to say is that we want to make deliveries fun, and want to give players choices in how they make their deliveries.


“Scavenger Hunt” bounties for items that cannot be produced can be easily found shouldn’t require large amounts of that item so a station isn’t depleted of it if a bounty for that item appears.

Money can also be made through selling high value items, with future sales of that item reducing the value in half for each future sale. This is both to discourage “Factory” style gameplay, and allow Departments to have a way of earning money outside of bounties through selling rare items they are capable of producing.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Money feels like an unaddressed area of the design. It's the central resource of the department, but the doc assumes prior knowledge of spesos and how it all works. Money at least deserves its own section on how players use, obtain, and exchange it instead of sharing a section with bounties.

I feel it's important to be be explicit about what "Factory" style gameplay is here (or somewhere) and why we don't want it. By building a picture of bad player behavior and the designs that cause it, we have better tools to understand how to improve than we would with just a prescription solution.


Money can also be made through selling high value items, with future sales of that item reducing the value in half for each future sale. This is both to discourage “Factory” style gameplay, and allow Departments to have a way of earning money outside of bounties through selling rare items they are capable of producing.

## Mail
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just restating the current state of the game. In a Department Design I wouldn't even expect to see mail mentioned. As you say, "[mail is] a miniaturized version of Cargo’s ideal roundflow." We wouldn't need to mention mail because the document would be about describing Cargo's ideal roundflow, not implementations of it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants