# NearbyCraft+<\/p>\n
<\/p>\n
**NearbyCraft+ is my Paper plugin that brings the well-known CraftFromContainers experience to Paper servers \u2014 fully server-side and without requiring any client-side mods.**<\/p>\n
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.<\/p>\n
—<\/p>\n
## Why NearbyCraft+?<\/p>\n
If you know the CraftFromContainers feeling from modded gameplay, this plugin is basically my Paper-server answer to it.<\/p>\n
With NearbyCraft+ your players can:<\/p>\n
– craft with materials from nearby chests
\n– see exactly what they need and what they already have
\n– browse items by categories
\n– switch quickly through categories
\n– search for materials directly from the menu
\n– enjoy the whole system **without installing a client-side mod**<\/p>\n
That makes it perfect for:<\/p>\n
– survival servers
\n– SMPs
\n– building-focused servers
\n– storage-heavy bases
\n– quality-of-life server setups<\/p>\n
—<\/p>\n
## Highlights<\/p>\n
### Craft directly from nearby containers<\/p>\n
NearbyCraft+ scans nearby chests and lets players use those materials directly at the workbench.<\/p>\n
No more constant back-and-forth between storage and crafting table.<\/p>\n
### Smart recipe preview<\/p>\n
One of the biggest highlights of NearbyCraft+ is the recipe preview system.<\/p>\n
Players can instantly see:<\/p>\n
– how many items are **needed**
\n– how many are **available**
\n– how often the recipe is **craftable**<\/p>\n
This gives a very clear overview and makes crafting much more comfortable.<\/p>\n
### Categories and quick navigation<\/p>\n
Recipes and items can be browsed through organized categories.<\/p>\n
There is also a **quick category switch** for fast navigation with left and right click.<\/p>\n
### Search and filter system<\/p>\n
Players can use the search function to filter items by material name.<\/p>\n
For example, typing `axe` will show all matching materials\/items.<\/p>\n
The filter can be removed again with a simple right click.<\/p>\n
### Protection hook support<\/p>\n
NearbyCraft+ respects container protection.<\/p>\n
If a player is not allowed to access a nearby container, NearbyCraft+ will not scan it and will not count the items inside it.<\/p>\n
This is especially important for protected claims and survival servers.
\n—<\/p>\n
## Feature Overview<\/p>\n
– CraftFromContainers-style crafting for Paper servers
\n– Craft with items from nearby chests
\n– Recipe preview with needed \/ available \/ craftable counts
\n– Category-based browsing
\n– Quick category switching
\n– Search function with chat input
\n– Easy filter reset
\n– Paginated browsing
\n– Clean menu layout
\n– Scan statistics in the interface
\n– Configurable scan range for nearby containers
\n– Workbench owner protection
\n– Trust system for placed workbenches
\n– SimpleClaimSystem support
\n– WorldGuard support
\n– JustLootIt protection
\n– Loot table and plugin-container filtering<\/p>\n
—<\/p>\n
## Commands<\/p>\n
Main command:<\/p>\n
– `\/nearbycraftplus`
\n– `\/ncp`
\n– `\/nearbycraft`<\/p>\n
| Command | Description | Permission | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | The default scan radius is `10`.<\/p>\n The maximum scan radius is `50`.<\/p>\n NearbyCraft+ technically supports every radius permission from `1` up to the configured maximum radius.<\/p>\n Examples: —<\/p>\n ## Workbench Ownership & Trust System<\/p>\n When a player places a NearbyCraft+ workbench, that player becomes the owner of the workbench.<\/p>\n If owner protection is enabled, only the owner and trusted players can use that placed workbench.<\/p>\n Owners can trust other players with:<\/p>\n “`text They can remove trusted players with:<\/p>\n “`text They can view trusted players with:<\/p>\n “`text This system can also be disabled in the configuration if you want all placed NearbyCraft+ workbenches to be usable by everyone.<\/p>\n Config option:<\/p>\n “`yaml trust: —<\/p>\n ## Protection Hooks & Compatibility<\/p>\n NearbyCraft+ includes protection checks before using nearby storage containers.<\/p>\n This means the plugin only counts and scans containers that the player is actually allowed to access.<\/p>\n ### SimpleClaimSystem Support<\/p>\n NearbyCraft+ has optional support for **SimpleClaimSystem**.<\/p>\n 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.<\/p>\n 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.<\/p>\n ### WorldGuard Support<\/p>\n NearbyCraft+ can also use WorldGuard protection checks when enabled in the configuration.<\/p>\n This allows NearbyCraft+ to respect protected regions and container access rules.<\/p>\n ### JustLootIt Support<\/p>\n NearbyCraft+ is designed to ignore JustLootIt loot containers.<\/p>\n 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.<\/p>\n ### Loot & Plugin Container Protection<\/p>\n NearbyCraft+ can ignore containers with:<\/p>\n – plugin block data This protects dungeon chests, loot chests, event chests, and other plugin-managed containers from being used as storage.<\/p>\n —<\/p>\n ## Soft Dependencies<\/p>\n NearbyCraft+ can hook into the following plugins:<\/p>\n | Plugin | Type | Description | These plugins are not required to run NearbyCraft+, but they are supported when installed.<\/p>\n —<\/p>\n ## Configuration<\/p>\n “`yaml settings: # Allows NearbyCraft+ to use nearby storage containers. # Container types that NearbyCraft+ may detect as storage. # If true, recipes may only use plain, unmodified items. language: # Available languages. # If true, every player may choose their own GUI\/message language. # Fallback language if a key is missing in the selected language file. radius: # Radius for OPs and players with nearbycraftplus.admin. # Optional dynamic radius permission: # Hard maximum radius NearbyCraft+ can use. protection: # If a protection hook cannot safely check access, deny the container. # If true, containers with custom block data are ignored. # If true, containers with a loot table are ignored. hooks: # Optional hook for SimpleClaimSystem. # Optional hook for JustLootIt loot containers. performance: # Additional safety limit for scanned inventory slots. craft-success-feedback: # Available modes: CHAT, ACTION_BAR # Cooldown per player in milliseconds. workbench: # Lore of the special workbench item. # Material of the special workbench item. recipe: # Whether the special workbench can be placed as a block. # If true, only the owner and trusted players can use a placed NearbyCraft+ workbench. trust: # Maximum trusted players per workbench. gui: # If true, players may switch their own category mode in the GUI. # Enables the recipe search system in the workbench GUI. # Minimum characters required before search filters recipes. # If true, the search also checks recipe material names. # If true, the language button is shown in the GUI. recipe-browser: # Shows how many times an item can be crafted in the recipe lore. # Sort recipes alphabetically by item name. update-checker: # Prints update messages to the console. # Sends update messages to online admins. debug: # Enables recipe debug commands and detailed recipe reports. —<\/p>\n ## Showcase<\/p>\n ### Categories<\/p>\n Shows the available categories in the menu.<\/p>\n <\/p>\n —<\/p>\n ### Menu \/ Interface Overview<\/p>\n Shows the menu navigation, buttons, and the display of scanned chests, items, and other useful information.<\/p>\n <\/p>\n —<\/p>\n ### Quick Category Function<\/p>\n Demonstrates how quickly categories can be switched using left and right click.<\/p>\n <\/p>\n —<\/p>\n ### Recipe Preview<\/p>\n This is one of the main highlights of NearbyCraft+.<\/p>\n The recipe preview clearly shows:<\/p>\n – how many items are required #### Animated Preview<\/p>\n <\/p>\n #### Recipe Preview Image<\/p>\n <\/p>\n —<\/p>\n ### Page Navigation<\/p>\n Shows browsing forward and backward through the **ALL** category.<\/p>\n <\/p>\n —<\/p>\n ### Search Function<\/p>\n Shows the search feature in action.<\/p>\n A player can type something like `axe` into chat, and the workbench reopens with an active filter showing matching materials.<\/p>\n The search filter can be disabled again by right-clicking the search button.<\/p>\n <\/p>\n —<\/p>\n ## Final Words<\/p>\n I created NearbyCraft+ to bring a feature I really like from modded gameplay into the Paper server world.<\/p>\n 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.<\/p>\n","protected":false},"excerpt":{"rendered":" NearbyCraft+ brings CraftFromContainers-style crafting to Paper Servers \u2014 Use items from nearby chests directly at the workbench, without requiring any client-side mods.<\/p>\n","protected":false},"featured_media":109215,"template":"","meta":{"_minecraft_slug":"nearbycraft+","_minecraft_project_id":"QGZXJV97","_minecraft_author":"Fedex1991","_minecraft_license":"MIT","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nearbycraft+.zip","_minecraft_size_bytes":490740,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T23:06:55.272225Z","_minecraft_date_created":"2026-05-12T00:11:40.649790Z","_minecraft_date_modified":"2026-05-10T16:54:26.588406Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nearbycraft+","_minecraft_icon_attachment_id":109215,"_minecraft_imported_at":"2026-06-06T10:08:58+00:00","_minecraft_import_hash":"cd30d65be822f112c68c2a6ff5047907","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,91,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-109214","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|—|
\n| `\/ncp reload` | Reloads the NearbyCraft+ configuration and language files. | `nearbycraftplus.command.reload` |
\n| `\/ncp scan` | Runs the scan debug command. | `nearbycraftplus.command.scan` |
\n| `\/ncp recipereport` | Creates a recipe report. | `nearbycraftplus.command.recipereport` |
\n| `\/ncp recipereport full` | Creates a full detailed recipe report. | `nearbycraftplus.command.recipereport` |
\n| `\/ncp give
\n| `\/ncp trust
\n| `\/ncp untrust
\n| `\/ncp trustlist` | Shows all trusted players for your workbench. | `nearbycraftplus.workbench.trustlist` |<\/p>\n
\n|—|—|—|
\n| `nearbycraftplus.admin` | Grants access to all NearbyCraft+ admin features. | OP |
\n| `nearbycraftplus.command.recipereport` | Allows running the NearbyCraft+ recipe report command. | OP |
\n| `nearbycraftplus.command.reload` | Allows reloading NearbyCraft+. | OP |
\n| `nearbycraftplus.command.scan` | Allows using the scan debug command. | OP |
\n| `nearbycraftplus.command.give` | Allows giving NearbyCraft+ workbenches. | OP |
\n| `nearbycraftplus.update` | Allows receiving NearbyCraft+ update notifications. | OP |
\n| `nearbycraftplus.workbench.use` | Allows using the NearbyCraft+ workbench. | Everyone |
\n| `nearbycraftplus.workbench.place` | Allows placing the NearbyCraft+ workbench. | Everyone |
\n| `nearbycraftplus.workbench.break` | Allows breaking the NearbyCraft+ workbench. | Everyone |
\n| `nearbycraftplus.workbench.craft` | Allows crafting inside the NearbyCraft+ workbench. | Everyone |
\n| `nearbycraftplus.workbench.trust` | Allows trusting players for owned NearbyCraft+ workbenches. | Everyone |
\n| `nearbycraftplus.workbench.untrust` | Allows removing trusted players from owned NearbyCraft+ workbenches. | Everyone |
\n| `nearbycraftplus.workbench.trustlist` | Allows viewing trusted players of owned NearbyCraft+ workbenches. | Everyone |
\n| `nearbycraftplus.workbench.bypass.owner` | Allows bypassing NearbyCraft+ workbench owner protection. | OP |
\n| `nearbycraftplus.storage.use` | Allows NearbyCraft+ to use nearby storage. | Everyone |
\n| `nearbycraftplus.protection.bypass` | Allows bypassing container protection checks. | Disabled by default<\/p>\n
\n– “\/lp user Fedex permission set nearbycraftplus.radius.14 true“
\n– “\/lp user Fedex permission set nearbycraftplus.radius.32 true“
\n– “\/lp user Fedex permission set nearbycraftplus.radius.50 true“
\n– Groups work’s too
\n– “\/lp group VIP permission set nearbycraftplus.radius.50 true“<\/p>\n
\n\/ncp trust
\n\/ncp untrust
\n\/ncp trustlist
\n“`<\/p>\n
\nworkbench:
\n owner-protection: true<\/p>\n
\n enabled: true
\n max-trusted-players: 10
\n“`<\/p>\n
\n– custom container data
\n– loot tables
\n– JustLootIt loot containers<\/p>\n
\n|—|—|—|
\n| SimpleClaimSystem | Softdepend | Prevents NearbyCraft+ from scanning containers inside claims where the player has no access. |
\n| WorldGuard | Softdepend | Optional region\/container protection support. |
\n| JustLootIt | Softdepend | Prevents loot containers from being used as NearbyCraft+ storage. |<\/p>\nClick to show default config.yml<\/summary>\n
\nfile-version: 2<\/p>\n
\n # Enables or disables the main NearbyCraft+ functionality.
\n # DE: Aktiviert oder deaktiviert die Hauptfunktionen von NearbyCraft+.
\n enabled: true<\/p>\n
\n # DE: Erlaubt NearbyCraft+, nahe Lager-Container zu verwenden.
\n use-nearby-containers: true<\/p>\n
\n # Access protection is checked separately.
\n # DE: Container-Typen, die NearbyCraft+ grunds\u00e4tzlich als Lager erkennen darf.
\n allowed-containers:
\n – CHEST
\n – TRAPPED_CHEST
\n – BARREL
\n – SHULKER_BOX<\/p>\n
\n # This protects custom items with names, lore, CustomModelData or PDC data.
\n # DE: Wenn true, d\u00fcrfen Rezepte nur echte unver\u00e4nderte Items verwenden.
\n require-plain-vanilla-items: true<\/p>\n
\n # Default plugin language.
\n # Available: de, en, es, fr, it
\n # DE: Standardsprache des Plugins.
\n default: “en”<\/p>\n
\n # DE: Verf\u00fcgbare Sprachen.
\n available:
\n – de
\n – en
\n – es
\n – fr
\n – it<\/p>\n
\n # The choice will be saved in preferences.yml.
\n # If false, everyone uses the global default language above.
\n # DE: Wenn true, kann jeder Spieler seine eigene Sprache w\u00e4hlen.
\n allow-player-language: true<\/p>\n
\n # DE: Ersatzsprache, falls ein Text in einer Sprache fehlt.
\n fallback: “en”<\/p>\n
\n # Default radius for normal players.
\n # DE: Standard-Radius f\u00fcr normale Spieler.
\n default: 10<\/p>\n
\n # This is intentionally lower than the hard maximum.
\n # DE: Radius f\u00fcr OPs und Spieler mit nearbycraftplus.admin.
\n # Dieser Wert ist absichtlich niedriger als das harte Maximum.
\n admin: 24<\/p>\n
\n # nearbycraftplus.radius.
\n # Example: nearbycraftplus.radius.37
\n #
\n # DE: Optionale dynamische Radius-Permission:
\n # nearbycraftplus.radius.
\n # Beispiel: nearbycraftplus.radius.37<\/p>\n
\n #
\n # ATTENTION:
\n # High radius values can increase scan cost when players build very large
\n # storage rooms with many chests, barrels or shulker boxes in range.
\n # Radius 50 is possible because NearbyCraft+ uses container-only scanning
\n # and the StorageSnapshot system, but it should still be used with care.
\n #
\n # DE ACHTUNG:
\n # Hohe Radius-Werte k\u00f6nnen mehr Scan-Aufwand erzeugen, wenn Spieler sehr gro\u00dfe
\n # Lagerhallen mit vielen Kisten, F\u00e4ssern oder Shulkerboxen im Radius bauen.
\n # Radius 50 ist durch Container-only Scanning und das StorageSnapshot-System m\u00f6glich,
\n # sollte aber trotzdem bewusst verwendet werden.
\n max: 50<\/p>\n
\n # Enables protection checks before NearbyCraft+ uses a storage container.
\n # If enabled, NearbyCraft+ will only use containers the player is allowed to access.
\n # DE: Aktiviert Schutzpr\u00fcfungen, bevor NearbyCraft+ einen Lager-Container verwendet.
\n enabled: true<\/p>\n
\n # Recommended for economy\/survival servers.
\n # DE: Wenn ein Schutz-Hook nicht sicher pr\u00fcfen kann, wird der Container blockiert.
\n fail-safe-deny: true<\/p>\n
\n # This protects loot\/plugin containers from being used as storage.
\n # DE: Wenn true, werden Container mit Plugin-Daten am Block ignoriert.
\n block-containers-with-pdc: true<\/p>\n
\n # This protects dungeon\/loot\/plugin containers from being used as storage.
\n # DE: Wenn true, werden Container mit LootTable ignoriert.
\n block-containers-with-loot-table: true<\/p>\n
\n # Optional hook for WorldGuard.
\n # DE: Optionaler Hook f\u00fcr WorldGuard.
\n worldguard: true<\/p>\n
\n # DE: Optionaler Hook f\u00fcr SimpleClaimSystem.
\n simple-claim-system: true<\/p>\n
\n # NearbyCraft+ should never use loot containers as storage.
\n # DE: JustLootIt-Lootkisten sollen nie als Lager verwendet werden.
\n justlootit: true<\/p>\n
\n # Maximum amount of containers scanned per crafting session.
\n # Prevents huge storage rooms from causing lag.
\n # DE: Maximale Anzahl Container pro Scan.
\n max-containers-per-scan: 150<\/p>\n
\n # DE: Zus\u00e4tzliche Sicherheitsgrenze f\u00fcr Inventar-Slots.
\n max-slots-per-scan: 8100<\/p>\n
\n # Shows a small success feedback after crafting through NearbyCraft+.
\n # Recommended: false to avoid chat spam.
\n # DE: Zeigt eine kleine Erfolgsmeldung nach dem Craften \u00fcber NearbyCraft+.
\n # Empfehlung: false, damit der Chat nicht zugespammt wird.
\n enabled: false<\/p>\n
\n # CHAT sends the message into the chat.
\n # ACTION_BAR shows it above the hotbar.
\n # DE: Verf\u00fcgbare Modi: CHAT, ACTION_BAR
\n # CHAT sendet die Nachricht in den Chat.
\n # ACTION_BAR zeigt sie \u00fcber der Hotbar.
\n mode: ACTION_BAR<\/p>\n
\n # Prevents spam when players craft many items quickly.
\n # DE: Cooldown pro Spieler in Millisekunden.
\n # Verhindert Spam, wenn Spieler sehr schnell viele Items craften.
\n cooldown-ms: 1200<\/p>\n
\n # Display name of the special NearbyCraft+ workbench.
\n # DE: Anzeigename der speziellen NearbyCraft+ Werkbank.
\n display-name: “
\n # DE: Beschreibung des Werkbank-Items.
\n lore:
\n – “
\n – “
\n # It can use the same material as a vanilla crafting table because NearbyCraft+
\n # marks the item internally with a hidden data tag.
\n # DE: Kann das gleiche Material wie eine normale Werkbank nutzen,
\n # weil NearbyCraft+ das Item intern unsichtbar markiert.
\n material: CRAFTING_TABLE<\/p>\n
\n # Enables or disables the fixed crafting recipe for the NearbyCraft+ workbench.
\n # Recipe shape:
\n # E C E
\n # C W C
\n # E C E
\n #
\n # E = ENDER_EYE
\n # C = CHEST
\n # W = CRAFTING_TABLE
\n #
\n # DE: Aktiviert oder deaktiviert das feste Crafting-Rezept
\n # f\u00fcr die NearbyCraft+ Werkbank.
\n enabled: true<\/p>\n
\n # DE: Ob die spezielle Werkbank platziert werden darf.
\n placeable: true<\/p>\n
\n # If false, everyone can use placed NearbyCraft+ workbenches.
\n # DE: Wenn true, k\u00f6nnen nur Besitzer und vertraute Spieler die platzierte Werkbank benutzen.
\n # DE: Wenn false, kann jeder platzierte NearbyCraft+ Werkb\u00e4nke benutzen.
\n owner-protection: true<\/p>\n
\n # Allows owners to trust other players for their own workbench.
\n # DE: Erlaubt Besitzern, andere Spieler f\u00fcr ihre eigene Werkbank freizuschalten.
\n enabled: true<\/p>\n
\n # DE: Maximale Anzahl vertrauter Spieler pro Werkbank.
\n max-trusted-players: 10<\/p>\n
\n # Default category click mode.
\n # QUICK = category button cycles through categories.
\n # PAGE = category button opens a separate category selection page.
\n # DE: Standard-Kategorie-Modus.
\n # QUICK = Kategorie-Button schaltet Kategorien durch.
\n # PAGE = Kategorie-Button \u00f6ffnet eine eigene Kategorie-Auswahl.
\n default-category-click-mode: “QUICK”<\/p>\n
\n # The choice will be saved in preferences.yml.
\n # DE: Wenn true, k\u00f6nnen Spieler ihren eigenen Kategorie-Modus im GUI umstellen.
\n allow-player-category-mode: true<\/p>\n
\n # DE: Aktiviert die Rezept-Suche im Werkbank-GUI.
\n search-enabled: true<\/p>\n
\n # DE: Mindestanzahl Zeichen, bevor die Suche Rezepte filtert.
\n search-min-length: 1<\/p>\n
\n # Example: searching “diamond” can show diamond sword, diamond axe, etc.
\n # DE: Wenn true, sucht die Suche auch in Materialnamen.
\n search-material-names: true<\/p>\n
\n # DE: Wenn true, wird der Sprach-Button im GUI angezeigt.
\n show-language-button: true<\/p>\n
\n # Only show recipes that are currently craftable with nearby storage.
\n # This is the core NearbyCraft+ behavior.
\n # DE: Zeigt nur Rezepte an, die mit den nahen Lagern aktuell craftbar sind.
\n only-show-craftable: true<\/p>\n
\n # DE: Zeigt in der Lore an, wie oft ein Item gecraftet werden kann.
\n show-craftable-amount: true<\/p>\n
\n # DE: Sortiert Rezepte alphabetisch nach Itemnamen.
\n sort-by-name: true<\/p>\n
\n # Enables the Modrinth update checker.
\n # DE: Aktiviert den Modrinth Update-Checker.
\n enabled: true<\/p>\n
\n # DE: Gibt Update-Meldungen in der Konsole aus.
\n notify-console: true<\/p>\n
\n # DE: Sendet Update-Meldungen an Admins, die online sind.
\n notify-admins: true<\/p>\n
\n # Prints blocked plugin containers to the console.
\n # DE: Gibt blockierte Plugin-Container in der Console aus.
\n protection: false<\/p>\n
\n # Recommended: false on live servers.
\n # DE: Aktiviert Rezept-Debug-Befehle und detaillierte Rezeptberichte.
\n recipes: false
\n“`<\/p>\n<\/details>\n
\n– how many are available
\n– how many times the recipe can be crafted<\/p>\n