NearbyCraft+

插件

· 作者 Fedex1991

NearbyCraft+ 将 CraftFromContainers 风格的合成机制引入 Paper 服务器——玩家可以直接在工作台中使用附近箱子中的物品,无需安装任何客户端模组。

0 本站下载 0 关注 更新于 5 个月前

最新 1.2.5 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

NearbyCraft+

NearbyCraft+ 预览

NearbyCraft+ 是一款 Paper 插件,它将广受欢迎的 CraftFromContainers 体验带入了 Paper 服务器——完全在服务端运行,且无需安装任何客户端模组。

玩家不再需要一个个打开箱子并手动收集材料,而是可以使用工作台,直接从附近的容器中选取物品进行合成。我开发 NearbyCraft+ 的目标是,以简洁、快速且直观的方式,将这种类似模组的舒适合成体验带给 Paper 服务器。


为什么选择 NearbyCraft+?

如果你熟悉模组玩法中 CraftFromContainers 带来的便利,那么这个插件基本上就是我为 Paper 服务器提供的解决方案。

通过 NearbyCraft+,你的玩家可以:

  • 使用附近箱子中的材料进行合成
  • 清楚地看到所需材料与已有材料
  • 按类别浏览物品
  • 快速切换类别
  • 直接从菜单中搜索材料
  • 无需安装客户端模组即可享受整个系统

这使得它非常适合以下类型的服务器:

  • 生存服务器
  • SMP(多人生存)服务器
  • 建筑向服务器
  • 存储密集的基地
  • 注重生活质量的服务器配置

亮点

直接从附近容器合成

NearbyCraft+ 会扫描附近的箱子,让玩家可以直接在工作台使用这些材料进行合成。

再也不用在储物间和合成台之间来回奔波了。

智能配方预览

NearbyCraft+ 的一大亮点是其配方预览系统。

玩家可以立即看到:

  • 需要多少物品
  • 现有多少物品
  • 该配方可以合成多少次

这提供了非常清晰的概览,使合成变得更加轻松便捷。

分类与快速导航

配方和物品可以通过分类进行浏览。

还支持快速类别切换,通过左右键实现快速导航。

搜索与过滤系统

玩家可以使用搜索功能,按材料名称筛选物品。

例如,输入 axe 将显示所有匹配的材料/物品。

只需右键点击即可移除过滤器。

保护钩子支持

NearbyCraft+ 尊重容器保护机制。

如果玩家无权访问附近的容器,NearbyCraft+ 将不会扫描该容器,也不会计算其中的物品。

这对于受保护的领地(claims)和生存服务器尤为重要。


功能概览

  • 适用于 Paper 服务器的 CraftFromContainers 风格合成
  • 使用附近箱子中的物品进行合成
  • 配方预览显示所需/可用/可合成数量
  • 基于分类的浏览功能
  • 快速类别切换
  • 聊天输入框支持的搜索功能
  • 简单的过滤器重置
  • 分页浏览
  • 整洁的菜单布局
  • 界面中的扫描统计信息
  • 可配置的附近容器扫描范围
  • 工作台所有者保护
  • 已放置工作台的信任系统
  • SimpleClaimSystem 支持
  • WorldGuard 支持
  • JustLootIt 保护支持
  • 战利品表与插件容器过滤

命令

主命令:

  • /nearbycraftplus
  • /ncp
  • /nearbycraft
命令 描述 权限
/ncp reload 重新加载 NearbyCraft+ 配置文件和语言文件。 nearbycraftplus.command.reload
/ncp scan 运行扫描调试命令。 nearbycraftplus.command.scan
/ncp recipereport 生成配方报告。 nearbycraftplus.command.recipereport
/ncp recipereport full 生成完整的详细配方报告。 nearbycraftplus.command.recipereport
/ncp give <player> [amount] 给予玩家 NearbyCraft+ 工作台。 nearbycraftplus.command.give
/ncp trust <player> 允许其他玩家使用你放置的 NearbyCraft+ 工作台。 nearbycraftplus.workbench.trust
/ncp untrust <player> 从你的工作台中移除受信任的玩家。 nearbycraftplus.workbench.untrust
/ncp trustlist 显示你工作台的所有受信任玩家。 nearbycraftplus.workbench.trustlist

