Quick Drop

A quality-of-life mod that adds dedicated hotkeys to quickly drop items, gems, and tokens during gameplay. Recommended for multiplayer coop sessions.

---

💡 Note

• It is recommended to use Mod Config Menu to edit and hot-reload configuration changes in-game without restarting. Not required, but convenient.

---

Features

Quick Drop Items

No more fumbling through inventory menus - drop what you need instantly and keep moving. Press a hotkey to instantly drop the item currently selected in the quick access menu (bottom left). Perfect for sharing items with friends in co-op or dropping unwanted loot without stopping/opening inventory. Includes a "Dropped: %ItemName%" toasts similar to the game's native pickup ones.

Quick Drop Gems

New feature. Press a hotkey to drop a configurable amount of gems (default: 100). Features:

• Custom drop amounts (drop exactly what you need). The mod uses Necropolis' clever gem splitting system based on the amount set.
• Drop all gems at once (set amount to 0)
• Anti-Exploit Protection: Prevents TreasureHunter codex from doubling player-dropped gems to soft-patch the exploit.

Quick Drop Tokens

New feature. Help your friend out! Press a hotkey to drop one token at a time.

Localization

The mod uses the game's native localized strings for 75% of its toasts (pickups for items, gems, and tokens). The remaining 25% (drop messages) are handled by JSONLocalizeAPI. The result is seamless, fully-localized UI text.

Configurables

• Individual feature toggles (disable what you don't use)
• Customizable keybindings for each drop type
• Optional toast notifications
• Debug mode for troubleshooting

Installation

Automatic (Recommended)

1. Install with Gale, r2modman or Thunderstore Mod Manager.
2. Launch the game

Manual

1. Install BepInExPack Necropolis v5.4.2304
2. Download Quick Drop from Thunderstore
3. Extract QuickDrop.dll to BepInEx/plugins/
4. Launch the game

---

Configuration

Config file location: BepInEx/config/komikoza.necropolis.quickdrop.cfg

Key	Action	Default Amount
G	Drop equipped item	1 item
B	Drop gems	100 gems
N	Drop token	1 token

General Settings

[General]
## Enable or disable this mod
ModEnabled = true

## Show toast notifications when dropping items
ShowDropToast = true

## Amount of gems to drop (0 = drop all)
GemDropAmount = 100

Tip: Set GemDropAmount = 0 to drop your entire gem stack with one keypress.

Feature Toggles

[Features]
## Enable quick drop for items
EnableItems = true

## Enable quick drop for gems
EnableGems = true

## Enable quick drop for tokens
EnableTokens = true

Use case: Disable features you don't use to free up keybindings.

Debug Mode

[Debug]
## Enable debug logging
DebugMode = false

Enable this if you're experiencing issues - check BepInEx/LogOutput.log for detailed information.

FAQ

Q: Can I drop multiple tokens at once?

A: Yes, if you set the amount below 100. 100 drops 1 big gem, lesser amounts will fragment into multiple gems.

Q: Does this work in multiplayer?

A: Yes, all drops are automatically synced to other players.

Q: Can I disable just gems but keep items?

A: Yes, use the feature toggles:

EnableItems = true
EnableGems = false
EnableTokens = true

Q: Why can't I drop items during combat?

A: The mod checks TryUseItem() which prevents drops during animations. This is intentional to prevent weird behavior.

Changelog

1.0.1

• Thunderstore README fixes (the mod itself stays as 1.0.0)

1.0.0 (Current)

• Initial Thunderstore release

Credits

• Author: KoMiKoZa
  Discord: komikoza

Support

• Website: Mod Documentation
• Source Code: GitHub
• Issues: Report bugs on Discord or GitHub Issues