BiggerSprayMod

Bigger Spray Mod for R.E.P.O.

A customizable spray mod for R.E.P.O. that allows players to place custom images throughout the game world.

This project includes third-party software:

• mgGif by Gwaredd Mountain (MIT License). See gif/mgGif_LICENSE.

Features

• Custom Spray Images: Use your own PNG/JPG images as sprays (GIF support coming soon)
• Adjustable Size: Scale your sprays from tiny to massive
• Multiple Spray Support: Cycle through multiple spray images in-game
• Network Synchronization: All players see each other's sprays
• Scale Preview: See exactly how big your spray will be before placing it
• Host Customization: Server hosts can control spray lifetime and maximum count
• Privacy Mode: You can enable My Eyes Only in order to prevent your game from sending sprays send by you

Installation

• Ensure you have BepInEx installed
• Make sure you have REPOLib installed
• Download the latest release page
• Extract the contents to your R.E.P.O. game directory
• The mod will be installed to BepInEx/plugins/BiggerSprayMod

Adding Your Own Sprays

• Navigate to BepInEx/config/BiggerSprayImages/
• Place your PNG or JPG images in this folder
• In-game, open the mod config and click "Refresh Sprays"
• Your images should now be available to select

Note: For best performance, keep your spray images under 5MB and use PNG format for transparency support.

Controls

| Key | Action |

|-------------|---------------------------------------|

| F | Place spray |

| G | Toggle between static and gif sprays |

| Left Arrow | Previous spray image |

| Right Arrow | Next spray image |

| Left Alt | Hold to preview spray size/position |

| + | Increase spray size |

| - | Decrease spray size |

| Mouse Wheel | Adjust spray size (when previewing) |

All keybindings can be changed in the mod config file.

Usage

• Press the spray key (default: F) to place a spray
• Use the previous/next keys (default: Left/Right arrows) to cycle through your sprays
• Hold the scale preview key (default: Left Alt) to see the size of your spray before placing it (optionally scroll or use +/- keys to adjust size)
• Press the toggle key (default: G) to toggle between static and gif sprays
• Use chat commands to manage sprays:
• /addspray SPRAYNAME: Add a new spray image from clipboard
• /addgifspray GIFSPRAYNAME: Add a new gif spray from clipboard
• /clearsprays: Clears all sprays from your local client (Does not affect other players)

Configuration

The mod creates a config file at BepInEx/config/MishaOpstal.BigSprayMod.cfg with the following settings:

Spray Settings

• Spray Key: Key used to place a spray (Default: F)
• Previous/Next Spray Key: Keys to cycle through your sprays (Default: Q/E)
• Show spray if it exceeds the size limit locally: Whether to show large sprays on your end (Default: true)
• Selected Spray Image: Currently selected spray image
• My Eyes Only: Toggles between privacy mode and public mode, privacy mode will disable all spray sending locally

Scale Settings

• Scale Preview Key: Key to hold for previewing spray size (Default: Left Alt)
• Increase/Decrease Scale Key: Keys to adjust spray size (Default: +/-)
• Use Scroll Wheel: Enable scroll wheel for size adjustment (Default: true)
• Spray Scale: Default spray size multiplier (Default: 1.0)
• Minimum/Maximum Scale: Limits for spray sizing (Default: 0.1-5.0)
• Scale Speed: How quickly the scale changes (Default: 0.1)
• Scale Preview Color: Color of the preview overlay (Default: Semi-transparent green)

Host Settings

• Spray Lifetime: How long sprays last in seconds (Default: 60s, 0 = permanent)
• Max Sprays: Maximum number of sprays before oldest ones are removed (Default: 10)

Networking

• When joining a server, the mod automatically synchronizes with the host's settings
• Sprays are compressed before sending to reduce network traffic
• Extremely large images (>5MB) may not be sent over the fallback network (If tmpfiles cannot be reached etc.)

Compatibility

• Requires