权限
权限 描述 默认值
nearbycraftplus.admin 授予所有 NearbyCraft+ 管理功能的访问权限。 OP
nearbycraftplus.command.recipereport 允许运行 NearbyCraft+ 配方报告命令。 OP
nearbycraftplus.command.reload 允许重新加载 NearbyCraft+。 OP
nearbycraftplus.command.scan 允许使用扫描调试命令。 OP
nearbycraftplus.command.give 允许给予 NearbyCraft+ 工作台。 OP
nearbycraftplus.update 允许接收 NearbyCraft+ 更新通知。 OP
nearbycraftplus.workbench.use 允许使用 NearbyCraft+ 工作台。 Everyone
nearbycraftplus.workbench.place 允许放置 NearbyCraft+ 工作台。 Everyone
nearbycraftplus.workbench.break 允许破坏 NearbyCraft+ 工作台。 Everyone
nearbycraftplus.workbench.craft 允许在 NearbyCraft+ 工作台内合成。 Everyone
nearbycraftplus.workbench.trust 允许为所属的 NearbyCraft+ 工作台信任玩家。 Everyone
nearbycraftplus.workbench.untrust 允许从所属的 NearbyCraft+ 工作台中移除受信任的玩家。 Everyone
nearbycraftplus.workbench.trustlist 允许查看所属的 NearbyCraft+ 工作台的受信任玩家列表。 Everyone
nearbycraftplus.workbench.bypass.owner 允许绕过 NearbyCraft+ 工作台的所有者保护。 OP
nearbycraftplus.storage.use 允许 NearbyCraft+ 使用附近的存储容器。 Everyone
nearbycraftplus.protection.bypass 允许绕过容器保护检查。 默认禁用

半径权限

默认扫描半径为 10。

最大扫描半径为 50。

NearbyCraft+ 技术上支持从 1 到配置的最大半径之间的所有半径权限。

示例:

/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
/lp group VIP permission set nearbycraftplus.radius.50 true

群组同样适用。


工作台所有权与信任系统

当玩家放置一个 NearbyCraft+ 工作台时,该玩家即成为该工作台的所有者。

如果启用了所有者保护,只有所有者和受信任的玩家才能使用该放置的工作台。

所有者可以通过以下方式信任其他玩家:

/ncp trust <player>

他们可以通过以下方式移除受信任的玩家:

/ncp untrust <player>

他们可以通过以下方式查看受信任的玩家:

/ncp trustlist

如果您希望所有放置的 NearbyCraft+ 工作台都能被所有人使用,也可以在配置中禁用此系统。

配置选项:

workbench:
  owner-protection: true

  trust:
    enabled: true
    max-trusted-players: 10

保护钩子与兼容性

NearbyCraft+ 在使用附近存储容器之前包含保护检查。

这意味着插件仅计算和扫描玩家实际有权访问的容器。

SimpleClaimSystem 支持

NearbyCraft+ 可选支持 SimpleClaimSystem。

如果附近的箱子位于另一个玩家的领地内,且该玩家无权访问它,NearbyCraft+ 将不会扫描或计算该箱子内的物品。

这对生存服务器非常重要,因为玩家绝不应能够使用他们不拥有或无法访问的保护容器中的物品进行合成。

WorldGuard 支持

如果在配置中启用,NearbyCraft+ 也可以使用 WorldGuard 保护检查。

这允许 NearbyCraft+ 尊重受保护的区域和容器访问规则。

JustLootIt 支持

NearbyCraft+ 设计为忽略 JustLootIt 战利品容器。

JustLootIt 箱子和其他战利品/插件容器会通过插件数据和战利品表检查进行过滤,因此它们不作为 NearbyCraft+ 合成的普通存储使用。

战利品与插件容器保护

NearbyCraft+ 可以忽略具有以下特征的容器:

  • 插件区块数据
  • 自定义容器数据
  • 战利品表
  • JustLootIt 战利品容器

这可以防止地牢宝箱、战利品宝箱、事件宝箱以及其他由插件管理的容器被用作存储。


软依赖

NearbyCraft+ 可以挂钩以下插件:

插件 类型 描述
SimpleClaimSystem 软依赖 防止 NearbyCraft+ 扫描玩家无权访问的领地内的容器。
WorldGuard 软依赖 可选的区域/容器保护支持。
JustLootIt 软依赖 防止战利品容器被用作 NearbyCraft+ 存储。

这些插件并非运行 NearbyCraft+ 所必需的,但在安装时会得到支持。


配置

点击显示默认 config.yml
file-version: 2

settings:
  # 启用或禁用主要的 NearbyCraft+ 功能。
  # DE: Aktiviert oder deaktiviert die Hauptfunktionen von NearbyCraft+.
  enabled: true

# 允许 NearbyCraft+ 使用附近的存储容器。
  # DE: Erlaubt NearbyCraft+, nahe Lager-Container zu verwenden.
  use-nearby-containers: true

  # 可以被 NearbyCraft+ 识别为存储的容器类型。
  # 访问保护会单独进行检查。
  # DE: Container-Typen, die NearbyCraft+ grundsätzlich als Lager erkennen darf.
  allowed-containers:
    - CHEST
    - TRAPPED_CHEST
    - BARREL
    - SHULKER_BOX

  # 如果为 true,配方只能使用普通的、未修改的物品。
  # 这将保护带有名称、描述、CustomModelData 或 PDC 数据的自定义物品。
  # DE: Wenn true, dürfen Rezepte nur echte unveränderte Items verwenden.
  require-plain-vanilla-items: true


