DrawableSuits

DrawableSuits is a Lethal Company v81 BepInEx mod that lets players draw on suits in-game, place image decals, save and load designs, and apply edited textures to vanilla or modded suits.

Features

• Default third-person paint editor: opening DrawableSuits switches to an editor camera around the local player so you can paint directly on the visible suit.
• Compact side overlay with Paint, Erase, Fill, Decal, Text, Eyedropper, a UI-only Mirror toggle, brush/fill sliders, a hue/SV color picker, decal/text controls, design name, visible decal rows, visible saved-design rows, share-code import/export, Undo, Redo, Reset, Apply, Save, Load, and Close.
• Fill Bucket flood-fills contiguous matching texture regions under the cursor using the current brush color, opacity, and Fill Tolerance slider.
• Mirror painting duplicates Paint, Erase, Fill, Decal, and Text edits onto the opposite suit surface using the editor's baked avatar mesh, without adding keyboard or controller shortcuts.
• Decal placement preview: Decal mode shows a translucent live preview before stamping, then places one projected decal per click or right-trigger press in third-person mode.
• Text stamping: Text mode previews typed single-line text on the suit as a transparent alpha-mask stamp, then bakes it into the texture once per click or right-trigger press. In third-person mode, text is projected onto the visible suit surface instead of stamped as a flat UV rectangle.
• Pause-menu entry point: use the DrawableSuits button below Resume.
• Fallback shortcuts: F8 on keyboard or View/Back + Y on controller.
• Emergency open shortcut: F10, which opens the editor and does not toggle it closed.
• Controller support: left stick moves the editor cursor, A clicks exactly the UI control under the cursor, right trigger paints only, right stick/bumpers orbit the camera, D-pad up/down zooms, Y cycles tools, X undoes, and Start saves.
• Direct surface painting: the editor bakes a hidden mesh collider from the local player model and paints by raycasting from the third-person camera to suit UV coordinates.
• UV fallback mode: press Use UV Fallback if third-person setup fails; it shows the full editable suit texture.
• PNG/JPG decals from BepInEx/config/DrawableSuits/Decals. The in-game OS file dialog is disabled for stability in Gale/Unity.
• Reusable saved designs stored as JSON metadata plus PNG texture files.
• Compact lossless DSUIT2: design codes for copy/paste import and export between profiles or players, with legacy DSUIT1: import compatibility.
• Apply/save multiplayer sync for other players who also have DrawableSuits installed, keyed per player so two players wearing the same suit can have different edits.
• Vanilla and modded suit support as long as the suit exposes a normal suit material and texture.

Install

1. Install BepInExPack for Lethal Company.
2. Build this project with dotnet build -c Release.
3. Copy dist/DrawableSuits/BepInEx/plugins/DrawableSuits/DrawableSuits.dll into your mod profile, or package the dist/DrawableSuits folder for Thunderstore.

Controls

Keyboard and mouse:

• Pause menu DrawableSuits: primary open path.
• F8: toggle editor.
• F10: emergency open.
• Left mouse: paint/erase continuously; in Fill mode, fill once per press; in Decal or Text mode, stamp one preview at the cursor location.
• Fill: click the Fill UI button, adjust Fill Tolerance if needed, then left-click a contiguous color region on the suit.
• Text: click the Text UI button, type up to 64 characters, then left-click the suit to stamp it. Text uses the current brush color and opacity.
• Eyedropper: click the Eyedropper UI button, then left-click the suit to sample that texture color. It returns to the previous tool after one successful sample.
• Mirror: click the Mirror UI button to duplicate paint, erase, fill, decal stamps, and text stamps onto the opposite suit surface.
• Export Code / Import Code: use the design code panel to copy the current editable texture as a compact DSUIT2: code or paste a shared DSUIT2: or legacy DSUIT1: code into the current suit.
• Right mouse: orbit the third-person editor camera.
• Mouse wheel: zoom the third-person camera.
• Ctrl + mouse wheel: change brush size.
• Escape or Close: close the editor.

Controller:

• View/Back + Y: open or close.
• Left stick: move the editor cursor.
• A: click the button, field, slider, or color picker region directly under the cursor.
• Text: move the virtual cursor over the Text UI button and press A, type text with the UI field, then aim at the suit and press right trigger once to stamp it.
• Fill: move the virtual cursor over the Fill UI button and press A, adjust Fill Tolerance if needed, then aim at a matching color region and press right trigger once.
• Eyedropper: move the virtual cursor over the Eyedropper UI button, press A, then aim at the suit and press right trigger once to sample a color. It returns to the previous tool after one successful sample.
• Mirror: move the virtual cursor over the Mirror UI button and press A; there is no controller shortcut for this modifier.
• Export Code / Import Code: use A on the design code UI buttons. There are no shortcuts for import/export.
• Right trigger: paint/erase continuously; in Fill mode, fill once per press; in Decal or Text mode, stamp one preview at the cursor location.
• Right stick or bumpers: orbit the third-person editor camera.
• D-pad up/down: zoom the third-person editor camera.
• Y: cycle Paint/Erase/Decal. Fill, Text, Eyedropper, and Mirror are UI-only and are not part of this shortcut.
• X: undo.
• Start: save.

Folders

DrawableSuits creates these folders after launch:

• BepInEx/config/DrawableSuits/Saves stores .json design metadata.
• BepInEx/config/DrawableSuits/Textures stores saved design .png textures.
• BepInEx/config/DrawableSuits/Decals stores user decal images.
• BepInEx/config/DrawableSuits/Logs stores the diagnostics log.

Put .png, .jpg, or .jpeg files in Decals and press Refresh Decals in the editor to use them.

Multiplayer

Edited suits update locally while painting. Other mod users receive your player-specific texture only when you press Apply or Save. Texture payloads are chunked through Unity Netcode custom messages with the owner client ID and validated with a hash before being applied.

Players without DrawableSuits can still join normally, but they will see the original suit textures.

DrawableSuits no longer replaces every rack/player using the same base suit when one player edits their suit. Saved designs are reusable, but active in-session edits are applied to the selected player only.

Share codes embed a PNG copy of the current editable texture plus metadata. Importing a code loads it into the currently selected suit editor texture only. It creates one undo entry, does not auto-save, and does not sync to multiplayer until you press Apply or Save.

New exports use the shorter lossless DSUIT2: format. Older DSUIT1: codes still import normally, but newly copied codes default to DSUIT2:.

Modded Suits

DrawableSuits works with modded suits by detecting unlockables that expose a suitMaterial. Saved designs are reusable on any suit, but loading a design onto a suit with a different UV layout can stretch or misplace drawings and decals.

Configuration

The BepInEx config file controls:

• Open editor key.
• Emergency diagnostics overlay key.
• Debug HUD toggle key.
• Startup diagnostics HUD enable/disable and display duration.
• Controller cursor speed.
• Max editable texture size.
• Undo history size.
• Multiplayer sync enable/disable.
• Max sync payload size and chunk size.
• StartInUvFallbackMode, disabled by default, opens directly into the old UV fallback view.
• ThirdPersonCameraDistance, the default third-person editor camera distance.
• ApplyLocalFirstPersonArms, disabled by default, is experimental and allows edited materials on local first-person arms/body outside the editor.
• AutoDisableBrokenJetpackWarningLateUpdatePatch, enabled by default, disables only the broken JetpackWarning PlayerControllerB.LateUpdate postfix after repeated null-reference errors are detected.
• EnableExperimentalModelPreview, disabled by default, keeps the old RenderTexture model preview as diagnostics only.
• OS file dialog import remains disabled/experimental and is ignored in-game for stability.

Debugging

DrawableSuits writes detailed startup, pause-menu, input, editor, camera, collider, raycast, suit-detection, list-row, and paint logs to BepInEx/config/DrawableSuits/Logs/diagnostics.log.

When testing with Gale, also search BepInEx/LogOutput.log in the active Gale profile for DrawableSuits.

Expected 0.5.23 behavior:

• Opening the editor shows a compact side overlay and a third-person camera view of the local player.
• The diagnostics text should show Preview mode: WorldThirdPerson when the default path succeeds.
• The visible editor model is DrawableSuitsWorldAvatarProxy, a baked suit/body proxy on an isolated layer, not the live first-person local rig. First-person helmet/viewmodel renderers are hidden during editing and restored on close.
• Normal session startup should log SessionSafetyCheck with EditorOpen=False, no active DrawableSuits cameras, Camera.main state, local player state, prompt context, and jetpackWarningGuard status.
• If third-person setup fails, the editor falls back to TextureFallback and logs the reason.
• Decal and saved-design rows are explicit anchored buttons, not ScrollRect/layout rows.
• Controller right trigger paints only. Camera zoom uses mouse wheel or controller D-pad up/down.
• Active edited textures are per player/client, not global per suit type.
• The color changer is a compact side-by-side hue ring and saturation/value square with a swatch and editable #RRGGBB hex field.
• Color picker handles are tied to the same coordinate conversion used for mouse/controller input, so the visible handle positions should match the selected hue, saturation, value, and typed hex color.
• Reset, Save, and Load no longer rebuild list hitboxes during the click; decal and saved-design rows only change selection when their rows are clicked directly.
• Third-person camera yaw, pitch, and distance are preserved when loading a design or switching suits while the editor is open.
• Controller A does not activate UI immediately after opening; move the left stick once to arm the virtual cursor, then A clicks the control under the cursor.
• Normal buttons should not stay highlighted after unrelated clicks; only selected tools, decals, and saved designs keep orange selection styling.
• The decal section has one Refresh Decals button. It refreshes decal and save rows and shows only a short status line.
• In Decal mode with a selected decal, hovering over the suit shows a translucent preview and status Previewing decal. Click/RT to stamp.
• Decal placement is single-shot: holding left mouse or RT places one decal until the input is released and pressed again.
• Third-person Decal preview and stamping project onto the visible suit surface and fill between valid projected samples, so decals avoid both UV-island wrapping and small suit-background cracks on curved geometry. UV fallback keeps direct flat UV decal stamping.
• The editor cursor is dynamic and rendered as a top-level non-raycastable graphic inside the visible editor canvas: Paint and Erase show a hollow brush ring sized to the current editable target, while UI hover, invalid targets, Decal, Text, Eyedropper, and normal navigation show a small white dot.
• The old filled UV brush indicator and world-space sphere marker are kept hidden, so there should not be a colored square or blob following the cursor.
• In Text mode, the text input uses Unity's built-in Arial font, accepts one line up to 64 characters, and shows Previewing text. Click/RT to stamp. when the cursor is over a valid suit target.
• Text stamps are generated as transparent alpha-mask textures and tinted with the current brush color/opacity, so they should not stamp a black rectangle behind the letters.
• In third-person mode, Text stamps project onto the visible suit surface and skip glyph pixels that fall off the suit instead of wrapping them through unrelated UV islands.
• Third-person Text should read left-to-right from the editor camera. Mirrored Text should only appear when the UI-only Mirror button is enabled.
• UV fallback keeps direct flat UV Text stamping for texture-layout editing.
• Text is baked into the suit texture after stamping. It is not an editable layer after placement.
• The Fill button is a UI-only tool. It flood-fills the contiguous same-color region under the cursor using the current brush color and opacity.
• Fill is single-shot: holding left mouse or controller RT fills once until the input is released and pressed again.
• The Fill Tolerance slider appears when Fill is active. Lower tolerance fills tighter matching regions; higher tolerance accepts more color variation.
• Export Code copies a compact lossless DSUIT2: code to the clipboard and fills the design code field. Import Code validates a pasted DSUIT2: or legacy DSUIT1: code and loads it into the current suit without auto-saving, broadcasting, or resetting the third-person camera.
• UV fallback mode shows a non-interactive rotated decal preview over the texture panel.
• The Mirror button is a UI-only modifier. When it is orange, paint, erase, fill, decal stamps, and text stamps use a surface-map mirror target on the opposite side of the baked suit mesh in one undo action.
• Mirrored decal previews show both the primary and mirrored decal. The mirrored decal is horizontally flipped and uses inverse rotation.
• UV fallback also uses the mesh mirror map when the clicked UV maps back to a suit triangle. If no mirror target is available, DrawableSuits applies the primary edit only and shows a short status.
• The Eyedropper button is a UI-only one-shot tool. It samples the editable suit texture at the cursor hit point, updates the swatch, color picker, hex field, and brush color, then returns to the previous Paint, Erase, or Decal tool.
• Eyedropper does not create undo entries and Mirror does not affect sampling.
• The part picker is removed. Third-person mode always shows the full avatar proxy, and UV fallback always shows the full editable suit texture.
• Paint and Erase in third-person mode project onto the visible suit surface and fill between valid projected samples, so brush strokes avoid UV-island cutoffs while still guarding against unrelated UV island bleeding. UV fallback keeps direct flat UV brush painting.
• Paint, erase, decal preview, and decal stamping operate on the full editable texture.
• Active editor diagnostics report full proxy mesh/collider state through WorldAvatarProxy updated; PartClassifierBuilt should not appear during normal editor use.

Troubleshooting:

