QuickDrop v1.0.0 by KoMiKoZa

Communities

NecropolisLoading...QuickDrop1.0.0

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

7 months ago

Downloads

134

Size

62KB

Dependency string

KoMiKoZa-QuickDrop-1.0.0

Download

Details Required (2)Versions

# 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](https://thunderstore.io/c/necropolis/p/KoMiKoZa/ModConfigMenu/) 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](https://thunderstore.io/c/necropolis/p/KoMiKoZa/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](https://galemodmanager.com/#download-gale-mod-manager), [r2modman](https://thunderstore.io/c/necropolis/p/ebkr/r2modman/) or Thunderstore Mod Manager.

2. Launch the game

### Manual

1. Install [BepInExPack Necropolis v5.4.2304](https://thunderstore.io/c/necropolis/p/BepInEx/BepInExPack_Necropolis/)

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.0 (Current)

- Initial Thunderstore release

## Credits

- **Author**: KoMiKoZa

**Discord**: komikoza

## Support

- **Website**: [Mod Documentation](https://komikoza.github.io/necropolis/mods/QuickDrop.html)

- **Source Code**: [GitHub](https://github.com/KoMiKoZa/Necropolis-QuickDrop)

- **Issues**: Report bugs on [Discord](https://discord.gg/2233yFQ) or [GitHub Issues](https://github.com/KoMiKoZa/Necropolis-QuickDrop/issues)

\[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