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.

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

Installation

1. Ensure you have BepInEx installed
2. Make sure you have REPOLib installed
3. Download the latest release from the Thunderstore page
4. Extract the contents to your R.E.P.O. game directory
5. The mod will be installed to BepInEx/plugins/BiggerSprayMod

Adding Your Own Sprays

1. Navigate to BepInEx/config/BiggerSprayImages/
2. Place your PNG or JPG images in this folder
3. In-game, open the mod config and click "Refresh Sprays"
4. 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

All keybindings can be changed in the mod config file.

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

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 network

Compatibility

• Requires R.E.P.O. version 1.x or higher
• Requires BepInEx 5.x or higher
• Requires REPOLib

Known Issues

• Very large spray images may cause performance issues
• If you experience lag when placing sprays, try using smaller image files
• Transparent PNGs work best with this mod

License

This mod is released under the MIT License. See the LICENSE file for details.

Credits

• Developed by MishaOpstal
• Special thanks to the R.E.P.O. modding community

Feedback & Support

For bugs, feature requests, or general feedback:

• Create an issue on GitHub

Enjoy spraying!