ServantForge - README

Description

ServantForge is a V Rising mod that empowers players to upgrade their fully converted servant’s expertise using in-game resources. With the .upgradeservant (alias .us) command, you can boost your servant’s proficiency by consuming a specified amount of a cost item (default: Thistle). This mod seamlessly integrates with your inventory system, automatically verifying and deducting the required items, and updates both the servant’s expertise and associated blood quality. Key features include:

• Servant Expertise Upgrades: Increment your servant’s proficiency up to a configurable maximum.
• Inventory Management: Automatically checks for and removes the required cost items from your inventory.
• Configurable Settings: Customize the proficiency increment, maximum proficiency, and cost item parameters via the BepInEx configuration file.
• use !servantreload to reload the config from in game.

Patch Notes (v1.0.0) (OG release)

• Command: .upgradeservant or .us to upgrade servant expertise.
• Validation: Ensures the servant is fully converted and located at a servant coffin.
• Inventory Check: Verifies the presence of the required cost items (default: Thistle) and removes them upon a successful upgrade.
• Expertise Increment: Increases the servant's proficiency by a configurable percentage (default is 6% per upgrade) up to a set maximum (default is 44%).
• Visual Feedback: Provides color-coded chat messages to inform players of the upgrade result.
• Config Options:
  • ProficiencyIncrement: Determines how much expertise is added per upgrade (0.06 = 6%).
  • MaxProficiency: Sets the maximum expertise level a servant can reach (default is 0.44 or 44%).
  • CostItemGUID & CostItemAmount: Define the required cost item (default: Thistle) and its quantity (default: 300).

.upgradeservant / .us

Description: Upgrades a fully converted servant’s expertise for a cost. Usage: .upgradeservant

Functionality:

• Proximity Check: Verifies that a servant coffin is near your mouse position.
• State Check: Confirms that the servant is fully converted.
• Inventory Verification: Checks if you have enough of the required cost item in your inventory.
• Item Removal & Upgrade: Deducts the specified number of cost items and increases the servant’s expertise and blood quality accordingly.
• Feedback: Returns a color-coded chat message indicating success or error.

Installation Instructions

1. Download the Mod Files:
   • Obtain the latest ServantForge.dll release from the official repository or release page.
2. Extract and Place Files:
   • Place the ServantForge.dll file in your server’s BepInEx plugins directory: V_Rising_Server/ └── BepInEx/ └── plugins/ └── ServantForge.dll
3. Launch the Server:
   • Start your V Rising dedicated server. ServantForge will initialize automatically and generate any necessary configuration files.

Dependencies

• BepInEx
• Bloodstone.API
• VampireCommandFramework

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

This mod is free to use or modify. Disclaimer: ServantForge is a third-party mod and is not affiliated with the official V Rising development team. Use at your own risk.