QuickDrop

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)

• Install with Gale, r2modman or Mod Manager.
• Launch the game

Manual

• Install BepInExPack Necropolis v5.4.2304
• Download Quick Drop
• Extract QuickDrop.dll to BepInEx/plugins/
• 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

• README fixes (the mod itself stays as 1.0.0)

1.0.0 (Current)

• Initial release

Credits

• Author: KoMiKoZa

Discord: komikoza

Support

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