• If no decal preview appears, confirm a decal row is selected and Decal tool is active, then check DecalPreviewUpdated or DecalPreviewHidden diagnostics.
• If decals stamp repeatedly while holding input, confirm the installed package is 0.4.8 or newer and check for DecalStampCommitted entries; there should be one per press/release cycle.
• If Mirror does not appear to find the opposite side, check MirrorSurfaceMap built and MirrorSurfaceTarget diagnostics. Asymmetric or unusual modded meshes may not have a reliable opposite surface for every hit.
• If entering a session starts on a black screen before opening DrawableSuits, check SessionSafetyCheck lines. They list Camera.main, active cameras, camera target textures, local player flags, prompt context such as grab/hover fields, local renderer materials, and any repaired DrawableSuits objects. DrawableSuits should report no active DrawableSuits cameras while EditorOpen=False.
• If the black screen shows Grab: [E] and SessionSafetyCheck reports Camera.main=null, inspect LogOutput.log for repeated JetpackWarning PlayerControllerB.LateUpdate NullReferenceException. By default, DrawableSuits disables only JetpackWarning.Patches.PlayerControllerB_LateUpdate_Postfix after repeated failures and logs the unpatch result in diagnostics.log. Set AutoDisableBrokenJetpackWarningLateUpdatePatch=false to turn this compatibility guard off.
• If third person shows first-person arms, a giant helmet, held items, or another partial rig, check World renderer candidate, Hidden nearby first-person overlay renderer, World editor visible renderer candidate, and WorldAvatarProxy updated lines. The selected renderer should be a body/suit renderer and the proxy should use only the player-specific DrawableSuits material for suit-compatible submeshes.
• If action buttons such as Reset, Save, or Load also select decal/save rows, confirm the installed package is 0.4.7 or newer. Lists now use stable row pools and log ListRowsUpdated instead of rebuilding/destroying row buttons during normal UI refresh.
• If controller A clicks the wrong UI item, confirm the installed package is 0.4.7 or newer, move the left stick before the first A press, then check Virtual cursor A press and Virtual cursor A release diagnostics. They should show the same resolved button or control that is visually under the cursor.
• If button highlights stick around, confirm the installed package is 0.4.7 or newer. Normal button selected colors are neutral.
• If the color picker handles do not line up with the selected color, check ColorPickerInput diagnostics for hue, saturation, value, local pointer coordinates, and final handle positions.
• If loading a design or switching suits resets the third-person camera, confirm the installed package is 0.4.7 or newer and check for World camera state preserved diagnostics.
• If the color picker does not update paint color, check the swatch, editable hex field, and DrawableColorPickerBuilt diagnostics. Hex input accepts #RRGGBB or RRGGBB.
• If right trigger zooms the third-person camera, confirm the installed package is 0.4.4 or newer. In 0.4.4, right trigger is paint-only and D-pad up/down controls controller zoom.
• If UV fallback shows a second colored cursor, confirm the installed package is 0.4.4 or newer. The old filled brush indicator is disabled because it looked like another cursor.
• If editing one player changes every other player wearing the same skin, confirm the installed package is 0.4.4 or newer. Active edits now sync with owner client IDs and do not mutate suit rack/global suit materials.
• If you cannot see the local suit in third person, check diagnostics.log for WorldThirdPerson setup, WorldAvatarProxy updated, and WorldEditorCamera updated.
• If painting misses the suit, check PaintAttempt entries for world paint input, UV coordinates, and whether the cursor is over the editor panel.
• If Eyedropper does not sample a color, check EyedropperMiss entries for whether the cursor was over the visible suit or UV preview. A successful sample logs EyedropperSampled with UV, pixel, sampled hex color, and return tool.
• If Text does not preview or stamp, check that the text field is not empty, then search diagnostics.log for TextStampRendered, TextPreviewUpdated, TextPreviewHidden, TextStampCommitted, or TextStampSkipped.
• If Text stamps with a black rectangle, confirm the installed package is 0.5.10 or newer. TextStampRendered should report alphaMode=luminance, glyph bounds, and a trimmed final texture size.
• If third-person Text drops side letters, confirm the installed package is 0.5.11 or newer and check TextSurfacePreviewUpdated, TextSurfaceStampCommitted, or TextSurfaceStampSkipped for written and skipped glyph-pixel counts.
• If third-person Text appears backwards, confirm the installed package is 0.5.12 or newer and check TextProjectionFrameBuilt for camera-right alignment and sample order diagnostics.
• If decals rotate unexpectedly or get clipped on third-person suit seams, confirm the installed package is 0.5.14 or newer and check DecalSurfacePreviewUpdated, DecalSurfaceStampCommitted, or DecalSurfaceStampSkipped diagnostics for projected written/skipped pixels.
• If third-person decals show small suit-background cracks through the decal, confirm the installed package is 0.5.15 or newer and check the same decal surface diagnostics for sample, hit, rasterized-cell, seam-skip, off-suit, and written-pixel counts. High seam-skip counts mean DrawableSuits is intentionally avoiding UV island bleeding.
• If Paint or Erase strokes cut off on third-person suit seams, confirm the installed package is 0.5.22 or newer and check BrushSurfaceStrokeApplied, BrushSurfaceStrokeSkipped, and BrushSurfaceProjectionWarning diagnostics for sample, hit, rasterized-cell, seam-skip, off-suit, and written-pixel counts. High seam-skip counts mean DrawableSuits is intentionally avoiding UV island bleeding.
• If Fill affects too much or too little of the suit, adjust Fill Tolerance and check FillBucketApplied diagnostics for seed color, tolerance, checked pixel count, matched pixels, written pixels, and mirror target. Fill is texture-contiguous, so separated UV islands may require separate fills.
• If the cursor is missing, confirm the installed package is 0.5.21 or newer and check CanvasCursorBuilt, CanvasCursorUpdated, or CanvasCursorHidden diagnostics. The editor now draws the cursor directly inside the same UGUI canvas as the visible editor controls.
• If the cursor is still a filled square or colored world blob, confirm the installed package is 0.5.21 or newer and check CanvasCursorUpdated diagnostics. Paint and Erase should use mode=BrushRing; Decal, Text, Eyedropper, UI hover, and invalid targets should use mode=Dot.
• If the Paint or Erase ring size looks wrong, check CanvasCursorUpdated for target=WorldThirdPerson or target=TextureFallback, the computed diameter, hit triangle, UV, canvas-local position, and any fallback reason.
• If the controller cursor does not line up with the visible cursor, check CanvasCursorUpdated and the virtual cursor diagnostics. The visible cursor follows DrawableSuits' virtual cursor directly instead of warping the OS mouse cursor.
• If importing a design code resets the third-person camera, confirm the installed package is 0.5.14 or newer and check DesignCodeImported plus World camera state preserved diagnostics.
• If a design code does not import, confirm it starts with DSUIT2: or DSUIT1: and check DesignCodeImportFailed diagnostics for prefix, Base64Url, decompression, binary/JSON payload, PNG, or texture-size validation errors. DrawableSuits never logs the full code.
• If decals or saved designs do not appear, check RefreshFileLists complete and ListRowsUpdated entries.
• If scan, inventory scroll, or item use still happen while the editor is open, check for Global gameplay actions locked and Blocked PlayerControllerB entries.
• If keyboard or controller shortcuts do not open the editor, use the pause-menu DrawableSuits button.
• If the mouse cannot move after opening from pause, check cursor unlock and pointerSource=Mouse diagnostics.
• Pressing Refresh Decals is safe in-game and shows only a short status line. To import decals, place image files in BepInEx/config/DrawableSuits/Decals, then press Refresh Decals.
• If you quit to the main menu while the editor is open, DrawableSuits closes the editor during the scene change so main-menu navigation is restored.
• Lethal Company v81 uses Unity's Input System path; repeated UnityEngine.Input exceptions should not appear from DrawableSuits.

Known Limits

• Third-person Paint, Erase, Decal, and Text project onto the visible suit surface before resolving to texture UVs. Unusual modded suit UV layouts may still make edits appear somewhere unexpected, and seam guards may skip ambiguous pixels instead of bleeding across unrelated islands.
• Mirror mode uses a mesh surface map, so unusual or asymmetric meshes may skip the mirrored edit when no reliable opposite surface can be found.
• Text stamps use Unity's built-in Arial font only in this version and are baked as tinted transparent alpha masks. Third-person Text projection can still skip letters that physically land off the visible suit surface.
• Cross-suit loading depends on UV compatibility.
• Share codes can still be long because they embed PNG image data. DSUIT2: removes the older inner Base64 PNG-in-JSON overhead, but it is still lossless and does not downscale or reduce quality.
• Very large decal images are resized to the configured maximum texture size.
• Multiplayer sync is designed for applied designs, not every brush stroke.
• The old UV fallback view remains available for debugging and edge cases.