跳到主要内容

购买与授权

购买与下载​

  1. 打开 资源中心，注册并登录，购买 CloudShop 云商城（32R，一次购买、永久包更）。
  2. 在资源中心打开 CloudShop 云商城，下载最新的 CloudShop-<版本>-簡體授權版.jar。
  3. 授权码在 会员中心 的「我的授权」。

运行环境​

项目要求
服务端Paper / Purpur / Folia 1.20 – 26.x，同一个 jar（实机测试 1.21.11 与 26.3；1.20.1、1.21.4、26.1.2、26.2 编译验证）
Java17 或更新（1.20.5 起的服务端本身需要 Java 21）
前置插件无（数据库连接池已内置；SQLite / MySQL 驱动由 Paper 提供）
数据库默认 SQLite，不用设置；多个子服共用时改用 MySQL / MariaDB，见 MySQL 多服同步
不支持Spigot（需要 Paper 系服务端）

可选联动​

全部都是软依赖：没装的插件对应功能暂时不能用，其他功能照常。

插件用途
Vault + 任意经济插件type: vault 金币货币（默认的 money），见 货币与价格
PlayerPointstype: playerpoints 点券货币（默认的 points）
PlaceholderAPI变量 %cloudshop_…%、购买条件、type: placeholder 货币
云界面 CloudUI/cs 打开全屏商城画面，见 云界面联动
云物品 CloudItems、MMOItems、CraftEngine、ItemsAdder、Nexo、MythicMobs上架这些插件的物品、用 ID 回收，见 商品与物品来源

安装​

  1. 把 CloudShop-<版本>-簡體授權版.jar 放进 plugins/，启动服务器。
  2. 首次启动会生成 plugins/CloudShop/、5 个范例商店与 token.yml，照下面的 授权 填好授权码后重启。控制台会显示：
[CloudShop] 数据库已连接：SQLite data.db
[CloudShop] 已加载 5 个商店、19 种可回收物品（简体授权版）
[CloudShop] 可用货币：money(Vault:EssentialsX Economy)、points、exp
[CloudShop] PlaceholderAPI 变量已注册：%cloudshop_xxx%
[CloudShop] CloudShop 授权已生效，商城功能已开启
  1. 进游戏输入 /cs 打开商城，或照 快速上手 建自己的第一个商店。
货币状态

默认设定附带的 points（PlayerPoints）没安装、也没有商品用它标价时，只会用一行灰字带过（没有安装对应插件、也没有商品使用的货币（不影响使用）：points），不会出现黄字。只有默认货币或有商品标价用到的货币插件缺少时才会黄字提醒，那些商品会提示「货币 points 目前无法使用」，其他商品照常买卖。见 货币与价格。

授权​

  1. 首次启动会生成 plugins/CloudShop/token.yml，此时插件处于「未授权模式」：服务器照常开启、商店文件全部保留，但商城菜单与买卖都暂停（提示「商城尚未授权，暂时无法使用」）。
  2. 登录 会员中心，在「我的授权」复制 CloudShop 的授权码，填进 token.yml 的 key:，重启服务器。
  3. 首次验证会自动绑定本机（后台会显示本机机器码）；换服务器时请先在会员中心自助解绑。
plugins/CloudShop/token.yml
key: 'XXXX-XXXX-XXXX-XXXX'
  • 授权在后台验证，不会拖慢开服；连不上授权服务器时每 60 秒自动重试，连上后立即生效，不需要重启。
  • 断网时可使用最近一次验证结果离线运行 72 小时。
  • /cs info 可以查看版本、商店数量、数据库、多服同步与介面状态。
  • 多个子服都装的话，每个子服的 token.yml 都要填好授权码。

首次启动生成的文件​

第一次启动（config.yml 还不存在时）会放入 5 个范例商店与主菜单，可以直接拿来改，也可以整个删掉：

文件范例内容
shops/blocks.yml 建材商店一般方块买卖；信标用 组合价格 [5000 money, 5 exp]（金币 + 经验等级）+ 每人每周限购 1 个
shops/farming.yml 农场小铺种子、作物回收；只收不卖、只卖不收的商品
shops/ores.yml 矿物交易所动态价格（卖越多越便宜）、钻石每日限售 64 份、下界合金锭库存 10 个每天补货
shops/daily.yml 每日特惠轮换商店：每天 04:00 从 9 件商品池抽 5 件；周六、周日全店九折；限购与库存
shops/services.yml 服务中心只执行指令的商品：飞行券、经验、VIP（购买条件「10 级以上」+ 每月限购）
menu.yml主菜单：余额、5 个商店入口、出售箱、一键卖出、关闭
范例只放一次

范例只在全新安装时放入。之后删掉范例商店不会再出现；想看原始写法，可以在本页或 商店文件 对照。

文件夹结构​

plugins/CloudShop/
├─ config.yml          主设定：数据库、货币、点击操作、底部按钮、音效、网页编辑器……
├─ messages.yml        所有玩家看得到的文字（聊天提示、商品说明、菜单、管理介面）
├─ menu.yml            主菜单（/cs 打开）
├─ token.yml           授权码
├─ data.db             SQLite 数据库（限购 / 库存 / 行情 / 交易记录 / 特卖）
├─ item-names.yml      （可选）自己补充或修改原版物品的中文名称
├─ shops/              一个文件一个商店，文件名 = 商店 ID
│  ├─ blocks.yml
│  ├─ farming.yml
│  └─ ……
└─ backups/            套用网页编辑器、导入、MySQL 同步、删除商店前的自动备份
  • shops/ 可以再分子文件夹整理（例如 shops/活动/春节.yml），商店 ID 仍然是文件名，不能重复。
  • 文件名以 _ 开头的会被略过，可以用来暂时停用一个商店。
  • 商店 ID 只能用字母、数字、中文、- 和 _，最多 48 字。

升级​

关服，替换 jar，开服。商店文件、设定文件与数据库都会保留；新版本新增的设定项会使用默认值，messages.yml 缺少的文字自动用内置的默认文字。

最后于 更新