language:
  # 插件默认语言。
  # 可用选项:de, en, es, fr, it
  # DE: Standardsprache des Plugins.
  default: "en"

  # 支持的语言。
  # DE: Verfügbare Sprachen.
  available:
    - de
    - en
    - es
    - fr
    - it

  # 如果为 true,每个玩家都可以选择自己的 GUI/消息语言。
  # 该选择将保存在 preferences.yml 中。
  # 如果为 false,所有人都使用上面设置的全局默认语言。
  # DE: Wenn true, kann jeder Spieler seine eigene Sprache wählen.
  allow-player-language: true

  # 如果在所选语言文件中缺少某个键值时使用的备用语言。
  # DE: Ersatzsprache, falls ein Text in einer Sprache fehlt.
  fallback: "en"


radius:
  # 普通玩家的默认半径。
  # DE: Standard-Radius für normale Spieler.
  default: 10

  # OP 和拥有 nearbycraftplus.admin 权限玩家的半径。
  # 此值故意低于硬性最大值。
  # DE: Radius für OPs und Spieler mit nearbycraftplus.admin.
  # Dieser Wert ist absichtlich niedriger als das harte Maximum.
  admin: 24

  # 可选的动态半径权限:
  # nearbycraftplus.radius.<amount>
  # 示例:nearbycraftplus.radius.37
  #
  # DE: Optionale dynamische Radius-Permission:
  # nearbycraftplus.radius.<zahl>
  # Beispiel: nearbycraftplus.radius.37


  # NearbyCraft+ 可使用的硬性最大半径。
  #
  # 注意:
  # 当玩家在半径范围内建造包含大量箱子、桶或潜影盒的大型仓库时,
  # 较高的半径值可能会增加扫描成本。
  # 由于 NearbyCraft+ 仅扫描容器并使用 StorageSnapshot 系统,
  # 因此半径 50 是可行的,但仍需谨慎使用。
  #
  # 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:
  # 启用保护检查,以便在 NearbyCraft+ 使用存储容器之前进行验证。
  # 如果启用,NearbyCraft+ 只会使用玩家有权访问的容器。
  # DE: Aktiviert Schutzprüfungen, bevor NearbyCraft+ einen Lager-Container verwendet.
  enabled: true

# 如果保护钩子无法安全地检查访问权限,则拒绝该容器。
  # 推荐用于经济/生存服务器。
  fail-safe-deny: true

  # 如果为 true,则忽略带有自定义方块数据的容器。
  # 这可以防止战利品/插件容器被用作储物箱。
  block-containers-with-pdc: true

  # 如果为 true,则忽略具有战利品表的容器。
  # 这可以防止地牢/战利品/插件容器被用作储物箱。
  block-containers-with-loot-table: true

hooks:
  # WorldGuard 的可选钩子。
  worldguard: true

  # SimpleClaimSystem 的可选钩子。
  simple-claim-system: true

  # JustLootIt 战利品容器的可选钩子。
  # NearbyCraft+ 绝不应将战利品容器用作储物箱。
  justlootit: true


performance:
  # 每次合成会话扫描的最大容器数量。
  # 防止巨大的储物室导致延迟。
  max-containers-per-scan: 150

  # 扫描物品栏槽位的额外安全限制。
  max-slots-per-scan: 8100


craft-success-feedback:
  # 在使用 NearbyCraft+ 合成后显示小型成功反馈。
  # 推荐设置为 false,以避免聊天刷屏。
  enabled: false

  # 可用模式:CHAT, ACTION_BAR
  # CHAT 将消息发送到聊天窗口。
  # ACTION_BAR 将其显示在快捷栏上方。
  mode: ACTION_BAR

  # 每个玩家的冷却时间(毫秒)。
  # 防止玩家在快速合成大量物品时造成刷屏。
  cooldown-ms: 1200

workbench:
  # 特殊的 NearbyCraft+ 工作台显示名称。
  display-name: "<gold>NearbyCraft+ Workbench"

  # 特殊工作台物品的描述。
  lore:
    - "<gray>Craft with nearby storage containers."
    - "<dark_gray>NearbyCraft+"

# 特殊工作台物品的材质。
# 它可以与原版合成台使用相同的材质,因为 NearbyCraft+
# 在内部通过隐藏的数据标签对该物品进行了标记。
# DE: Kann das gleiche Material wie eine normale Werkbank nutzen,
# weil NearbyCraft+ das Item intern unsichtbar markiert.
material: CRAFTING_TABLE

