ForgeScheduler

A V Rising server plugin designed to automate and schedule various ForgeMods to give server admins flexible control over when mods are active and how they scale over time. This guide explains what ForgeScheduler does, which mods it manages, how to configure it, and how to extend day-based settings.

Discords to join for support and more mods.

• https://discord.gg/sanguineReign
• https://wiki.vrisingmods.com

Key Features

1. Scheduled Activations

   • Define start/end times for each day of the week to toggle mod features
   • Option to ignore scheduling and keep certain mod settings either always on or off(raidforge .raidon)

2. Day-Based Automations

   • Tracks the number of days passed since a configurable "StartDate."
   • Adjusts certain mod settings (e.g., golem health) based on the current day.
   • Day 0 is the starting day (immediately when the server's StartDate is set).
   • Day 1 means more than 24 hours have elapsed since the StartDate.

3. Commands & Reloading

   • In-game chat commands let you reload the config, check how many days have passed, or reset tracking without restarting the server.
   • Additional commands let you set and view the StartDate.

4. Manages ForgeMods

Requirements

• BepInEx (IL2CPP) for V Rising.
• Bloodstone (gg.deca.Bloodstone) – Hard dependency.

Installation

1. Install BepInEx (IL2CPP) for V Rising.
2. Install Bloodstone by placing the required DLLs into BepInEx\plugins.
3. (Optional) Install RaidForge if you want scheduled raid toggles.
4. Place ForgeScheduler DLL in BepInEx\plugins\ForgeScheduler.
5. Start or restart your V Rising server.

Configuration

Current Mods Supported

`RaidForge`

Raidforge Config File: RaidForge.cfg

This file manages scheduling times and day-based automation settings:

• IgnoreScheduleTime (true/false): If true, scheduling windows are ignored and raids remain in their last known state.
• DayNumber: The number of days since StartDate. Day 0 is immediate, Day 1 is after 24 hours, etc.

SiegeWeaponHealth

Golem Settings and their corresponding HP defaults:

• VeryLow → 750
• Low → 1000
• Normal → 1250
• High → 1750
• VeryHigh → 2500
• MegaHigh → 3250
• UltraHigh → 4000
• CrazyHigh → 5000
• Max → 7500

To configure custom HP progression over multiple days, simply specify in your GolemDayToHealthMap which day gets which health setting. For example:

GolemDayToHealthMap = 0=VeryLow,1=Low,2=Normal,3=High,4=VeryHigh,5=MegaHigh,6=UltraHigh,7=CrazyHigh,8=Max

Feel free to remove or add entries based on how often you want the health to change. You can keep adding more days by typing , (daynumber) Golem HP setting.

StartDate Config File: StartDate.cfg

This file manages the server’s starting date/time. ForgeScheduler uses this to calculate how many days have passed.

• StartDate: Specify a date/time in yyyy-MM-dd HH:mm:ss format. Example: 2025-03-20 14:30:00. You can also use a command to fill it in
• GolemAutomationEnabled = true set this to true to enable automation of changing HP based on how many days passed . Keep at false to not have the change(recommend to set to true).

In-Game Commands

Type commands in the in-game chat window. Some commands require admin privileges.

ForgeScheduler

1. .startdate

   • Admin only.
   • Sets or shows the server’s StartDate.
   • Usage:

     .startdate                       // Shows the current StartDate set
     .startdate now                   // Sets StartDate to the current server time 
     .startdate 2025-03-20 14:30:00   // Sets StartDate to a specific date/time that you manually set (recommended in the config side)
     
     
     

2. .startdatecheck

   • No admin required.
   • Displays the current StartDate.

3. Make sure you do you a day reset if you change the start date for the mod, for example !rfdayreset (all mod reset coming when more mods added)

RaidForge Configuration

1. !forgescheduler

   • Admin only.
   • Reloads the ForgeScheduler config (RaidForge.cfg) without restarting the server.
   • Usage:

     !forgescheduler
     

2. !rfdayscount

   • Admin only.
   • Shows how many full days have passed since StartDate and the time until the next day boundary.
   • Usage:

     !rfdayscount
     

3. !rfdayreset

   • Admin only.
   • Reloads config, resets the last known day for golem HP, and updates HP immediately. Use this if you are make changes to the start date so that it resets the count.

Installation Instructions

1. Download the Mod Files:

   • Obtain the latest ForgeScheduler.dll release from the official repository or release page.

2. Extract and Place Files:

   • Place the ForgeScheduler.dll file in your server’s BepInEx plugins directory: V_Rising_Server/ └── BepInEx/ └── plugins/ └── ForgeScheduler.dll

3. Launch the Server:

   • Start your V Rising dedicated server. ServantForge will initialize automatically and generate any necessary configuration files

Support

For support, bug reports, or feature requests:

• Discord: Direct Message inility#4118
• Community: Join our community server: https://discord.gg/sanguineReign
• Additional Resources: Explore more Forge System mods and get help at the V Rising Mods Wiki (https://wiki.vrisingmods.com/).

Developer

• Darrean (inility)

License & Credits

• Free to use and modify how you want.