NormalShops

插件

· 作者 DevEx

基于物品的交易/商店。最适合基于物品的经济系统!

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

最新 26.1.2-v1.0.12 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

NormalShops — 玩家与管理者指南

感谢 - Clickism

游戏内商店(门面)

NormalShops 商店外观视图

用作交易的村民菜单

NormalShops 商店外观视图

NormalShops 商店外观视图

自定义展示:物品展示架、玻璃/基岩方块,以及可选的促销浮动文字。

/shops — 公共商店浏览器

Minecraft /shops 命令 GUI

分页显示有货的商店列表;点击条目进行传送(若已启用)。

GUI 概览(主菜单)

NormalShops GUI 菜单拼贴图

创建/修改上架内容、所有者面板、访问权限选择器、购买流程、库存、设置等。

管理员 / 删除中心(Shift + 右键点击)

NormalShops 管理员菜单

强制编辑、强制更改所有者、删除、历史记录、模拟销售 —— 敏感操作除了需要 normalshops.delete 权限外,还要求具有 op 权限。

创建商店(逐步教程)

动画教程:如何制作商店

GIF:手持告示牌与空的箱子/桶交互,设置价格和商品,即可开业。(具体流程与您的服务器消息和 GUI 版本一致。)

指标数据


为什么选择 NormalShops?

NormalShops 将箱子和桶转变为完全互动的玩家商店,无需强迫玩家使用晦涩的命令。所有者获得一个精美的编辑器,买家拥有清晰的购买流程(经典 GUI 或 村民式交易),工作人员则获得实用工具——包括历史记录、模拟功能和所有权转移——并支持可选的 CoreProtect 集成。

无论您运营的是生存经济还是小游戏枢纽,NormalShops 都旨在提供原生 Minecraft 体验:使用玩家早已熟悉的告示牌、箱子、音效和界面。



功能概览

核心商店体验

能力 描述
基于方块的商店 在箱子或桶上使用告示牌(任意类型的告示牌)创建商店。容器必须为空且不能是双层箱子。
价格与商品 设置货币物品(及数量)以及一种或多种产品 —— 包括自定义物品、头颅,以及在启用 full-nbt-check 时支持 NBT 复杂的物品。
购买流程 顾客可使用购买 GUI 或村民商人界面(通过 villager-trading-menu 配置)。
远程库存池 链接远程箱子库存,使售出的物品从实际存储中扣除 —— 支持单店限额和可选的库存池保护。
收益管理 销售额计入内部收益;所有者通过分页收益箱提取(支持部分拾取和堆叠捆绑包)。
自定义展示 玻璃和物品框风格的商店展示、主题、颜色,以及玻璃上的可选促销文字。
音效与主题 每个商店独立的购买音效和菜单颜色主题,彰显个性。

所有者与团队工具

能力 描述
信任玩家 授予受信任权限,使助手可以管理库存和设置,而无需拥有该商店。
访问选择菜单 所有者/受信任用户可选择编辑器模式或顾客交易视图,以便预览买家看到的界面。
无上限内部库存 内部库存不受27格限制 —— 使用分页库存箱编辑(每页45格 + 导航功能)。
全生命周期分析 收入、销售次数、售出商品、浏览量、库存增减、净变化、利用率、转化率。
买家洞察 基于真实购买历史得出的独立买家数和顶级买家。
市场对比 查看其他商店对重叠商品的定价,并打开分页竞争对手列表。
商店信息卡 编辑器中的快速统计 Lore(包括总浏览量)。


详细功能指南

创建与编辑商店
  1. 手持任意告示牌,右键点击一个空的 箱子或桶(不要潜行,不能是双层箱子)以打开创建 GUI。
  2. 在指定区域放置您的价格(买家支付的内容)和商品(他们收到的内容)。
  3. 点击创建商店以完成设置。

编辑器控件(创建/更改商品菜单):

  • 左键点击物品将其放入槽位。
  • 右键点击持空手可将槽位中的数量减半。
  • 右键点击持有与槽位相同物品可将数量增加一。

创建完成后,作为所有者(或受信任玩家)右键点击您的商店方块以打开访问菜单:选择打开编辑器进行管理,或选择打开交易以面向买家。

购买 —— GUI 模式 vs 村民模式
  • villager-trading-menu: true (默认值): 买家通过商人窗口进行交互。多商品捆绑包显示为高亮箱子配方(内容存储在方块状态元数据中),并使用带有屏障作为虚假“价格”的仅预览行,以确保真实商品清晰可见。
  • false: 买家使用经典的BuyMenu箱子 GUI。

库存不足: 买家仍可以打开交易视图以查看透明度。标题会反映库存状态(例如:有货 vs 无货)。对于非管理员商店,当没有可交付的商品时,阻止履行交易——防止幽灵购买。

曝光量: 打开购买/交易流程会增加终身曝光量,用于转换分析。

库存管理(分页库存箱)
  • 内部库存存储为带有分页功能的逻辑列表(每页 45 个物品槽 + 上一页/下一页/信息/返回编辑器)。
  • 同一时间只允许一名玩家查看商店的库存 GUI,以减少漏洞利用面。
  • 当另一名玩家在该商店上拥有活跃的村民交易会话时,阻止打开库存(反之亦然)。
  • 修订计数器检测外部更改(例如编辑期间的销售),并刷新或使旧视图失效。
  • 基于库存堆栈的移除操作仍与事务逻辑集成。
收益(分页收益箱)
  • 收集会打开一个专用的收益库存,而不是将所有物品一次性倒入玩家的背包中。
  • 所有者可以进行部分提取;捆绑包可以在 GUI 中堆叠以提高可读性。
  • 顶部(收益)库存仅限提取——玩家不能将物品存入或左键单击放入收益槽位;他们的个人背包仍可自由移动。
  • 与库存相同的单 viewers和修订理念。
库存堆栈与收益堆栈
  • 库存堆栈: 连接额外的箱子以提供已售出的物品。可选的 protect-stockpiles 防止非关联玩家打开链接的箱子(绕过权限:normalshops.bypass-stockpile)。
  • 收益堆栈: 中央末影箱“银行”,聚合来自多个商店的支付款项(受 config.yml 中的限制约束)。
  • 系留: 链接时的可选粒子/绳索可视化 (visualize-tethers)。
  • 双层箱子: 堆栈位置经过规范化处理,左右两半解析为一个逻辑堆栈。
自定义与润色
  • 菜单颜色、自定义商店名称(长度受限)、展示牌上的促销文本。
  • 带有灯光、分层和“移至顶部”样式控制的框架与玻璃展示柜。
  • 设置中的按商店通知和低库存警告。
  • 存在无限库存模式,用于特殊情况(受限于 normalshops.unlimited-stock ——在经济服务器上故意设置为危险项)。
管理与审计追踪

使用 normalshops.delete 权限对商店执行 Shift + 右键点击,以打开管理员/删除中心——包括对你自己的商店。

重要提示: 强制编辑、强制更改所有者、删除他人的商店、历史记录以及模拟销售都需要 normalshops.delete 权限和服务器操作员身份 (isOp())。如果没有 op 权限,这些操作将被拒绝并记录日志。

管理员控制 功能
删除商店 移除 listings(可通过 operator-delete-shop-collect 选择性地由操作员收取收益)。
强制编辑 以工作人员身份打开完整的所有者编辑器,以调整价格、库存、展示等。
强制更改所有者 在聊天中提示输入用户名;通过 ShopManager 安全地转移所有权。
商店历史 分页的持久化按商店日志(购买、编辑、连接、模拟销售、村民购买等)。必要时回退到 CoreProtect 方块查找。
模拟销售 运行合成事务(库存 + 收益 + 统计 + 日志记录)用于测试或审核——在日志中标记为 NormalShops-EmulatedSale。

CoreProtect(可选): 如果安装了 CoreProtect 且启用了其 API,NormalShops 会记录交互风格的日志,涵盖创建、删除、购买(GUI 及村民)、库存堆栈更改、收益收集、连接/断开连接等——同时还将结构化行追加到 插件内历史记录 中以供 GUI 使用。

安全性与防重复设计
  • 编辑器会话锁定: 同一时间只有一个管理会话“拥有”深层编辑权限;子菜单尊重相同的锁定消息。
  • 打开和点击时的管理访问检查: 如果受信任的玩家在线时被移除,GUI 将停止接受操作并可安全关闭。
  • 库存/收益修订 + 独占查看者减少了 GUI、商人和异步保存之间的竞争窗口。
  • 村民交易上的履行检查确保在计算收入或销售额之前实际移除了库存。

