CustomAbilities

This is the repository for CustomAbilities, coded by Fryke (fryke) on Discord.

CustomAbilities is a V Rising dedicated server mod that allows server admins to assign custom abilities to players and items. Override any ability slot on any weapon category, apply abilities directly to specific items, and provide a public API for other mods to integrate with.

Features

• Player Ability Assignment - Set any ability on any slot (Attack, Q, E, Dash, Spell 1, Spell 2, Ultimate) for any weapon category.
• Item Ability Assignment - Apply abilities directly to specific weapons/items. Item abilities override category-level abilities.
• Quick Set Commands - Players can set their currently equipped R/C spell to Q/E with a single command.
• Spell Pool System - External mods register spell providers to define which spells a player has access to. Player spell assignment is gated by the pool; admin assignment bypasses it. Spells support user-friendly aliases and per-spell allowed/restricted slots, with fuzzy name matching on assign.
• Ability Presets - Players can save, load, list, and delete named presets capturing all weapon categories plus vanilla R/C/T/Dash baseline. Loading restores both custom slots and baseline spells.
• Banned Combination Notifications - Server-defined ability combos trigger a one-time system message when a player has the full combo equipped. Notify only, never blocks.
• Form Ability Overrides - API for other mods to supply custom ability arrays for shapeshift forms.
• Special Case Handlers - API for other mods to modify ability slots at runtime based on tags, buffs, or state.
• Jewelable Ability Blocking - Prevents jewelable abilities (spell school abilities) from being assigned to items, protecting against a known engine bug that can delete jewels and corrupt inventory data.
• Ability Merge Priority - Item abilities > category abilities > default, with a clear merge chain.
• Persistent Data - All player and item ability data saved to local JSON files and survives server restarts.

Commands

All commands use the .abilities prefix (shorthand: .ab).

Player Commands

Command — Shorthand — Description — Admin Only

.abilities set primary — .ab set q — Set your currently selected R spell to Q — No

.abilities set secondary — .ab set e — Set your currently selected C spell to E — No

.abilities clear primary — .ab clear q — Clear your Q ability slot — No

.abilities clear secondary — .ab clear e — Clear your E ability slot — No

.abilities spell list [page] — .ab spl — List available spells from your pool (paged, 10 per page) — No

.abilities spell assign — .ab spa — Assign a spell from your pool to a slot by GUID, name, alias, or fuzzy match — No

.abilities spell unassign — .ab spu — Clear a spell from a slot — No

Preset Commands

Command — Shorthand — Description — Admin Only

.abilities preset save — .ab ps — Save current abilities and baseline spells as a named preset — No

.abilities preset load — .ab pl — Load a saved preset (restores custom slots and baseline R/C/T/Dash) — No

.abilities preset list [page] — .ab plist — List saved presets (paged, 10 per page) — No

.abilities preset delete — .ab pd — Delete a saved preset — No

Admin Commands

Command — Shorthand — Description

.abilities set [player] [category] — .ab as — Set an ability on a slot for a player/weapon category

.abilities clear [player] [category] — .ab ac — Clear an ability slot for a player/weapon category

.abilities clearall [player] [category] — .ab aca — Clear all ability slots for a player/weapon category

.abilities cast — .ab cast — Cast an ability by prefab GUID

.abilities item set — .ab ias — Set an ability on the held item

.abilities item clear — .ab iac — Clear an ability slot on the held item

.abilities item clearall — .ab iaca — Clear all abilities on the held item

Slot IDs: 0 = Attack, 1 = Q, 2 = E, 3 = Dash, 4 = Spell 1, 5 = Spell 2, 6 = Ultimate

Slots also accept friendly names: primary/attack, q/secondary, e/power, dash/travel, r/spell1/offensive, c/spell2/defensive, t/ultimate/ult. Examples: .ab as q 123456, .ab spa r Shadowbolt.

Weapon categories: All, Unarmed, Axe, Claws, Crossbow, Daggers, FishingPole, GreatSword, Longbow, Mace, Pistols, Reaper, Slashers, Spear, Sword, TwinBlades, Whip. Passing All as the weapon category applies the change across all categories.

Notes:

• FishingPole is a standalone category. Quick set/clear (set primary, set secondary, etc.) targets Unarmed only.
• Self-serve .abilities spell assign on slots 0-2 (Attack/Q/E) applies to Unarmed. Slots 3-6 apply across all weapon categories.

Configuration

Config is stored in BepInEx/config/io.vrising.CustomAbilities.cfg.

Key — Default — Description

BlockJewelableAbilitiesOnItems — true — Prevent jewelable abilities (spell school abilities) from being set on items/weapons

DevMode — false — Enable development mode with additional logging/debugging features

BlockPresetsInCombat — true — Block .abilities preset save and preset load while the player has the combat (PvE) or PvP combat buff

| `SpellAssign.