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

1. Install BepInEx 5 (x64) if you haven't already.
   Get it from BepInEx releases and extract it into your YAPYAP game folder.

2. 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

3. 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:

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

1. Clone or download the source code.
2. Open the .csproj file in Visual Studio (or use dotnet build).
3. 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\).
4. Build the project (target framework: .NET Framework 4.8).
5. 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!