The update 1.1.0+ REQUIRES the latest version of ScarletCore, so make sure to update it as well.

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.

Upcoming Features

• Additional customization options for carrier behavior and appearance

Support & Donations

How It Works

When you summon a carrier, your personal servant appears and can store any items in its inventory. The carrier will remain active until you manually dismiss it, or the server restarts.

Carrier Lifetime System: Your carrier has a 15-day lifetime that only counts when the server is online. Every time you interact with your carrier (summon, dismiss, or use it), the timer resets. The carrier will only be destroyed if you don't interact with it for a total of 15 days of server uptime. This lifetime can be configured in the mod settings.

⚠️ Important Warning: When a carrier expires due to inactivity, all items stored in its inventory will be permanently lost. Make sure to regularly interact with your carrier to reset the timer and prevent item loss.

Features

• Universal item storage - Store any items in your carrier's inventory, including weapons, armor, and instanced items
• Private carrier system - Your carrier is private to you; other players cannot access your carrier's inventory
• Smart lifetime system - 15-day lifetime that only counts server uptime and resets with each interaction (configurable)
• Enhanced animations - Faster and more fluid spawn/despawn animations for better gameplay flow
• Summon a servant that can carry items
• Manual dismiss and emote controls for carrier management
• Automatic inventory persistence between summons
• Simple command interface
• Customizable carrier appearance with multiple options
• Carrier following system - Your carrier can follow you around or stay in place
• Emote controls - Use emotes for quick carrier management with seamless animation integration

Commands

Player Commands

• .carrier call / .car c - Summons your carrier servant
• .carrier dismiss / .car d - Dismisses your carrier early
• .carrier follow / .car f - Makes your carrier follow you around
• .carrier stop / .car s - Makes your carrier stay in place
• .carrier list / .car l - Lists all available carrier appearances
• .carrier appearance <number> / .car a <number> - Changes the appearance of your carrier servant to the specified number from the list
• .carrier toggle emotes / .car te - Toggles emote controls on/off for your carrier

Admin Commands

Carrier Management

• .carrier move / .car m - Allows admins to move any carrier by aiming at it and clicking to place
• .carrier forcedismiss / .car fd - Allows admins to forcefully dismiss any carrier by aiming at it
• .carrier forcedismiss <playername> / .car fd <playername> - Allows admins to forcefully dismiss a specific player's carrier by name
• .carrier forceremove / .car fr - Permanently removes any carrier by aiming at it (destroys entity and coffin)

Troubleshooting Commands

These commands exist only for cases where a carrier has bugged and needs to be removed by the server administrator

• .carrier callevery <playername> / .car ce <playername> - Summons all carriers belonging to a specific player to your location
• .carrier callorphans / .car co - Summons all orphaned carriers (carriers disconnected from their coffins) to your location
• .carrier removeallcarriersfromplayer <playername> - Permanently removes all carriers from a specific player

Technical Fix Commands

• .carrier forceenableinteract / .car fei - Forces interaction to be enabled on any carrier by aiming at it
• .carrier forceaddteam / .car fat - Forces a carrier to be added to its owner's team by aiming at it
• .carrier forceaccess / .car fa - Sets admin access level for interaction with any carrier by aiming at it

Emote Controls

For quick and intuitive carrier management, you can use these emotes with seamless animation integration:

• 👍 Yes - Summon your carrier (original player animation disabled when emote controls are enabled)
• 👎 No - Dismiss your carrier (original player animation disabled when emote controls are enabled)
• 👉 Point - Toggle between follow/stay behavior (original player animation disabled when emote controls are enabled)

Note: When emote controls are enabled via .carrier toggle emotes, the original player animations for these specific emotes are disabled to provide a smoother experience. If you disable emote controls, the original animations will work normally.

Appearance System

Your carrier's appearance can be customized using various predefined options. Each player can have their own unique appearance setting that persists between summons. Use .carrier list to see all available appearances with their corresponding numbers, then use .carrier appearance <number> to apply your preferred look.

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.

This project is made possible by the contributions of the following individuals:

• cheesasaurus, EduardoG, Helskog, Mitch, SirSaia, Odjit & the V Rising Mod 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