StaffKeeper

StaffKeeper

StaffKeeper is a BepInEx plugin for the game YAPYAP that allows the host (server owner) to spawn any wand directly into their hand via a simple GUI. Spawned wands are fully networked and usable by all players.

Features

• Open a GUI window with a list of all available wands (prefabs) by pressing a hotkey.
• Click on a wand name to instantly spawn it in the host's right hand (automatically drops any existing item).
• All spawned items are networked – visible and usable by every player in the game.
• Fully configurable: custom wand list or auto‑detection based on prefab name containing "Wand".
• Mouse cursor is automatically unlocked while the GUI is open, and re‑locked when closed.

Installation

• Install BepInEx 5 (x64) if you haven't already.

Get it from BepInEx releases and extract it into your YAPYAP game folder.

• Place the plugin

Copy StaffKeeper.dll into the BepInEx/plugins folder inside your game directory.

The final path should look like:...\YAPYAP\BepInEx\plugins\StaffKeeper.dll

• Launch the game – the plugin will generate a configuration file on first run.

Usage

• Only the host (the player who created the lobby) can use this plugin.
• Press the default hotkey F6 to open the wand selection window.
• The mouse cursor will become free – click any wand button to spawn it directly into your character's right hand.
• Close the window by clicking the Close button or pressing F6 again. The cursor will be locked back.

Note: If you are not the host, pressing the hotkey will still open the window, but spawning will fail with a warning. (Optional: you can restrict the window entirely to the host by uncommenting the if (!NetworkServer.active) return; line in the code.)

Configuration

The configuration file is created at BepInEx/config/StaffKeeper.cfg after the first game launch. It contains the following options:

| Section | Key | Description |

|----------|-----------------|-------------|

| General | ToggleHotkey | Keyboard shortcut to open/close the GUI. Default: F6. |

| Wands | CustomWandNames | Manually specify wand prefab names (one per line). If empty, the plugin automatically lists all prefabs whose name contains "Wand" and have a NetworkPuppetProp component. |

Example configuration:

[General]

Keyboard shortcut to open/close the GUI

ToggleHotkey = F6

[Wands]

Manually specify wand prefab names (one per line). Leave empty for auto-detection.

CustomWandNames =

Building from Source

• Clone or download the source code.
• Open the.csproj file in Visual Studio (or use dotnet build).
• Make sure the reference paths in the project file point to your game installation (e.g., D:\Steam\steamapps\common\YAPYAP\YAPYAP_Data\Managed\ and BepInEx\core\).
• Build the project (target framework:.NET Framework 4.8).
• The compiled StaffKeeper.dll will be placed in the output folder.

Requirements

• BepInEx 5 (tested with version 5.4.23.3)
• YAPYAP game (any recent build)
• Windows (64-bit)

License

This project is provided under the MIT License. Feel free to modify and distribute it.

Credits

Developed by [hyy] for the YAPYAP modding community. Special thanks to the BepInEx team and Mirror networking library.

Enjoy your wands, and may your spells be ever powerful!