Perfect Circles & Quick Copy
Before installing, check that this mod release supports your dedicated server and game version. A ficsit.app listing alone does not establish compatibility.
Installation and verification
- Read the original description, check SML version and dependencies and back up your save.
- Stop the server and choose the mod in your dashboard’s Satisfactory mods section. Verify source and version.
- Install required client mods in compatible versions. Start the server and inspect logs, connection and mod-dependent content.
Removal and updates may affect saves. Keep a backup of the working combination. Memory needs cannot reliably be inferred from one mod’s name.
Published releases
- 2.0.0 · Game version >=382498 · SML check project
Published targets: Windows
- 1.0.23 · Game version >=264901 · SML check project
Published targets: Windows
- 1.0.22 · Game version >=264901 · SML check project
Published targets: Windows
- 1.0.21 · Game version >=264901 · SML check project
Published targets: Windows
- 1.0.20 · Game version >=240610 · SML check project
Published targets: Windows
Original mod author description
Screenshots coming soon™
INTRODUCTION
Perfect Circles is a tool for creating circular or curved arrangements quickly, and for copy/pasting existing structures. The mod consists of 3 main components, all of which have support for the majority of base-game and modded parts.
- Circle Builder ― a temporary placeable block which, when interacted with, allows you to create perfectly circular constructions.
- Primarily for creating complete circles, it also has the ability to slice the circle at a specified point to create fractional curves.
- Multiple concentric rows can be spawned, or the circle can be filled in completely.
- Granular control over positional offsets for the whole circle relative to the Circle Builder block for: rotation, radius, x/y/z position.
- The ability to spawn with wall-pieces of your choice automatically connected to your foundations.
- Additional functions: stack additional wall rows vertically / in-place rotation of parts, independent of the overall circle / ramp offset to stagger successive rows of walls (horizontally) and foundations (vertically)
- Quick Curves ― a hand-tool used for quickly creating curved structures while on-the-go, it functions by zooping pieces along the radius of a virtual-circle.
- Primarily for creating partial curves made from almost any buildable, it will zoop a curve as far as you choose, including ultimately creating a full circle.
- Can sample existing buildables, or select from a list of compatible parts.
- Can zoop curves horizontally, vertically, or straight.
- When working with beams, a custom beam-length can be specified.
- Additional functions: initial placement rotation on all axes / the number of discrete segments the virtual-circle is divided into (ie: how tightly it curves) / angle offset per division / overall radius offset / third-axis ramp angle / memory & favourites.
- Quick Copy ― always available through a keybinding, this function allows you to copy & paste multiple structures, replace them where they are, or delete them.
- Allows you to select components individually, or to generate a box around an area (using parts you select as its vertices) for mass-selection.
- Can be used to mass-delete any selected parts, with no item count limit.
- Selection filter, so only specific parts within an area will be acted upon.
- In-place part replacement: existing structures can be replaced with any other part, and optionally moved or rotated on any axis.
- Zoop splines, to create arbitrary curves or arcs, as well as full circles.
- Memory function to re-select any items currently within a previously saved box area.
This mod is vanilla-friendly! It does not alter the resource costs of any buildables. Furthermore, the structures it creates use only parts that are already present in your game. It adds no new buildings. Disabling or uninstalling this mod will not remove anything which you have built or modified using it.
UNLOCKING
- Circle Builder can be unlocked in the HUB at Tier 1 under the name Perfect Circles: Builder Tool
- It can then be found at the bottom of the Foundations category of the Build Menu with the name Perfect Circles Builder
- Quick Qurves can be unlocked in the HUB at Tier 1 under the name Perfect Circles: Quick Curves
- The Quick Curves tool additionally needs to be built in the Equipment Workshop. Once you have equipped it to a hand slot, Press [RMB] to activate
- Quick Copy does not require unlocking. It is always available through a hotkey, which can be customised through the game’s main Keybindings menu. Assignment name: Activate Tool ― Default: [Shift] + [Z]
REFERENCE GUIDE
Foreword: Some of the sub-functions of this mod are still in a beta state. This may lead to some minor visual bugs, as well as some keybindings which are not yet fully finalized. While the in-game Keybindings menu will list most functions used by this mod, some are currently hard-bound and will be described below where relevant.
This is also not intended to be an exhaustive manual of what is possible with this mod. However, we hope that this will help you gain sufficient understanding of its fundamentals to be able to experiment further on your own. Should you have any specific questions after reading this guide, you can find us in the Satisfactory Modding Discord where our fully FICSIT-trained doggos engineers will be happy to help if we can.
Click or tap the headers below to expand the guide for that section.
Key:
Menu Function Hotkey Function Default State/Key Fixed Keybinding Highlight Note
Menu Reference Function Reference Tool Name Reference Link
Circle Builder
TO ACTIVATE: Place the Perfect Circles Builder piece (referred to as the Circle Builder in this guide), found at the bottom of the Foundations menu in the base-game build-gun, at your desired starting location.
This is not a ‘real’ piece, and will not itself impact or interact with other buildables. It will serve as the centre-point of your construction (precise offsets can be set later). Interact with it, and it will display the Circle Builder UI menu. Main controls to the left, parts selection to the right, and relocation options at the top.
Building Basics
Use the menu on the right to select the parts you wish to use in the circle. Both the Foundation and Wall submenus list all parts which are compatible with the Circle Builder, and provide a search-box to narrow down results.
Only one type of wall and foundation each can be selected per construction. However, the Circle Builder piece will remember your settings and remain in place until you dismantle it. This allows you to build additional circles at the same location with different pieces & offsets.
The menu on the left provides the primary size, rotation, and positional controls for the circle. Most important for basic building are:
- Divisions This number sets how many ‘slices’ the circle is divided into. Each ‘slice’ will contain one foundation and/or wall piece per row. By default, the Circle Builder will try to minimise overlap between parts in different slices. This is why increasing the Divisions count will usually also increase the circle’s radius. As more parts are added to the circle, the Circle Builder has to make the circle bigger to fit them all in.
- Radius Offset This value sets a positive or negative offset to the overall radius of the circle, relative to the default for your Divisions setting above. The units are in centimetres (800 = 8 metres = 1 standard foundation block). This operates by moving each individual part closer to or further from the centre-point of the Circle Builder. The effect on the overall diameter of the circle is therefore double this value. This also means that it will override the distance between parts in each ‘slice’, and can result in either gaps between them, or significant overlap.
- Location/Rotation These are direct positional controls for the overall structure you are building. Each option will move or rotate the entire circle on that axis, relative to the Circle Builder centre-point. Location units are in centimetres, Rotation units are in degrees.
- Build Foundations [Default: ON]
- Rows This increases the number of foundation rows that are added inwards towards the Circle Builder centre-point
- Rotation This is an in-place, per-part rotation value, in degrees, relative to the circle’s horizontal plane. This means that each individual block will be rotated around its z-axis, within its current position.
- Ramp This staggers each subsequent row of foundations by the set amount vertically (z-axis), relative to the previous row (ie: cascading). Units in centimetres.
- Build Walls [Default: OFF] This controls whether or not walls are added to the outer-edge of your foundation pieces.
- Rows Unlike foundation rows, this adds additional rows upwards on the z-axis from the first wall row.
- Rotation As with rotation in Build Foundations.
- Ramp Unlike foundation ramps, this staggers each subsequent row of walls by the set amount horizontally (on a radial axis), relative to the previous row (ie: cascading). Units in centimetres.
Top Menu Bar
- Select Radius This allows you to double-click [LMB] on one or more built objects in-game. On pressing Accept, the game will calculate what the radius of the smallest hypothetical complete circle around your selected parts would be, and will expand or contract the radius of your circle to match.
- Location From This is a placeholder menu which is currently not in use. The only option will be Average
- Rotation From The circle’s new rotational offset will be based on the attribute you select here.
- Select Center This allows you to double-click [LMB] on one or more built objects in-game. On pressing Accept, the game will calculate what the centre-point of the smallest hypothetical complete circle around your selected parts would be, and will move your circle to centre itself upon that point.
- Location From/Rotation From The same as in Select Radius.
- Reset Radius/Reset Center Both above options will serve as the new zero-point for your circles. This means that any offsets for Location, Rotation and Radius, will be relative to the values calculated in those steps. Use these buttons to reset the radius/centre zero-points to the Circle Builder defaults.
Menu Options
In the main Perfect Circles menu on the left of the screen, there is a small “drawer” tab on its right edge. Click that to access Circle Builder interface options for:
- Angle/Offset Increments The number of degrees/centimetres that can be increased or decreased per click, as well as setting larger increments when the given modifier keys are held.
- Holograms Visual options for the appearance of Build Holograms. Build Effects and Simple Material can be toggled to minimise performance impacts when building large structures.
There are also controls for an additional advanced build function:
- Auto Reduction This option is designed to limit the number of redundant overlapping pieces that are built in certain circumstances. For example:
- Circles with heavily-negative radius offsets.
- On the innermost rows of fully filled-in circles, due to the fact that every row has the same number of pieces, but the available space decreases towards the centre of the circle.
Additionally, there are counters below which surface some diagnostic information: Holos shows the total number of individual pieces that your current settings will ultimately spawn in the game-world. Rows to fill circle is a hypothetical indicator of how many rows it would take to fill in the circle with your current settings.
Advanced Circles
- Slice Circle This option enables the building of partial circles, by showing only the pieces within the radial range specified (in degrees).
- Radius Source This alters the dimension used to calculate the effective space allocated to each part (and therefore its default radial position).
- Foundaton Width The Y-axis (green) of your selected foundation.
- Foundation Depth The X-axis (red) of your selected foundation.
- Wall Width The Y-axis (green) of your selected wall (if enabled)
Most useful for non-square foundations which have been rotated in-place, to eliminate gaps between them by selecting Foundation Depth. Note, however, that because of the decreased radius, the parts will now also be much closer to the centre of the circle. To return the parts to their pre-rotated radial positions, you should increase the overall Divisions value. This will be in inverse proportion to the difference between the part’s depth & width, eg: an 8x4 Half Foundation would need its Divisions value doubled, as its depth [4m] is half its width [8m].
Quick Curves
A more powerful and advanced implementation of the Circle Builder logic, this hand-tool can be used almost anywhere. While it can create complete circles, its primary function is to make open curves. As such, it has no ability to automatically fill-in circles or attach wall-pieces. However, it allows for much more precise control over the curve, and can be used in locations which would be hard to reach with the Circle Builder.
In addition, it has the ability to set custom lengths for all Beam type parts, in 1cm increments. This incredibly powerful function can allow you to create near-flawless curves with extremely tight angles.
TO ACTIVATE: equip the Quick Curves tool in any hand slot, and press [RMB].
Menu & UI Basics
Pick Part is the primary “Build Menu” for Quick Curves. After pressing this hotkey, visual & interface-behaviour settings will appear in a menu on the left, similar to the Circle Builder. One additional function of note:
- Auto Ramp is a setting which will attempt to correctly set the zoop angle for ramped parts, such that it zoops down their face rather than along their base.
On the right is the main part selection interface. Listed will be most available parts; parts associated with beta functionality (see Beam Length/Fixture Angle) are currently only available through Sampling (see next guide entry). The parts list can additionally be filtered using the search bar at the top, or the category toggles to the left. At the very bottom is a scrollbar which can be used to set the zoom level of icons in the list.
The other basic Quick Curves hotkeys are as follows:
- Sample Part Pick an existing part from the game-world, and start a new curve using that part.
- Change Part This lets you scroll through the list of supported parts.
- Build New This starts a new curve using the currently selected part.
- Build Last This will start a new curve using the settings from the previously constructed curve.
- Undo Last This will dismantle every part from the previously constructed curve.
Curve Fundamentals
Choose a part using one of the options above. From here, you can Rotate the piece using the scroll-wheel to select its starting angle, and the Rotation Mode key can be used to toggle the axis the curve is being rotated around. You can then lock the holo with the Lock Holo key. Once locked, you can start creating curves with the following controls.
- Zoop This increases or decreases the length of the curve by adding or removing one part per scroll.
- Divisions One/Ten Like in the Circle Builder, the Divisions count is the main control over how tightly the circle will curve. It divides the virtual circle that QuickCurves is based on into this many individual “slices”.
However, compared to the Circle Builder, it has a slightly different apparent effect on the curve’s positioning. This is due to the the curve being based upon the fixed starting-piece (rather than the circle’s centre-point), and the open-ended nature of zooping. Pieces further along the curve will always appear to move more than those closer to the start. - Radius This will increase or decrease the overall radius of the curve by moving each individual part in or out along the radial axis. Like the Circle Builder, this option can result in overlap or gaps.
- Left/Right & Forward/Backward These options simply toggle which direction the curve will zoop towards from its starting point.
Intermediate Functions
Some functions may only be available in certain contexts, usually before or after locking the build-holograms. These will be described below where relevant as Pre-Lock, Post-Lock, or Both.
- Snap Mode [Pre-Lock] will alter the behaviour of how the first piece of the curve will snap to existing parts in the game-world. It has 3 modes which can be toggled between, all of which use the center-point of the starting-piece to align to the faces of existing structures.
Center (the default) will snap faces center-to-center. Incremental will allow you to move most parts on a 0.5 x 0.5m 3D grid, or whatever value you have set in the Pick Part options menu (beams excluded temporarily). Freetrace essentially disables snapping altogether, and allows you to place holos freely on any surface. - Rotation Mode [Pre-Lock] This changes the axis around which the curve will rotate when using the scroll-wheel.
- Zoop Mode [Both] This changes the primary zoop axis of the curve, between Horizontal, Vertical, and Straight. While Straight may seem like ordinary zooping, the many other functions of Quick Curves, such as the Rotate Parts option (see next entry) and the offsets, give you a much greater degree of control over how the zoop spreads (especially for beams).
- Rotate Part [Post-Lock] This will rotate each individual part in-place (not the overall curve) on its current horizontal plane. Each press will rotate the part 90°.
- Reset Offsets [Both] This will reset all offset values to zero (Ramp, Radius, & Angle).
- Reset Rotations [Pre-Lock] This will reset any rotation applied to the overall curve during the pre-lock stage to zero degrees.
Advanced Functions
- Angle [Post-Lock] Similar to radius offsets, this option instead adds an offset to each division angle along the curve’s path. This is an incredibly powerful option, which can let you control the overlap of each part (and therefore how smoothly the curve will appear when built) without affecting the curve’s radius.
- Step Height/Ramp [Post-Lock] Adds an inclination to each subsequent part in the zoop, perpendicular to the currently set Zoop Mode axis.
- Inside/Outside [Post-Lock] Unlike Circle Builder, Quick Curves does not use the centre of the part in radius calculations such as Divisions (since it is not a strictly-enclosed circle, this would make little sense). This toggle will switch between the inner and outer circumferences of the curve being used in those calculations.
- Beam Length [Both] [BETA] This will alter the length of each individual beam part in the curve, at 1cm resolution.
- Fixture Angle [Both] [BETA] Currently limited to base-game Wall Mounted Flood Lights, this option will allow you to set the angle of the light fixture head (and therefore the light cone angle).
Quick Copy
TO ACTIVATE: Press the key set through the in-game Keybindings menu for Activate Tool, default: [Shift] + [Z]
Key assignments for the main functions will be now displayed along the bottom of the screen.
Simple Copy & Pasting
Select individual items with the Select Parts key (which can be held down to multi-select).
To paste them, press the Copy Selection key, at which point a holo approximating your selected pieces will be spawned.
Holos can be rotated with the mouse scroll-wheel, and the Rotation Mode key can be used to toggle the axis you are rotating the assembly on. You can lock this holo as usual with the game’s own Lock/Unlock Hologram binding, at which point, it may additionally be nudged on all 3 axes using the various nudge keys displayed on-screen. Use the [CTRL] key to make “tiny” adjustments.
Basic Functions
There are 3 additional keys which can be used in most contexts:
- Clear Selection will simply deselect all pieces, without affecting boxes or existing structures.
- Toggle Filter will select the part you currently have in your crosshairs, and will limit all subsequent selection & modifications operations to only that type of structure, as with the base-game Build Gun and Dismantler.
- Dismantle Selection will destroy the currently selected pieces, without any numerical limit. This means that, unlike the base-game Dismantler’s 50 item limit, you can erase entire factories at once.
Mass Selection
It is possible to generate a box around an area, which will allow you to mass-perform several functions on the parts contained within. The primary way of doing this is to select multiple existing pieces in the game-world, and then press the Generate Box key. This will use the selected parts as the vertices, or ‘anchors’, around which the box should be created. To remove the box itself (without affecting the selected items, or the contents of the box), press the Clear Box key. To mass-select all items inside the box, press Select Box Contents.
Once created, boxes can be manipulated in several ways. Press the Edit Box key to access those functions.
- Their dimensions can be altered by aiming the crosshairs to the face of the box you wish you alter. Upon doing so, that face will turn orange. You can expand or contract the position of that face relative to the rest of the box by holding either the Move Side Fine or Move Side Course modifiers while scrolling the mouse-wheel, with the Course version moving the face 4m per scroll, and the Fine option moving by 1m per scroll. While you have these modifiers held, the face will turn green.
- You can rotate the box around its current vertical axis, using the Rotate Box keys
- Finally, the box’s position can be dragged with the mouse by holding the Move Box Axial & Move Box Free modifiers, with the Axial version locking the box to the current horizontal plane (fixed Z-axis).
Advanced Functions
- The Pivot, which is the piece that is used to align the holo during placement, can be altered with the Move Pivot key after having highlighted multiple pieces ― pressing the key will move the Pivot to the piece currently under your crosshairs. Otherwise, the Pivot defaults to the first piece you selected.
- Snap Mode will alter the behaviour of how holos will snap to existing pieces in the game-world. After having highlighted parts and pressed the Copy Selection key to bring up the holo, the snap mode button will become available. It has 3 modes which can be toggled between, all of which use the center-point of the piece designated as The Pivot to align to the faces of existing structures.
Center (the default) will snap faces center-to-center. Incremental will allow you to move most parts on a 0.5 x 0.5m 3D grid (with some exceptions using a 1 x 1m grid). Freetrace essentially disables snapping altogether, and allows you to place holos freely on any surface. - Part Replacer will allow you to perform an in-place swap of existing built parts for almost any other part. This can be performed on multiple parts at once, but only when all highlighted parts are the same (the Toggle Filter function described above can be helpful for this). When pressing the Part Replacer key, a menu screen will appear which lists all possible replacement options. By default, new parts will be placed in the same position and rotation as the pieces they are replacing. However, the replacement selection screen has menu options for applying in-place X/Y/Z-axis positional & rotational offsets, relative to each replaced part’s original position.
The parts selection screen defaults to showing only parts from similar categories to the ones being replaced, but has additional toggle options above the list to only show items of the Same Size (Default: Enabled), as well as a true Show All override (Default: Disabled). - Zoop Splines [BETA] When only a single piece is selected, pressing the Copy Selection key will enable the 3 spline type keys. All splines use mouse-aim to define their primary positional characteristics. For features marked with † , please see the Known Issues section below.
- Circle Spline will create more a traditional circle, like a simplified version of the Circle Builder tool.
- Arc Spline will build a single curve with an arbitrary width & height, based on a virtual center point.
- Freeform Spline is an incredibly powerful spline mode that can create arbitrary curves, with the option of adding multiple fixed waypoints along its route (Add/Remove Point)†. Each point can be created as either a Linear zoop, or a Curved zoop by using the Point Type toggle. In Curved mode, the curve can be contoured over multiple axes at once. The final piece to be placed can also be rotated on the horizontal plane with the scroll-wheel, which the spline’s route will attempt to follow. Given the freeform nature of this mode, there is also a Keep Flat toggle†, which will lock the spline to the horizontal plane (fixed Z-axis).
- The [Scroll Wheel] will control the number of parts included in the spline.
- The [Cursor Keys] will control dimensional characteristics of the spline. For Circle Splines, the up/down keys control the radius. For Arc Splines, the cursor keys control the width and the height of the curve’s bounding box†. For Freeform Splines in Curved mode, the up/down keys will control how tightly it curves/how steep the intersectional parts are (similar to symmetrical control points on cubic bezier curves).
All modes have an Edit Spline function†, which functions similarly to the traditional Lock Hologram key, and enables access to certain fine tuning options†:
Zoop Spline Known Issues
- The Edit Spline key does not appear on the UI for Arc or Circle curves. However, it does still function.
- The Remove Point & Keep Flat functions for Freeform Splines are not yet operational.
- The keybindings for functions in Edit Spline mode do not show up on the UI.
- The cursor keys for Arc Spline width/height alterations in Edit Spline mode are not yet operational.