VAutomationCore Framework

VAutomationCore is a shared V Rising server framework. It is live in production and actively used by multiple live modules built on this framework.

NuGet

• Package: VAutomationCore
• Latest package page: https://www.nuget.org/packages/VAutomationCore
• Latest prerelease page: https://www.nuget.org/packages/VAutomationCore/1.0.1-beta.1

Install the latest stable:

<PackageReference Include="VAutomationCore" Version="1.0.0" />

Install specific prerelease:

<PackageReference Include="VAutomationCore" Version="1.0.1-beta.1" />

Focus

• Register in-game commands with VCF.
• Register and initialize services in one startup path.
• Run ECS jobs from services or chat commands.
• Build and run flows with action aliases and entity aliases (EntityMap + EntityAliasMapper), so even other mods that use VCF can automate through flows.
• Enforce core role auth for jobs: Developer can run job flows, Admin alone cannot.

Minimal startup pattern

using System.Reflection;
using VampireCommandFramework;
using VAutomationCore.Core.Api;
using VAutomationCore.Core.Logging;
using VAutomationCore.Core.Services;

public override void Load()
{
    var log = new CoreLogger("Module");
    ServiceInitializer.InitializeLogger(log);
    ServiceInitializer.RegisterInitializer("your_service", YourService.Initialize);
    ServiceInitializer.RegisterValidator("your_service", () => YourService.IsReady);
    ServiceInitializer.InitializeAll(log);

    CommandRegistry.RegisterAll(Assembly.GetExecutingAssembly());
}

In-game console commands (core)

• .coreauth login dev <password>
• .coreauth login admin <password>
• .coreauth status
• .coreauth logout
• .jobs flow add <flow> <action>
• .jobs alias self <alias> / .jobs alias user <alias> [platformId]
• .jobs run <flow>

Developer auth is required for .jobs run.

Community

• Join the V Rising Mods Discord: [https://discord.gg/68JZU5zaq7]
• Need ownership support? Visit: [https://discord.gg/58bTRRxf8]

Auth

• coyoteq1

Note

• Admin and console commands are disabled and do not work in this package.
• This package is a pure library.

Core API Surface

Runtime/Execution

• CoreExecution: safe sync/async execution wrappers with retry (Run, RunAsync, RunWithRetry).
• OperationResult / OperationResult<T>: standard success/failure return model.
• RetryPolicy: retry configuration for resilient operations.

Service/State

• ServiceRegistry: singleton registration/resolution for module services.
• EntityMap: alias-to-entity reference map used by flow/job execution.
• EntityAliasMapper: component alias registration + component query/set helpers.

Flow APIs

• FlowService: register, resolve, and execute action flows.
• FlowDefinition / FlowStep: flow model types used by FlowService.

Auth/Console APIs

• ConsoleRoleAuthService: admin/developer auth session handling.
• CoreAuthCommands / CoreJobFlowCommands: built-in VCF command handlers.

Quick API Examples

using VAutomationCore.Core.Api;
using VAutomationCore.Core.Logging;

// 1) Register and execute a flow
FlowService.RegisterActionAlias("heal", "HealSelf");
FlowService.RegisterFlow("startup", new[]
{
    new FlowStep("heal")
});
var map = new EntityMap();
var result = FlowService.Execute("startup", map);

// 2) Safe execution with retry
var logger = new CoreLogger("Example");
var op = CoreExecution.RunWithRetry(
    () => { /* work */ },
    operationName: "startup-work",
    retryPolicy: RetryPolicy.Default,
    logger: logger
);