Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
NearbyCraft+

NearbyCraft+ is my Paper plugin that brings the well-known CraftFromContainers experience to Paper servers — fully server-side and without requiring any client-side mods.
Instead of opening chest after chest and manually collecting materials, players can use a workbench and craft with items from nearby containers directly. My goal with NearbyCraft+ was to bring that super comfortable mod-like crafting experience to Paper in a clean, fast, and intuitive way.
Why NearbyCraft+?
If you know the CraftFromContainers feeling from modded gameplay, this plugin is basically my Paper-server answer to it.
With NearbyCraft+ your players can:
- craft with materials from nearby chests
- see exactly what they need and what they already have
- browse items by categories
- switch quickly through categories
- search for materials directly from the menu
- enjoy the whole system without installing a client-side mod
That makes it perfect for:
- survival servers
- SMPs
- building-focused servers
- storage-heavy bases
- quality-of-life server setups
Highlights
Craft directly from nearby containers
NearbyCraft+ scans nearby chests and lets players use those materials directly at the workbench.
No more constant back-and-forth between storage and crafting table.
Smart recipe preview
One of the biggest highlights of NearbyCraft+ is the recipe preview system.
Players can instantly see:
- how many items are needed
- how many are available
- how often the recipe is craftable
This gives a very clear overview and makes crafting much more comfortable.
Categories and quick navigation
Recipes and items can be browsed through organized categories.
There is also a quick category switch for fast navigation with left and right click.
Search and filter system
Players can use the search function to filter items by material name.
For example, typing axe will show all matching materials/items.
The filter can be removed again with a simple right click.
Protection hook support
NearbyCraft+ respects container protection.
If a player is not allowed to access a nearby container, NearbyCraft+ will not scan it and will not count the items inside it.
This is especially important for protected claims and survival servers.
Feature Overview
- CraftFromContainers-style crafting for Paper servers
- Craft with items from nearby chests
- Recipe preview with needed / available / craftable counts
- Category-based browsing
- Quick category switching
- Search function with chat input
- Easy filter reset
- Paginated browsing
- Clean menu layout
- Scan statistics in the interface
- Configurable scan range for nearby containers
- Workbench owner protection
- Trust system for placed workbenches
- SimpleClaimSystem support
- WorldGuard support
- JustLootIt protection
- Loot table and plugin-container filtering
Commands
Main command:
/nearbycraftplus/ncp/nearbycraft
| Command | Description | Permission |
|---|---|---|
/ncp reload |
Reloads the NearbyCraft+ configuration and language files. | nearbycraftplus.command.reload |
/ncp scan |
Runs the scan debug command. | nearbycraftplus.command.scan |
/ncp recipereport |
Creates a recipe report. | nearbycraftplus.command.recipereport |
/ncp recipereport full |
Creates a full detailed recipe report. | nearbycraftplus.command.recipereport |
/ncp give <player> [amount] |
Gives NearbyCraft+ workbenches to a player. | nearbycraftplus.command.give |
/ncp trust <player> |
Allows another player to use your placed NearbyCraft+ workbench. | nearbycraftplus.workbench.trust |
/ncp untrust <player> |
Removes a trusted player from your workbench. | nearbycraftplus.workbench.untrust |
/ncp trustlist |
Shows all trusted players for your workbench. | nearbycraftplus.workbench.trustlist |
Permissions
| Permission | Description | Default |
|---|---|---|
nearbycraftplus.admin |
Grants access to all NearbyCraft+ admin features. | OP |
nearbycraftplus.command.recipereport |
Allows running the NearbyCraft+ recipe report command. | OP |
nearbycraftplus.command.reload |
Allows reloading NearbyCraft+. | OP |
nearbycraftplus.command.scan |
Allows using the scan debug command. | OP |
nearbycraftplus.command.give |
Allows giving NearbyCraft+ workbenches. | OP |
nearbycraftplus.update |
Allows receiving NearbyCraft+ update notifications. | OP |
nearbycraftplus.workbench.use |
Allows using the NearbyCraft+ workbench. | Everyone |
nearbycraftplus.workbench.place |
Allows placing the NearbyCraft+ workbench. | Everyone |
nearbycraftplus.workbench.break |
Allows breaking the NearbyCraft+ workbench. | Everyone |
nearbycraftplus.workbench.craft |
Allows crafting inside the NearbyCraft+ workbench. | Everyone |
nearbycraftplus.workbench.trust |
Allows trusting players for owned NearbyCraft+ workbenches. | Everyone |
nearbycraftplus.workbench.untrust |
Allows removing trusted players from owned NearbyCraft+ workbenches. | Everyone |
nearbycraftplus.workbench.trustlist |
Allows viewing trusted players of owned NearbyCraft+ workbenches. | Everyone |
nearbycraftplus.workbench.bypass.owner |
Allows bypassing NearbyCraft+ workbench owner protection. | OP |
nearbycraftplus.storage.use |
Allows NearbyCraft+ to use nearby storage. | Everyone |
nearbycraftplus.protection.bypass |
Allows bypassing container protection checks. | Disabled by default |
The default scan radius is 10.
The maximum scan radius is 50.
NearbyCraft+ technically supports every radius permission from 1 up to the configured maximum radius.
Examples:
/lp user Fedex permission set nearbycraftplus.radius.14 true/lp user Fedex permission set nearbycraftplus.radius.32 true/lp user Fedex permission set nearbycraftplus.radius.50 true- Groups work's too
/lp group VIP permission set nearbycraftplus.radius.50 true
Workbench Ownership & Trust System
When a player places a NearbyCraft+ workbench, that player becomes the owner of the workbench.
If owner protection is enabled, only the owner and trusted players can use that placed workbench.
Owners can trust other players with:
/ncp trust <player>
They can remove trusted players with:
/ncp untrust <player>
They can view trusted players with:
/ncp trustlist
This system can also be disabled in the configuration if you want all placed NearbyCraft+ workbenches to be usable by everyone.
Config option:
workbench:
owner-protection: true
trust:
enabled: true
max-trusted-players: 10
Protection Hooks & Compatibility
NearbyCraft+ includes protection checks before using nearby storage containers.
This means the plugin only counts and scans containers that the player is actually allowed to access.
SimpleClaimSystem Support
NearbyCraft+ has optional support for SimpleClaimSystem.
If a nearby chest is inside another player's claim and the player has no access to it, NearbyCraft+ will not scan or count the items inside that chest.
This is very important for survival servers because players should never be able to craft using items from protected containers they do not own or cannot access.
WorldGuard Support
NearbyCraft+ can also use WorldGuard protection checks when enabled in the configuration.
This allows NearbyCraft+ to respect protected regions and container access rules.
JustLootIt Support
NearbyCraft+ is designed to ignore JustLootIt loot containers.
JustLootIt chests and other loot/plugin containers are filtered through plugin data and loot table checks, so they are not used as normal storage for NearbyCraft+ crafting.
Loot & Plugin Container Protection
NearbyCraft+ can ignore containers with:
- plugin block data
- custom container data
- loot tables
- JustLootIt loot containers
This protects dungeon chests, loot chests, event chests, and other plugin-managed containers from being used as storage.
Soft Dependencies
NearbyCraft+ can hook into the following plugins:
| Plugin | Type | Description |
|---|---|---|
| SimpleClaimSystem | Softdepend | Prevents NearbyCraft+ from scanning containers inside claims where the player has no access. |
| WorldGuard | Softdepend | Optional region/container protection support. |
| JustLootIt | Softdepend | Prevents loot containers from being used as NearbyCraft+ storage. |
These plugins are not required to run NearbyCraft+, but they are supported when installed.
Configuration
Click to show default config.yml
file-version: 2
settings:
# Enables or disables the main NearbyCraft+ functionality.
# DE: Aktiviert oder deaktiviert die Hauptfunktionen von NearbyCraft+.
enabled: true
# Allows NearbyCraft+ to use nearby storage containers.
# DE: Erlaubt NearbyCraft+, nahe Lager-Container zu verwenden.
use-nearby-containers: true
# Container types that NearbyCraft+ may detect as storage.
# Access protection is checked separately.
# DE: Container-Typen, die NearbyCraft+ grundsätzlich als Lager erkennen darf.
allowed-containers:
- CHEST
- TRAPPED_CHEST
- BARREL
- SHULKER_BOX
# If true, recipes may only use plain, unmodified items.
# This protects custom items with names, lore, CustomModelData or PDC data.
# DE: Wenn true, dürfen Rezepte nur echte unveränderte Items verwenden.
require-plain-vanilla-items: true
language:
# Default plugin language.
# Available: de, en, es, fr, it
# DE: Standardsprache des Plugins.
default: "en"
# Available languages.
# DE: Verfügbare Sprachen.
available:
- de
- en
- es
- fr
- it
# If true, every player may choose their own GUI/message language.
# The choice will be saved in preferences.yml.
# If false, everyone uses the global default language above.
# DE: Wenn true, kann jeder Spieler seine eigene Sprache wählen.
allow-player-language: true
# Fallback language if a key is missing in the selected language file.
# DE: Ersatzsprache, falls ein Text in einer Sprache fehlt.
fallback: "en"
radius:
# Default radius for normal players.
# DE: Standard-Radius für normale Spieler.
default: 10
# Radius for OPs and players with nearbycraftplus.admin.
# This is intentionally lower than the hard maximum.
# DE: Radius für OPs und Spieler mit nearbycraftplus.admin.
# Dieser Wert ist absichtlich niedriger als das harte Maximum.
admin: 24
# Optional dynamic radius permission:
# nearbycraftplus.radius.<amount>
# Example: nearbycraftplus.radius.37
#
# DE: Optionale dynamische Radius-Permission:
# nearbycraftplus.radius.<zahl>
# Beispiel: nearbycraftplus.radius.37
# Hard maximum radius NearbyCraft+ can use.
#
# ATTENTION:
# High radius values can increase scan cost when players build very large
# storage rooms with many chests, barrels or shulker boxes in range.
# Radius 50 is possible because NearbyCraft+ uses container-only scanning
# and the StorageSnapshot system, but it should still be used with care.
#
# DE ACHTUNG:
# Hohe Radius-Werte können mehr Scan-Aufwand erzeugen, wenn Spieler sehr große
# Lagerhallen mit vielen Kisten, Fässern oder Shulkerboxen im Radius bauen.
# Radius 50 ist durch Container-only Scanning und das StorageSnapshot-System möglich,
# sollte aber trotzdem bewusst verwendet werden.
max: 50
protection:
# Enables protection checks before NearbyCraft+ uses a storage container.
# If enabled, NearbyCraft+ will only use containers the player is allowed to access.
# DE: Aktiviert Schutzprüfungen, bevor NearbyCraft+ einen Lager-Container verwendet.
enabled: true
# If a protection hook cannot safely check access, deny the container.
# Recommended for economy/survival servers.
# DE: Wenn ein Schutz-Hook nicht sicher prüfen kann, wird der Container blockiert.
fail-safe-deny: true
# If true, containers with custom block data are ignored.
# This protects loot/plugin containers from being used as storage.
# DE: Wenn true, werden Container mit Plugin-Daten am Block ignoriert.
block-containers-with-pdc: true
# If true, containers with a loot table are ignored.
# This protects dungeon/loot/plugin containers from being used as storage.
# DE: Wenn true, werden Container mit LootTable ignoriert.
block-containers-with-loot-table: true
hooks:
# Optional hook for WorldGuard.
# DE: Optionaler Hook für WorldGuard.
worldguard: true
# Optional hook for SimpleClaimSystem.
# DE: Optionaler Hook für SimpleClaimSystem.
simple-claim-system: true
# Optional hook for JustLootIt loot containers.
# NearbyCraft+ should never use loot containers as storage.
# DE: JustLootIt-Lootkisten sollen nie als Lager verwendet werden.
justlootit: true
performance:
# Maximum amount of containers scanned per crafting session.
# Prevents huge storage rooms from causing lag.
# DE: Maximale Anzahl Container pro Scan.
max-containers-per-scan: 150
# Additional safety limit for scanned inventory slots.
# DE: Zusätzliche Sicherheitsgrenze für Inventar-Slots.
max-slots-per-scan: 8100
craft-success-feedback:
# Shows a small success feedback after crafting through NearbyCraft+.
# Recommended: false to avoid chat spam.
# DE: Zeigt eine kleine Erfolgsmeldung nach dem Craften über NearbyCraft+.
# Empfehlung: false, damit der Chat nicht zugespammt wird.
enabled: false
# Available modes: CHAT, ACTION_BAR
# CHAT sends the message into the chat.
# ACTION_BAR shows it above the hotbar.
# DE: Verfügbare Modi: CHAT, ACTION_BAR
# CHAT sendet die Nachricht in den Chat.
# ACTION_BAR zeigt sie über der Hotbar.
mode: ACTION_BAR
# Cooldown per player in milliseconds.
# Prevents spam when players craft many items quickly.
# DE: Cooldown pro Spieler in Millisekunden.
# Verhindert Spam, wenn Spieler sehr schnell viele Items craften.
cooldown-ms: 1200
workbench:
# Display name of the special NearbyCraft+ workbench.
# DE: Anzeigename der speziellen NearbyCraft+ Werkbank.
display-name: "<gold>NearbyCraft+ Workbench"
# Lore of the special workbench item.
# DE: Beschreibung des Werkbank-Items.
lore:
- "<gray>Craft with nearby storage containers."
- "<dark_gray>NearbyCraft+"
# Material of the special workbench item.
# It can use the same material as a vanilla crafting table because NearbyCraft+
# marks the item internally with a hidden data tag.
# DE: Kann das gleiche Material wie eine normale Werkbank nutzen,
# weil NearbyCraft+ das Item intern unsichtbar markiert.
material: CRAFTING_TABLE
recipe:
# Enables or disables the fixed crafting recipe for the NearbyCraft+ workbench.
# Recipe shape:
# E C E
# C W C
# E C E
#
# E = ENDER_EYE
# C = CHEST
# W = CRAFTING_TABLE
#
# DE: Aktiviert oder deaktiviert das feste Crafting-Rezept
# für die NearbyCraft+ Werkbank.
enabled: true
# Whether the special workbench can be placed as a block.
# DE: Ob die spezielle Werkbank platziert werden darf.
placeable: true
# If true, only the owner and trusted players can use a placed NearbyCraft+ workbench.
# If false, everyone can use placed NearbyCraft+ workbenches.
# DE: Wenn true, können nur Besitzer und vertraute Spieler die platzierte Werkbank benutzen.
# DE: Wenn false, kann jeder platzierte NearbyCraft+ Werkbänke benutzen.
owner-protection: true
trust:
# Allows owners to trust other players for their own workbench.
# DE: Erlaubt Besitzern, andere Spieler für ihre eigene Werkbank freizuschalten.
enabled: true
# Maximum trusted players per workbench.
# DE: Maximale Anzahl vertrauter Spieler pro Werkbank.
max-trusted-players: 10
gui:
# Default category click mode.
# QUICK = category button cycles through categories.
# PAGE = category button opens a separate category selection page.
# DE: Standard-Kategorie-Modus.
# QUICK = Kategorie-Button schaltet Kategorien durch.
# PAGE = Kategorie-Button öffnet eine eigene Kategorie-Auswahl.
default-category-click-mode: "QUICK"
# If true, players may switch their own category mode in the GUI.
# The choice will be saved in preferences.yml.
# DE: Wenn true, können Spieler ihren eigenen Kategorie-Modus im GUI umstellen.
allow-player-category-mode: true
# Enables the recipe search system in the workbench GUI.
# DE: Aktiviert die Rezept-Suche im Werkbank-GUI.
search-enabled: true
# Minimum characters required before search filters recipes.
# DE: Mindestanzahl Zeichen, bevor die Suche Rezepte filtert.
search-min-length: 1
# If true, the search also checks recipe material names.
# Example: searching "diamond" can show diamond sword, diamond axe, etc.
# DE: Wenn true, sucht die Suche auch in Materialnamen.
search-material-names: true
# If true, the language button is shown in the GUI.
# DE: Wenn true, wird der Sprach-Button im GUI angezeigt.
show-language-button: true
recipe-browser:
# Only show recipes that are currently craftable with nearby storage.
# This is the core NearbyCraft+ behavior.
# DE: Zeigt nur Rezepte an, die mit den nahen Lagern aktuell craftbar sind.
only-show-craftable: true
# Shows how many times an item can be crafted in the recipe lore.
# DE: Zeigt in der Lore an, wie oft ein Item gecraftet werden kann.
show-craftable-amount: true
# Sort recipes alphabetically by item name.
# DE: Sortiert Rezepte alphabetisch nach Itemnamen.
sort-by-name: true
update-checker:
# Enables the Modrinth update checker.
# DE: Aktiviert den Modrinth Update-Checker.
enabled: true
# Prints update messages to the console.
# DE: Gibt Update-Meldungen in der Konsole aus.
notify-console: true
# Sends update messages to online admins.
# DE: Sendet Update-Meldungen an Admins, die online sind.
notify-admins: true
debug:
# Prints blocked plugin containers to the console.
# DE: Gibt blockierte Plugin-Container in der Console aus.
protection: false
# Enables recipe debug commands and detailed recipe reports.
# Recommended: false on live servers.
# DE: Aktiviert Rezept-Debug-Befehle und detaillierte Rezeptberichte.
recipes: false
Showcase
Categories
Shows the available categories in the menu.

Menu / Interface Overview
Shows the menu navigation, buttons, and the display of scanned chests, items, and other useful information.

Quick Category Function
Demonstrates how quickly categories can be switched using left and right click.

Recipe Preview
This is one of the main highlights of NearbyCraft+.
The recipe preview clearly shows:
- how many items are required
- how many are available
- how many times the recipe can be crafted
Animated Preview

Recipe Preview Image

Page Navigation
Shows browsing forward and backward through the ALL category.

Search Function
Shows the search feature in action.
A player can type something like axe into chat, and the workbench reopens with an active filter showing matching materials.
The search filter can be disabled again by right-clicking the search button.

Final Words
I created NearbyCraft+ to bring a feature I really like from modded gameplay into the Paper server world.
If you want a more comfortable crafting experience, smoother storage interaction, and a real quality-of-life upgrade for your players, NearbyCraft+ is made exactly for that.