安装

  1. 服务器: Paper 或 Spigot 1.20.x(API 1.20,如在 plugin.yml 中声明)。
  2. Java: 17。
  3. 将 NormalShops-*.jar 放入 plugins/ 目录。
  4. 可选: 安装 CoreProtect 以获取外部方块历史和更丰富的审计追踪。
  5. 重启一次,然后调整 plugins/NormalShops/config.yml、gui.yml 以及位于 plugins/NormalShops/messages/ 下的语言文件。


快速开始

步骤 操作
1 获取一个告示牌,并在不潜行的情况下右键点击一个空的箱子或桶。
2 在 GUI 中设置价格和商品,然后创建商店。
3 右键点击商店方块以管理或预览买家视图。
4 在编辑器中使用库存箱添加分页的内部库存。
5 使用收集箱打开收益箱并提取利润。
6 当单个方块容量不足时,从编辑器链接库存堆/ 收益堆。


权限

所有节点均以 normalshops. 为前缀。

权限 默认值 用途
normalshops.create true 创建新商店
normalshops.buy true 从商店购买商品
normalshops.customize true 打开自定义流程
normalshops.display true 构建高级展示 (需要 customize)
normalshops.sale-text true 编辑浮动促销文本 (需要 customize)
normalshops.stockpile true 连接库存堆
normalshops.earnings-pile true 连接收益堆
normalshops.delete op Shift+潜行进入管理枢纽;危险操作也需要 op
normalshops.bypass-stockpile op 打开受保护的外部库存堆
normalshops.unlimited-stock op 切换危险的无限库存模式
normalshops.reload op /normalshops reload
normalshops.version true /normalshops version (Modrinth 版本对比)
normalshops.viewshops true /viewshops, /normalshops view
normalshops.shops true /shops 浏览器 + 传送功能
normalshops.region op /normalshops region …, /setpoint
normalshops.restore op /normalshops restore
normalshops.stats-holograms op /normalshops stats-holograms …
normalshops.update-notify op 当 Modrinth 上有新版本发布时在聊天中通知
normalshops.coreprotect-test op 开发者 API 自测
normalshops.coreprotect-debug op CoreProtect 详细诊断日志


命令

命令 描述
/normalshops / /nshops 根命令:view, reload, version, delete, restore, stats-holograms, region
/normalshops reload 重新加载 config.yml, gui.yml 和消息文件
/normalshops version Jar 版本 + Modrinth 更新状态
/normalshops delete 查看一个商店(≤12 个方块);将其移除 (需要权限 + 管理员工作流)
/normalshops restore 从 shop-backups.yml 恢复到指定的箱子/桶
/normalshops stats-holograms list | cleanup 私有统计展示
/normalshops region make | cancel — 与 /setpoint 配合使用以定义 /shops 区域
/viewshops 列出你的商店 + 受信任的商店;远程打开
/shops 公开在售商品浏览器;可选物品过滤器

完整语法和默认值请参阅 Jar 包中的 plugin.yml 或 README 中的命令表。



配置

主要配置文件位于 plugins/NormalShops/ 目录下(如果已存在旧版文件夹 plugins/ClickShop/,则数据会自动迁移至该目录)。

文件 作用
config.yml 语言、限制、库存堆保护、活塞规则、恢复模式、村民 GUI 开关、NBT 严格模式、距离、展示范围、/shops 区域、备份等
gui.yml 菜单布局和图标材质
messages/*.yml 可本地化的字符串(内置 en_US, de_DE, tr_TR;其他代码页以英文为基准填充)
data.yml + shops/*.yml 序列化的 ShopManager、按玩家划分的管理器以及按商店划分的文件

高亮选项说明:

键 控制内容
language 消息包 (en_US, de_DE, …)。
check-update 启动时检查 Modrinth 版本(加入时通知 op 或触发 update-notify)。
protect-stockpiles 锁定对链接补给箱的外部访问。
villager-trading-menu 为客户使用商人界面而非经典购买 GUI。
full-nbt-check 对高级物品进行更严格的匹配(适用于经济服务器)。
max-connection-distance 连接器可达的最大距离。
shop-limit-per-player / pile limits 硬性上限以保护服务器性能。
recover-shop-files 紧急同步 — 运行一次后自动禁用。


支持与贡献

  • PRs: 请保持更改集中;遵循现有代码风格,避免无关的重构。
  • 下载: NormalShops on Modrinth

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源