拾木商店 —— 官方托管的玩家网页商店 无需自建网页 · 玩家自由开店 · 自动分账 · 全服交易

一、前言
开服最麻烦的事情之一，就是给玩家搭建一套可自由买卖的线上市场。 自己独立开发网页商城：需要额外购置服务器、开发前后端页面、搭建数据库、维护支付链路，运维成本极高。 选用第三方成品商城：要么需要服主自行部署环境，要么功能固化，没办法自由适配模组服与自定义玩法。

拾木商店主打轻量化托管方案：网页前端与业务后端全部由官方统一托管，插件仅负责对接游戏内物品与订单发货。服主只需要填入唯一API密钥即可一键上线；玩家输入 /shop 就能进入全服交易市场，自主开店上架商品，平台自动完成订单结算，每一笔交易都留有完整可查询的流水记录。

拾木空间前身为玩家熟知的「投影工坊」，由原班团队长期维护运营，服务稳定可靠，绝非短期小作坊项目，接入与交易安全性更有保障。

二、插件信息
插件名称：拾木商店（Shimu Shop） 

当前版本：v1.0（替换为你发布的版本号） 

适用服务端：Spigot / Paper / 主流Bukkit系（1.13+优先推荐，支持物品注册表识别模组道具） 

前置插件：无，纯Bukkit插件，开箱即用 

网页商店：官方托管页面，地址 https://www.mcimg.com/shop 

后端地址：插件内置固定官方地址，不可自定义修改（防止域名被劫持、订单被伪造） 

下载地址：http://shimu-space-node.xbjstd.cn:91/ShimuShop.jar 

反馈交流：shimu@xbjstd.cn

三、核心功能
官方全托管，零运维成本 网页与后端服务统一由官方维护，插件只负责游戏内订单对接，填入密钥就能直接启用，无需额外购买服务器、不用编写前后端代码。
玩家自主开店，自由交易市场 玩家可以自主开通个人店铺，随时上架、下架商品，自由设置售价；真正做到玩家之间自由交易，不局限于服主单向售卖道具。
全中文物品识别 物品自动匹配中文名称（钻石、下界合金锭等），同时兼容中文游戏ID，不用手动填写冗长的英文物品ID。
模组物品完美兼容 插件启动后自动读取服务端原版Material与模组物品注册表，同步上报到网页端，网页内支持下拉搜索，上架道具无需手动填写ID。
全服/单服双交易范围 商品可以设置为「全服可见」或者「仅当前服务器可见」；插件定时心跳上报服务器在线状态，多服集群统一管理。
多类支付模式 支持平台余额、积分结算，同时兼容服务器自定义虚拟货币（例如钻石、点券作为交易货币，由插件自动在玩家背包内完成物品扣除）。

✅ 补充：使用平台余额货币进行交易的玩家，余额支持申请提现。

订单事务闭环，杜绝吞货与超卖 整笔交易在同一个事务中完成：扣除买家货款→锁定商品库存→完成订单资金清算→生成待发货订单。任意环节出错会自动整体回滚，不会出现吞道具、扣钱不发货、超卖等问题。
完整可追溯交易流水 每一笔订单都会自动记录订单明细、交易服务费、卖家实收金额，所有收支都存入统一流水台账，余额与积分明细随时可查。
物品托管+跨服一键发货 玩家上架商品时道具先存入平台托管仓库；订单成交后，卖家可随时将道具提取到任意已绑定的服务器。 插件定时轮询待发货订单，严格按照物品快照（完整保留NBT与模组数据）自动发货，发货成功后同步回执状态。
四、安装与接入教程
部署插件 将ShimuShop.jar放入服务端plugins文件夹，启动一次服务端自动生成config.yml，关闭服务端修改配置，再次重启即可正常运行。
申请接入，获取专属密钥 打开网页商店 https://www.mcimg.com/shop，进入「服务器接入」板块提交开服申请，管理员审核通过后，发放该服务器专属API密钥。
填写配置文件 打开 plugins/ShimuGamePlugin/config.yml
server-code: survival-1  # 自定义服务器唯一标识
server-name: 生存一区     # 网页展示的服务器名称
api-key: shimu-xxxxxx     # 审核下发的专属密钥，无密钥会持续告警
heartbeat-seconds: 30    # 服务器心跳上报间隔，最小10秒
delivery-seconds: 5       # 订单发货轮询间隔，最小2秒
delivery-batch: 20        # 单次批量处理订单上限
⚠️ 重要说明：后端与网页域名已经内置在插件中，无法修改。此举是为了防止第三方篡改域名窃取密钥、伪造虚假订单，保障交易安全。

玩家使用方法 玩家在游戏内输入 /shop，聊天框会弹出可直接点击的网页链接，一键打开交易市场。玩家在网页绑定游戏ID、开通店铺、上架道具即可正常交易。
五、指令与权限
/shop：发送网页商店跳转链接，默认全体玩家可用。 如需精细化管控，在权限组插件内给普通玩家开放这条指令即可。
六、常见问题（FAQ）
Q1：必须自己搭建网页和数据库吗？ A：完全不需要。网页前端与业务后端全部由官方托管维护，服务器只需要运行插件并填写API密钥就能上线。

Q2：能不能支持模组道具交易？ A：支持。插件自动读取服务器物品注册表，模组注册道具会同步到网页端，玩家可以直接选择上架，无需手动填写ID。

Q3：自定义游戏货币该怎么开启？ A：卖家上架商品时，选择「服务器自定义货币」并选定对应道具（如钻石）；下单后插件会自动从买家背包扣除对应物品，全程在游戏内完成结算。没有对应货币选项，可以联系管理协助添加。

Q4：平台余额可以提现吗？ A：可以。交易选择平台余额作为交易货币时，玩家账户内的平台余额支持申请提现，相关规则以网页内公示为准。

Q5：交易数据是否安全？ A：插件内置固定官方域名，无法被篡改；每台服务器独立分配专属密钥；下单到发货全程事务锁定，失败自动回滚，订单与资金流水永久留痕，保障交易安全。

七、更新计划（规划中）
以下功能尚在评估开发，当前正式版本暂未上线，特此说明：

全局每日商店（随机商品/单人专属商品）
商品限购规则（单人每日上限、全局库存上限）
网页前端自定义模板（当前统一使用官方页面）
QQ机器人+RCON离线生成玩家专属提货Token
手持物品一键入库指令 /saveitem
欢迎回帖投票，优先开发大家呼声最高的功能。

八、关于拾木空间 · 服务保障
拾木空间前身为玩家熟知的「投影工坊」，由原班团队长期持续迭代维护，项目运营稳定，不会中途停更跑路。网页与后端由官方统一托管，每台服务器独立分配密钥，接入必须经过人工审核，杜绝冒用接入；
插件内置固定域名，避免域名劫持、伪造订单等风险。 所有订单资金清算全程留痕，交易明细可随时查阅，服主接入省心、玩家交易安心。

九、下载与反馈
插件下载地址：http://shimu-space-node.xbjstd.cn:91/ShimuShop.jar
网页交易市场：https://www.mcimg.com/shop
问题反馈与技术交流：shimu@xbjstd.cn

如果插件好用，欢迎帮忙顶帖支持！

—— 本文作者：小暴，首发于拾木空间 https://www.mcimg.com/post/12761，未经授权禁止转载。