Essentials

Essentials is a quality-of-life enhancement mod for the game R.E.P.O. This BepInEx plugin addresses several usability issues in the base game and provides customization options that improve the overall player experience.

The mod focuses on fixing common frustrations and adding missing functionality that players expect, such as proper currency formatting, improved chat functionality, and single-player convenience features. Whether you're playing solo or with friends, these essential improvements make the game more accessible and enjoyable without altering core gameplay mechanics.

Development is ongoing as I try to make R.E.P.O. an even better experience, especially when playing with friends. If you have ideas for new features or improvements, please reach out. I'd love to hear from you as I expect this project to grow based on community feedback. Thanks for checking this plugin out and enjoy the game!

Table of Contents

• Compatibility
• Incompatibilities
• Configuration
• Patches
  • Currency Culture
  • Chat Character Limit
  • Server Max Players
  • Single-Player Chat
• Building
• License

Compatibility

• R.E.P.O.: v0.1.2
  • App ID: 3241660
  • Build ID: 17560228
• BepInEx: v5.4.2100

Incompatibilities

This plugin will not work with the following mods and has been configured to avoid loading when they are detected:

• NoLimitChatbox by nickklmao: Both plugins modify the chat character limit system in different ways. NoLimitChatbox removes the character limit entirely, while Essentials replaces it with a configurable value.
• MorePlayers by zelofi: This mod alters the maximum player limit as well, creating a direct conflict with Essentials' Server Max Players feature. Both cannot be used simultaneously.

Configuration

All plugin settings can be found in the following config file:

• Config Path: BepInEx/config/org.ccarrmcmahon.plugins.repo.essentials.cfg

Patches

Currency Culture

Fixes the in-game currency display that was hardcoded to German locale (which uses decimal points as thousand separators). It now uses your system's culture settings for proper number formatting.

Chat Character Limit

Enhances the chat system with multiple customization options, allowing you to adjust how chat appears and functions in-game.

Note: These are client-side adjustments as there is no default support for these as server configurations.

Server Max Players

Allows you to increase the maximum number of players beyond the game's hardcoded limit of 6.

Single-Player Chat

Enables access to the chat window in single-player mode by tricking the game into thinking you're in multiplayer. The chat window is normally disabled entirely in single player, but this patch allows you to open it and use it for command testing.

Note: Text-to-speech functionality is not currently available as it would require significant modification to the game's networking layer. This may be added in the future.

Building

To build a release package:

1. Run .\build.ps1 from PowerShell
2. Enter the plugin version, game version, and game build ID when prompted
3. The script will update all version numbers, build the project, and create a release package

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and adheres to Semantic Versioning.

Unreleased

0.3.5 - 2025-03-25

Added

• Created this CHANGELOG.md file to track releases better (#20).
• Introduced a new step in the build script to include this file in the release package.

Changed

• Reduced the default value of [Chat] LineSpacing to -45 to avoid overlap with large characters such as brackets.
• Refactored the config table in README.md to better show the range of valid values.
• Renamed the CurrentCulture class to CurrencyCulture so it matches the file and patch name.

Fixed

• Configuration adjusted to work with RepoConfig (#18).
  • Note: A game restart is currently required after changing config values as they are injected at launch.