recipe:
    # 启用或禁用 NearbyCraft+ 工作台固定的合成配方。
    # 配方形状:
    # E C E
    # C W C
    # E C E
    #
    # E = ENDER_EYE(末影之眼)
    # C = CHEST(箱子)
    # W = CRAFTING_TABLE(合成台)
    #
    # DE: 启用或禁用 NearbyCraft+ 工作台的固定合成配方
    enabled: true

  # 是否可以将特殊工作台作为方块放置。
  # DE: 是否允许放置特殊工作台。
  placeable: true

  # 如果为 true,只有所有者和受信任的玩家才能使用已放置的 NearbyCraft+ 工作台。
  # 如果为 false,任何人都可以使用已放置的 NearbyCraft+ 工作台。
  # DE: 如果为 true,只有所有者和受信任的玩家才能使用已放置的工作台。
  # DE: 如果为 false,任何人都可以使用已放置的 NearbyCraft+ 工作台。
  owner-protection: true

  trust:
    # 允许所有者为其自己的工作台信任其他玩家。
    # DE: 允许所有者为他们的自定义工作台授权其他玩家。
    enabled: true

    # 每个工作台最多可信任的玩家数量。
    # DE: 每个工作台最大受信任玩家数量。
    max-trusted-players: 10


gui:
  # 默认类别点击模式。
  # QUICK = 类别按钮循环切换类别。
  # PAGE = 类别按钮打开单独的类别选择页面。
  # DE: 默认类别模式。
  # QUICK = 类别按钮循环切换类别。
  # PAGE = 类别按钮打开独立的类别选择界面。
  default-category-click-mode: "QUICK"

  # 如果为 true,玩家可以在 GUI 中切换自己的类别模式。
  # 该选择将保存在 preferences.yml 中。
  # DE: 如果为 true,玩家可以在 GUI 中更改自己的类别模式。
  allow-player-category-mode: true

  # 在工作台 GUI 中启用配方搜索系统。
  # DE: 在工作台 GUI 中启用配方搜索功能。
  search-enabled: true

  # 在搜索过滤配方之前所需的最少字符数。
  # DE: 搜索开始过滤配方所需的最小字符数。
  search-min-length: 1

  # 如果为 true,搜索还会检查配方材料名称。
  # 示例:搜索“diamond”可以显示钻石剑、钻石斧等。
  # DE: 如果为 true,搜索也会检索材料名称。
  search-material-names: true

  # 如果为 true,GUI 中将显示语言按钮。
  # DE: 如果为 true,将在 GUI 中显示语言按钮。
  show-language-button: true


recipe-browser:
  # 仅显示当前可以通过附近存储合成的配方。
  # 这是 NearbyCraft+ 的核心行为。
  # DE: 仅显示可以通过附近容器当前合成的配方。
  only-show-craftable: true

  # 在配方的lore中显示物品可以合成的次数。
  # DE: 在物品的lore中显示可以合成的数量。
  show-craftable-amount: true

  # 按物品名称对配方进行字母顺序排序。
  # DE: 按物品名称按字母顺序排列配方。
  sort-by-name: true

update-checker:
  # 启用 Modrinth 更新检查器。
  # DE: 启用 Modrinth 更新检查器。
  enabled: true

  # 将更新消息打印到控制台。
  # DE: 将更新消息输出到控制台。
  notify-console: true

  # 向在线管理员发送更新消息。
  # DE: 向在线的管理员发送更新消息。
  notify-admins: true

debug:
  # 将阻止的插件容器打印到控制台。
  # DE: 将阻止的插件容器输出到控制台。
  protection: false

  # 启用配方调试命令和详细的配方报告。
  # 建议:在生产服务器上设置为 false。
  # DE: 启用配方调试命令和详细的配方报告。
  recipes: false

展示

分类

显示菜单中可用的分类。

Categories


菜单 / 界面概览

显示菜单导航、按钮以及扫描到的箱子、物品和其他有用信息的显示。

Menu


快速分类功能

演示如何通过左键和右键快速切换分类。

Quick Categories


配方预览

这是 NearbyCraft+ 的主要亮点之一。

配方预览清晰地展示了:

  • 需要多少物品
  • 当前有多少可用
  • 配方可以合成多少次

动画预览

Recipe Preview GIF

配方预览图片

Recipe Preview Image


页面导航

显示在 ALL 分类中向前和向后浏览的过程。

Page Navigation


搜索功能

展示搜索功能的实际应用。

玩家可以在聊天中输入类似 axe 的内容,工作台将以激活的过滤器重新打开,显示匹配的材料。

通过右键点击搜索按钮可以再次禁用搜索过滤器。

Search Function


结语

我创建 NearbyCraft+ 是为了将我喜欢的模组玩法中的某个特性带入 Paper 服务器世界。

如果你想要更舒适的合成体验、更顺畅的存储交互,以及为玩家提供真正的质量提升,NearbyCraft+ 正是为此而生。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源