快速上手
以下操作需要 cloudshop.admin 权限(OP 默认有)。全程在游戏里完成,不用打开任何文件。
1. 打开管理介面
/cs admin
箱子里列出所有商店(首次安装会有 5 个范例商店)。底部一排是工具:新建商店、网页编辑器、重新载入。
2. 新建商店
点 新建商店(绿宝石),在聊天栏输入商店 ID,例如:
weapons
ID 就是文件名(shops/weapons.yml),只能用字母、数字、中文、- 和 _。建好后直接进入这个商店的编辑画面,上面 5 行是商店格子,最下面一行是工具。
3. 上架商品
- 在自己的背包里点一下要卖的物品,把它拿在鼠标上(数量就是每份的数量,例如拿 16 支箭 = 一份 16 支)。
- 点商店里任何一个空格子。
物品会退回你的背包,商店里多了这件商品(默认买价 100、不回收),并自动打开它的 商品设定。

云物品、MMOItems、CraftEngine、ItemsAdder、Nexo、MythicMobs 的物品拿上去点,会自动存成插件 ID(例如 ci:噬渊血冕);改过名或附魔的原版物品会把整个物品原样保存。见 商品与物品来源。
4. 设定价格
在商品设定里,左键「买入价格」,聊天栏输入价格:
250
只写数字 = 默认货币(金币)。其他写法:
| 输入 | 意思 |
|---|---|
250 | 250 金币 |
20 points | 20 点券 |
500 money + 20 points | 组合价格:500 金币加 20 点券,两样都要付 |
0 | 不出售 |
想让玩家也能卖回来,**左键「回收价格」**输入回收价。右键这两个按钮分别是「不出售」「不回收」。

同一个画面还可以设定每份数量、限购、库存、动态价格、折扣、权限、条件、指令……全部选项见 游戏内管理介面。每个改动都立刻写进文件,不需要保存。
5. 加进主菜单
默认的 menu.yml 是手动排版的,新商店要加一个入口才会出现在 /cs 的主菜单。打开 plugins/CloudShop/menu.yml,在 entries 里加:
entries:
# ……原本的入口
weapons:
slot: 22
shop: weapons
然后 /cs reload。图示与名称默认用商店的 icon 与 title。
默认的 menu.yml 开着 list-all-shops: true,新建的商店不用设定就会自动排进主菜单的空格;想自己决定位置再照上面加入口,见 主菜单。用 网页编辑器 新建商店时,也可以勾选自动加入主菜单。
6. 打开商店
/cs 打开主菜单
/cs weapons 直接打开这个商店
默认的点击操作:
| 点击 | 操作 |
|---|---|
| 左键 | 买一份 |
| Shift+左键 | 打开数量选择 |
| 中键 | 买一组 |
| 右键 | 卖一份 |
| Shift+右键 | 背包里这件商品全部卖 出 |
点击操作可以在 config.yml 的 clicks 改,见 主菜单与箱子菜单。