MoonPhaseUtils
A BepInEx 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.
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
| R.E.P.O version |
Mod version |
| 0.4.0 |
2.1.0 |
| 0.3.0 |
2.0.0 |
| 0.2.1 |
1.0.0 |
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 mod files to your
BepInEx/plugins folder
- Launch the game
Configuration
The mod 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 2.1.0
- Update for the version 0.4.0
- Fixed Moon icon displaying
======================================
Version 2.0.0
- Update for the version 0.3.0
- do not display white square instead Moon icon when level < 10
- Fixed SaveFileSelected menu
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.
