ScarletCarrier

ScarletCarrier is a V Rising mod that adds a servant carrier system to help transport your items. The mod provides a convenient way to summon a personal servant that can carry items, with automatic inventory persistence between summons.

Support & Donations

How It Works

When you summon a carrier, your personal servant appears and can store items in its inventory. After 60 seconds, the servant automatically despawns, but all items are saved and will be restored when you summon your carrier again.

Note: Instanced items (items with unique properties like enchantments or durability) cannot be stored in the carrier to prevent data loss during restoration.

Features

• Summon a servant that can carry items
• 60-second duration with manual dismiss option
• Automatic inventory persistence between summons
• Interactive dialogue system
• Simple command interface

Upcoming Features

• Following the player (maybe or maybe not)
• Storage for instanced items
• Customizable carrier appearance

Commands

• .carrier call - Summons your carrier servant
• .carrier dismiss - Dismisses your carrier early

Installation

Requirements

This mod requires the following dependencies:

• BepInEx
• ScarletCore
• VampireCommandFramework

Make sure BepInEx is installed and loaded before installing ScarletCarrier.

Manual Installation

1. Download the latest release of ScarletCarrier.

2. Extract the contents into your BepInEx/plugins folder:

   <V Rising Server Directory>/BepInEx/plugins/

   Your folder should now include:

   BepInEx/plugins/ScarletCarrier.dll

3. Ensure ScarletCore and VampireCommandFramework are also installed in the plugins folder.

4. Start or restart your server.

Join the modding community on Discord.

Changelog

[1.1.2] - 2025-11-24

Fixed

• Refactor Emote and Carrier services to improve entity existence checks and remove unused CleanupService

[1.1.1] - 2025-11-12

Fixed

• Initialization Check: Added checks in Harmony patches to ensure GameSystems are initialized before accessing

[1.1.0] - 2025-11-12

Added

• Enhanced Admin Command System: Expanded administrative tools for carrier management and troubleshooting
  • .carrier forceremove / .car fr - Permanently removes any carrier by aiming at it (destroys entity and coffin)
  • .carrier callevery <playername> / .car ce <playername> - Summons all carriers belonging to a specific player to admin location
  • .carrier callorphans / .car co - Summons all orphaned carriers (disconnected from coffins) to admin location
  • .carrier removeallcarriersfromplayer <playername> - Permanently removes all carriers from a player and transfers items back
  • .carrier forceenableinteract / .car fei - Forces interaction to be enabled on carriers by aiming at them
  • .carrier forceaddteam / .car fat - Forces carriers to be added to their owner's team by aiming at them
  • .carrier forceaccess / .car fa - Sets admin access level for carrier interaction by aiming at them

Improved

• Troubleshooting System: New admin commands specifically designed for resolving bugged carriers
• Documentation: Updated README.md with comprehensive command documentation organized by functionality
• Admin Tools: Enhanced carrier management capabilities for server administrators

[1.0.2] - 2025-08-08

Fixed

• Critical Bug Fix: Fixed issue where new carriers were being incorrectly identified as legacy carriers and deleted
• Coffin-Servant Synchronization: Improved positioning synchronization between carriers and their coffins during follow mode and appearance changes
  • Coffin now repositioned proactively during follow movement to prevent desynchronization
  • Fixed timing issue in appearance swap that could cause temporary position mismatch

[1.0.1] - 2025-08-06

Added

• Private Carrier System: Carriers are now private to their owners - other players cannot interact with carriers that don't belong to them

[1.0.0] - 2025-08-04

Added

• Universal Item Storage: Carriers now accept any items in their inventory, including weapons, armor, and instanced items
• Smart Lifetime System: Carriers now have a 15-day lifetime that only counts when the server is online
  • Timer resets every time you interact with the carrier (summon, dismiss, or use)
  • Carrier is only destroyed if no interaction occurs for 15 days of server uptime
  • Lifetime duration is configurable in mod settings
• Enhanced Animation System: Faster and more fluid spawn/despawn animations
• Admin Commands: New administrative commands for carrier management
  • .carrier move / .car m - Allows admins to move any carrier by aiming and clicking
  • .carrier forcedismiss / .car fd - Allows admins to forcefully dismiss any carrier by aiming at it
  • .carrier forcedismiss <playername> / .car fd <playername> - Allows admins to dismiss a specific player's carrier by name

Changed

• Emote Animation Integration: When emote controls are enabled, original player animations for Yes/No/Point emotes are disabled for smoother carrier management
• Removed Carrier Dialogue: Carrier no longer speaks when summoned or interacted with

Improved

• Overall performance and user experience with streamlined animations
• Better integration between emote controls and carrier functionality

[0.8.3] - 2025-07-28

Changed

• All calls to BuffService.TryApplyBuff now explicitly set the buff duration
• This update is needed for the latest ScarletCore version (to be released)

Fixed

• Improved inventory patch: now detects instanced items correctly instead of relying on component checks
• This makes equipment and special items detection more reliable and robust
• Some items like potions are now allowed to be stored in the carrier

[0.8.1] - 2025-07-08

Added

• Emote Controls Toggle: Added option to disable emote-based carrier controls
• Players can now choose to use only commands instead of emotes for carrier management

Fixed

• Equipment Transfer Prevention: Added protection against transferring equipped items directly from player to carrier inventory
• Prevents players from bypassing equipment restrictions by unequipping items directly into carrier storage
• Previously this protection existed but would purposely delete the transferred item - now it simply blocks the transfer

[0.8.0] - 2025-07-03

Added

• Carrier Following System: Carriers can now follow the player when summoned
  • Use .carrier follow to enable following behavior
  • Use .carrier stop to disable following and make carrier stay in place
• Emote Controls: Added intuitive emote-based carrier management
  • 👍 - Summon/call your carrier
  • 👎 - Dismiss your carrier
  • 👉 - Toggle follow/stay behavior

Changed

• Removed automatic despawn: Carriers no longer automatically disappear after 60 seconds
• Carriers now remain active until manually dismissed by the player (or server restart)

[0.7.0] - 2025-06-18

Added

• Customizable carrier appearance system
• .carrier list command to view available appearances
• .carrier <number> command to change carrier appearance
• Personal appearance settings that persist between summons

Fixed

• Fixed error typeIndexInArchetype was -1 for NetworkComponentIndex: 82. networkSnapshotType: 355

[0.6.4] - 2025-06-18

Changed

• Coffins are now destroyed instead of using the LifeTime component
• Added a cleanup routine to remove all carrier-related entities when the server starts, preventing leftovers from previous sessions

[0.6.3] - 2025-06-17

Fixed

• Fixed servant spawning at incorrect height - now spawns at same level as player

[0.6.2] - 2025-06-16

Fixed

• Fixed null reference exception for new players without saved inventory data
• Fixed "entity does not exist" errors in sequence execution

[0.6.0] - 2025-06-16

• Equipment detection and blocking system to prevent data loss
• Warning messages when attempting to store invalid items
• Automatic item deletion if you try to force store instanced items