The Barotrauma dev team's official manual for building your own fleets. It's the first, quick version, and a more in-depth guide coupled with a proper video tutorial is planned. This edition will hopefully help you get a handle on the most important aspects of sub building by introducing the key concepts and functions of the submarine editor.
Other Barotrauma Guides:
Submarine Builder's Manual
Hello subwrights! This is the Barotrauma dev team's official manual for building your own fleets. It's the first, quick version, and a more in-depth guide coupled with a proper video tutorial is planned. This edition will hopefully help you get a handle on the most important aspects of sub building by introducing the key concepts and functions of the submarine editor.
Different kinds of walls and platforms are used to keep oxygen inside and monsters outside, and to divide the interior space into smaller rooms and compartments.
When making a new submarine, it’s always a good idea to have a general idea of its shape and layout before building the outer hull. It’s a lot easier to add room inside for that oxygen generator you forgot to include, at first, if you don’t have to move all those carefully placed shell pieces, fins and lights just to create a bit more space. So starting with the outside hull is not necessarily the best course of action.
Outside walls are sturdier than inside walls, shuttle wall pieces are somewhere in between. We suggest using the walls as labeled for a more balanced experience, but of course it’s not mandatory. Best results often come when experimenting with different options.
After a piece of a wall (or most things in the editor, really) is placed, it can be flipped by it’s x- or y-axis by selecting it and pressing ‘Mirror X’ and ‘Mirror Y’ -buttons or CTRL+N or CTRL+M. Nudge it via the arrow keys.
Tip: If you’re feeling lost or need inspiration, open one of the ready-made submarines in the editor and take a look at how they’re built.
Tip: Tall subs tend to be less usable than long subs, and can look a little weird and off balance when in play. Crew should probably not need to climb up 5 stories of ladders to get to a leak or a fire.
Hulls and Gaps
Rooms inside subs in Barotrauma are defined by hull objects. If there are no hulls in the sub, there is nothing separating the sub from the water outside. Hulls also determine the overall size (= volume and mass) of the sub.
Hulls are displayed in the sub’s status monitor. Along with a room’s name, the monitor is capable of displaying the water level and quality of oxygen in a room. You can change what information is shown and if any sensors are required by modifying the status monitor.
In non-rectangular rooms, it’s often necessary to use multiple hull objects to cover the whole area. Link hulls together by selecting one hull, then holding space and clicking on another. This way linked hulls are displayed as a one, larger set.
Where hulls separate spaces, gaps connect them, allowing water and oxygen to flow from hull to another. Gap objects are placed automatically between hulls when a door or hatch is placed. For neighboring hulls with no walls, doors or hatches between them, a gap has to be placed manually. In the editor, red color means that a gap is currently closed, while blue means it is open.
A good number of devices in a submarine have to be wired into a power source to be powered, while others rely on specific signals, also delivered via wiring, to work in the way they’re intended. Entering the wiring mode in the sub editor allows you to run wires between devices like you would in-game. When wiring mode is toggled on, a selection of differently colored wires appears on the left hand side. Color differences are purely cosmetic, but there is a tradition of using red wires for power and blue for signals.
After selecting a wire, it is added to your inventory and equipped, along with a screwdriver. From here, wiring works like it does in-game. Please refer to the in-game Engineer training for more details.
When a wire is placed, it can be selected by clicking on it in wiring mode. Add a node by CTRL+clicking on the length of a wire. Move points by left-clicking and dragging.
Nuclear Reactor and Power Grid
The nuclear reactor is the source of almost all the power on board the submarine. It is the engineers' responsibility to keep reactors running, so each reactor in the sub should be assigned an engineer. In most cases, having one is enough. They have a tendency to overheat and eventually explode if not operated correctly, so place them a safe distance away from other vital devices.
Power is distributed through the sub via junction boxes, as devices cannot draw power straight from the reactor. Power wires need to be connected to junction boxes to calculate the grid’s power load correctly.
There are two major ways to wire power in a sub.
- Place junction boxes in each room, close to devices they're providing power to, or
- Group all junction boxes in a separate electrical room, where they can all be easily accessed.
The first solution makes troubleshooting easier, because problems can usually be traced to the closest junction box. On the other hand, grouping all junction boxes together makes them easier to maintain.
Tip: In most cases, it’s smart to keep everything in the same grid because the reactor always outputs the same amount of power to each grid. If there are two power grids with different loads, the one with the lower load will be overloaded and its junction boxes damaged. If you want to use multiple power grids, make sure their power requirements are balanced.
Tip: Install wires along walls and ceilings and use cable holders. It looks neater and more organized.
Engines, Ballast and Navigation
Engines provide thrust. You must place the engine so that its back half is in water and the front half inside the sub, or it will be damaged by water. You can use multiple engines to apply more force, but keep in mind their power consumption, which can be high and fluctuate when changing direction sharply.
An engine’s maximum force can be adjusted in the editor. This is useful if the sub’s horizontal movement can’t keep up with its ascent/descent speed or vice versa, which makes steering very difficult (and can and will result from the engines and ballasts being out of balance).
Where engines provide horizontal movement, ballast tanks are responsible for vertical movement. In their simplest state, they are empty rooms that contain a water pump. The pump is programmed to let water in to make the sub heavier or pump it out to make it lighter. This results in the sub either ascending or descending.
Tip: There can be any number of ballast tanks, although an optimal number is two or even three. One ballast can be fine, but then you run the risk of the sub being completely immobile if it gets punctured.
Tip: A natural place for a ballast tank would be on the bottom. Otherwise you will run into all kinds of issues ranging from leaks to maintenance problems.
The size of a ballast tank is an important factor in a sub’s handling. If it’s too small, the sub may not be able to descend; too big, and it may sink too easily. Aim for a combined neutral ballast level of .5 for optimal size. The size of a hull is shown in the upper left corner of the viewport when a hull is selected. Selecting multiple hulls will give their combined optimal neutral ballast level.
Engines and ballast levels are controlled via the navigation terminal. The terminal parses the direction given by the navigator in the sonar display and sends a signal to the engine (‘velocity_x_out’ to ‘set_force’) and ballast pumps (‘velocity_y_out’ to ‘set_targetlevel’).
Coilguns and railguns are a basic defense measure any standard sub should have. They both consist of a turret, a loader and a periscope.
Both coil- and railguns use a lot of power, more than regular batteries can provide, in short bursts when firing. This causes the power grid to fluctuate wildly, so it's best to use supercapacitors to power the sub's guns. Their capacity is low and the output high.
For either type of gun to work, their loaders must be linked to the gun (by selecting one, then holding space and clicking on the other) and a periscope must be placed somewhere to control them. Periscopes output a ‘position_out’ and a ‘trigger_out’ signals, which should be connected to ‘position_in’ and ‘trigger_in’ inputs in the turret itself.
Depth charges require a depth charge loader and a tube. Depth charge loaders should be linked to depth charge tubes on the outer hull. Charges are launched by giving the tube an activation signal, usually via a button.
Electric discharge coils work similarly to depth charges. They need to be wired into the power grid and given an activation signal. The actual coil is placed on the outer hull. The range of the electric shock created is set in the discharge coil item in the editor along with a multiplier when traveling along walls.
Oxygen generators generate oxygen and thus breathable air for the entire sub. Like everything else on board, they require power to function, and they must be linked to an oxygen vent in any hull that is supposed to have breathable air. To link the generator to a vent, select the oxygen generator, then hold space and click the vent. You should see a green line between the items. If not, check if you have ‘Links’ displayed on the left hand side of the screen.
The amount of oxygen needed is based on the hull volume and the size of the crew. Oxygen levels are hull specific, which means the more crew members in a hull, the more quickly its oxygen level is depleted. Oxygen moves between hulls via gaps.
Airlock, Docking and Cargo Bay
Any submarine worth its salt has a way for a person to enter and exit it without excessive flooding. A standard airlock has a setup of multiple doors that stop the water before it gets further inside and a water pump to get rid of it once the airlock is closed.
Docking ports are devices that clamp two structures (submarines, shuttles, outposts etc.) together, making it possible to walk from one to the other without getting your feet wet. Docking ports act independently from hatches and doors, so remember to also place a hatch wherever a port is to control passage.
Tip: A good way to wire a docking port is to link it to its hatch. When the port is engaged, the hatch opens. Find a working example in the sub editor’s Item assemblies category.
Equipment and Security
To prevent traitors and other undesirables from causing too much damage, it may be smart to lock weapons and explosives somewhere where only authorized personnel can reach them. To do this, add a tag to the 'picked required' field of a door. For example: to only allow security officers to open a door, add a tag 'id_security' to the door and to the security officer’s spawn point.
Now anyone who spawns at this spawn point has a tag ‘id_security’ on their ID Card, allowing them to open the door.
Tip: To place items in containers in sub editor, toggle on ‘Character mode’. Now you have a temporary inventory and can grab and move items like you would in-game.
There are a few ways to combat flooding inside a submarine.
Pumps are the primary way of getting rid of water, but they consume relatively high amounts of power. Having too many pumps turn on simultaneously causes unnecessary power fluctuations. Instead of placing pumps in every room, duct blocks can be used to let water flow into designated bilge compartments. There doesn’t need to be a separate bilge space, usually it is enough to place a pump on the bottom-most room and route the water there.
Compartmentalizing the space is a good way to make sure a small leak doesn’t turn into a catastrophe. The larger the rooms on a sub, the further water can advance without obstacles. Remember to close doors behind you, otherwise they’re useless. A good move would be to use doors that close automatically, which is why the game's vanilla subs come with auto-closing doors. Hate them or love them, they're for your own protection!