PlayerServices

PlayerServices

Server-side V Rising utility mod that adds player services such as player info, starter/daily kits, give sets, teleport points, aura purchases, name change, banlist/whitelist, and admin tools.

Features

• Admin Tools
• Observe mode and player tracking.
• Force clan create, force join, and force leave commands.
• Potion buff tool.
• Centralized config reload without restarting the server.

• Aura System
• Players can buy aura buffs using configured currencies.
• Players can preview an aura before buying it.
• Players can enable or disable owned auras.
• Admins can grant or remove auras from players.
• Examples of auras that can be used.

• Change Name
• Players can change their character name for a configurable currency cost.
• Supports optional in-game broadcasts and Discord webhook notifications.
• Admins can rename players directly.

• Player Profiles
• Tracks player SteamID, current in-game name, Known As, level data, clan data, castle data, aura ownership, kit claim status, and last online time.
• Supports admin lookup by player name, SteamID, or Known As.
• Supports banlist and whitelist management.

• Player Information
• .pis command is an upgraded version of the popular .pi command that many PvP players are already familiar with.
• Admins can configure whether clan castle information and offline clan member last online times are shown to players.
• Admins can always see full .pis information, including clan data, current level, highest level reached, castle ownership, online clan members, and the last online time of offline members.

• Banlist
• Designed for public servers.
• Ban players to prevent them from connecting to the server.
• Banned players are kicked immediately if they are online.

• Whitelist System
• Designed for private servers only.
• When whitelist-only mode is enabled, only players marked as whitelisted are allowed to connect to the server.
• You can pre-register players using the command: .pls addwhitelist <SteamID> <KnownAs>.
• Banned players are always blocked, even if they match the whitelist requirement.

• Teleport Points
• Admins can create teleport slots.
• Teleport points can be admin-only or usable by players.
• Player teleport delay is configurable and will be cancelled when the player moves, enters combat, or enters blocked states.

• Give Sets
• Give item sets to a specific player, players in a radius, or online clan members.
• Supports multipliers when giving sets.
• Admins can add, remove, and list give set items.

• Starter Kit
• Automatically grants a one-time starter kit to newly created characters.
• Players can manually claim it if auto-grant fails.
• Admins can add, remove, and list starter kit items.

• Daily Kit
• Lets players claim a daily kit once per day.
• Admins can add, remove, and list daily kit items.

• Welcome Message
• Sends configurable welcome messages when players connect.

• Logging
• Records kit claims, give actions, rename actions, and aura purchases in CSV log files.

Requirements

1. BepInEx 1.733.2
2. VampireCommandFramework 0.11.0

Installation

1. Install the required dependencies.
2. Place PlayerServices.dll into your server's BepInEx plugins folder.
3. Start the server once to generate the config files.
4. Edit the config files as needed.
5. Restart the server or use .pls reload.

Commands

Most commands use the .pls prefix, which stands for PlayerServices. But if it's easier, just remember it as "please". The server won't actually be more cooperative, but it feels more polite.

Player Info

• .pis <player>
• Show player information.
• Example: .pis Del

Starter Kit

• .pls starterkit
• Claim your one-time starter kit if auto-grant fails.
• Shortcut: .pls sk

• .pls addstarterkit <prefabGuid> <quantity> 🔒 Admin only
• Add or update an item in the starter kit.
• Shortcut: .pls ask <prefabGuid> <quantity>
• Example: .pls ask 800879747 1

• .pls removestarterkit <prefabGuid> 🔒 Admin only
• Remove an item from the starter kit.
• Shortcut: .pls rsk <prefabGuid>
• Example: .pls rsk 800879747

• .pls liststarterkit 🔒 Admin only
• Show all starter kit items.
• Shortcut: .pls lsk

Daily Kit

• .pls dailykit
• Claim your daily kit.
• Shortcut: .pls dk

• .pls adddailykit <prefabGuid> <quantity> 🔒 Admin only
• Add or update an item in the daily kit.
• Shortcut: .pls adk <prefabGuid> <quantity>
• Example: .pls adk 800879747 1

• .pls removedailykit <prefabGuid> 🔒 Admin only
• Remove an item from the daily kit.
• Shortcut: .pls rdk <prefabGuid>
• Example: .pls rdk 800879747

• .pls listdailykit 🔒 Admin only
• Show all daily kit items.
• Shortcut: .pls ldk

Teleport

• .pls tp <slot>
• Teleport to a saved teleport point.
• Non-admin players can only use teleport points that are not admin-only.
• Example: .pls tp 1

• .pls helptp
• Show teleport point commands and feature status.
• Shortcut: .pls htp

• .pls addtp <slot> [adminOnly] [description] 🔒 Admin only
• Add a teleport point at your current position.
• Shortcut: .pls atp <slot> [adminOnly] [description]
• Example: .pls atp 1 false "Admin shop"

• .pls removetp <slot> 🔒 Admin only
• Remove a teleport point.
• Shortcut: .pls rtp <slot>
• Example: .pls rtp 1

• .pls listtp 🔒 Admin only
• List all teleport points.
• Shortcut: .pls ltp

Change Name

• .changename to <NewName>
• Change your character name.
• Shortcut: .cn to <NewName>
• Example: .cn to Led