
MoonPhaseUtils
A mod that enhances the moon system by providing visual information about the current moon phase and its attributes directly in the game's HUD. Changes the boring system of constant moon phase. It works as server-side and client-side mod.
Last updated | 3 weeks ago |
Total downloads | 644 |
Total rating | 2 |
Categories | Mods Tools Misc Client-side Server-side |
Dependency string | pixkk-MoonPhaseUtils-1.0.1 |
Dependants | 1 other package depends on this package |
This mod requires the following mods to function

BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
MoonPhaseUtils
A BepInEx plugin that enhances the moon system by providing visual information about the current moon phase and its attributes directly in the game's HUD. Changes the boring system of constant moon phase.
It works as server-side and client-side mod.
Mod page on the Github: https://github.com/pixkk/MoonPhaseUtils
Mod can work in two modes:
- Server-side: server owner can see HUD with current moon information, but currently it have a BUG when another players don't see this information. In server-side case, only OWNER must have this mod. Another players can play without it.
- Client-side: in SINGLEPLAYER you can see HUD.
Screenshots
Compatibility
Tested on all versions of R.E.P.O. Currenty 100% working on 0.2.1.
Features
🌙 In-Game Moon Display
- Real-time Moon Information: Displays the current moon's name and attributes in the bottom-right corner of the game screen
- Moon Icon: Shows the corresponding moon icon above the text information
- Dynamic Positioning: The moon icon automatically adjusts its position based on the text size
- Clean UI Integration: Seamlessly integrates with the existing game HUD without interfering with gameplay
🔧 Moon Level Calculation Override
- Custom Moon Progression: Modifies the moon level calculation to follow a 4-phase cycle pattern
- Formula:
moonLevel = ((levelsCompleted - 1) % 4) + 1
- Predictable Phases: Ensures moon phases cycle through levels 1-4 in a predictable pattern
💾 Enhanced Save File Display
[!WARNING] Be careful with mods that modify the save menu - there may be incompatibility with them.
- Moon Information in Saves: Shows moon icons and information in the save file selection screen
Installation
- Make sure you have BepInEx installed
- Download the latest release from the releases page
- Extract the plugin files to your
BepInEx/plugins
folder - Launch the game
Configuration
The plugin works out of the box with no configuration required. The moon display will automatically appear when you're in a gameplay level (not in lobby, menu, tutorial, shop etc.).
Technical Details
Patched Methods
LevelGenerator.GenerateDone
- Triggers moon display setupRunManager.CalculateMoonLevel
- Overrides moon level calculationMenuPageSaves.SaveFileSelected
- Updates save file display
Development
Building from Source
dotnet build MoonPhaseUtils.csproj
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Changelog
Version 1.0.0
- Initial release
- Moon information display in HUD
- Custom moon level calculation
Support
If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository.