提交文件

README.md

@@ -1,3 +1,3 @@
-# Docusaurus 插件文档模板
+# Chest-Commands-Wiki
 
-[点击查看](https://postyizhan.github.io/Wiki-Template/)
+[点击查看](https://postyizhan.github.io/Chest-Commands-Wiki/)

docs/折叠示例1/_category_.json → docs/ADMINISTRATION/_category_.json

@@ -1,5 +1,5 @@
 {
-  "position": 999,
+  "position": 3,
   "link": {
     "type": "generated-index"
   }

docs/ADMINISTRATION/命令.md

@@ -0,0 +1,39 @@
+---
+sidebar_position: 1
+---
+
+# 命令
+
+## `/cc`
+插件的主命令，/chestcommands的缩写
+
+显示版本、开发人员和帮助命令
+
+## `/cc help`
+显示插件帮助
+
+## `/cc reload`
+重载插件
+
+## `/cc errors`
+在控制台上显示上次加载发生的错误
+
+## `/cc list`
+列出所有成功加载的菜单
+
+## `/cc open <file>`
+打开菜单
+
+打开那个菜单需要权限 `chestcommands.open.<file>.yml`
+
+> 此命令仅适用于管理员。
+>
+> 如果你想允许玩家打开菜单，请修改菜单设置中的可自定义命令，并给予他们正确的权限
+>
+> 如果要在另一个菜单中打开一个菜单，请使用打开单击操作
+
+打开另一个玩家的菜单 访问此命令还可以授予打开所有菜单的权限 ?
+
+原文这样说
+
+Opens a menu for another player. **Having access to this command also grants access to open all menus.**

docs/ADMINISTRATION/权限.md

@@ -0,0 +1,31 @@
+---
+sidebar_position: 2
+---
+
+# 权限
+
+> 单物品权限看 `PERMISSION` 属性
+
+## 玩家权限
+
+| 权限 | 描述 |
+| ----------- | ----------- |
+| chestcommands.open.<file>.yml | 菜单打开权限，文件名不能包含空格 |
+
+## 管理员权限
+
+| 权限 | 描述 |
+| ----------- | ----------- |
+|chestcommands.command.help | /cc help |
+|chestcommands.command.open | /cc open <file> |
+|chestcommands.command.open.others | /cc open <file> [player] Note: 该权限还授予打开所有菜单的权限. |
+|chestcommands.command.list | /cc list |
+|chestcommands.command.reload | /cc reload |
+
+## 管理员功能权限
+
+| 权限 | 描述 |
+| ----------- | ----------- |
+|chestcommands.sign | 创建告示牌菜单 |
+|chestcommands.economy.bypass | 绕过经济花费 |
+|chestcommands.update | 接收进入服务器的更新通知 |

docs/ADMINISTRATION/语言.md

@@ -0,0 +1,18 @@
+---
+sidebar_position: 4
+---
+
+位于 `/plugins/ChestCommands/lang.yml`
+
+
+# 语言
+
+```
+no-open-permission: '&cYou don''t have permission &e{permission} &cto use this menu.'
+default-no-icon-permission: '&cYou don''t have permission for this icon.'
+no-required-item: '&cYou must have &e{amount}x {material} &c(durability: {durability}) for this.'
+no-money: '&cYou need {money}$ for this.'
+no-exp: '&cYou need {levels} XP levels for this.'
+menu-not-found: '&cMenu not found! Please inform the staff.'
+any: any
+```

docs/ADMINISTRATION/配置文件.md

@@ -0,0 +1,23 @@
+---
+sidebar_position: 3
+---
+
+# 配置文件
+
+位于 `/plugins/ChestCommands/config.yml`
+
+
+这是带有说明的默认配置：
+```
+# Default color of name and lore of icons, if no other color is present.
+default-color:
+    name: '&f'
+    lore: '&7'
+
+# Cooldown (in milliseconds) between multiple clicks on icons.
+# This prevents executing icon actions too frequently.
+anti-click-spam-delay: 200
+
+# If enabled, the plugin checks for updates and sends a notification to administrators when they join.
+update-notifications: true
+```

docs/折叠示例2/_category_.json → docs/ADVANCED/_category_.json

@@ -1,5 +1,5 @@
 {
-  "position": 1000,
+  "position": 2,
   "link": {
     "type": "generated-index"
   }

docs/ADVANCED/商店.md

@@ -0,0 +1,35 @@
+---
+sidebar_position: 3
+---
+
+# 商店
+
+通过结合一些[物品属性](/docs/BASICS/物品属性.md)和[动作](/docs/BASICS/点击动作.md)，你可以创建简单的商店，出售和购买玩家的物品。
+
+需要有效的 [经济](/docs/BASICS/安装.md) 设置
+
+## 出售
+```
+example:
+    PRICE: 100
+    ACTIONS:
+      - 'give: diamond, 1'
+
+    NAME: 'Buy a diamond'
+    MATERIAL: diamond
+    POSITION-X: 1
+    POSITION-Y: 1
+```
+## 购买
+```
+example:
+    REQUIRED-ITEMS:
+      - 'dirt, 64'
+    ACTIONS:
+      - 'give-money: 10'
+
+    NAME: 'Sell dirt'
+    MATERIAL: dirt
+    POSITION-X: 1
+    POSITION-Y: 1
+```

docs/ADVANCED/自定义占位符.md

@@ -0,0 +1,39 @@
+---
+sidebar_position: 4
+---
+
+# 自定义占位符
+
+将一些静态文本做成自定义占位符
+
+他们可以用在 [物品属性](/docs/BASICS/物品属性.md):
+
+- `ACTIONSs`
+- `NAME`
+- `LORE`
+- `SKULL-OWNER`
+
+## 添加自定义占位符
+
+文件 `/plugins/ChestCommands/customereplaceholders.yml`
+
+要添加新占位符，请执行以下操作：
+
+1. 打开`custom-placeholders.yml`
+
+2. 添加 `'placeholder': 'replacement'`(应保留单引号)
+
+3. 使用/cc Reload重载插件
+
+您现在可以在菜单中使用自定义占位符，它将自动替换为您指定的值
+
+
+您可以在[unicode表](https://unicode-table.com)等网站上找到unicode符号
+
+例子:
+```
+placeholders:
+  '{primary_color}': '&b'
+  '{star}': '★'
+  '{vip_required}': '&6You must be VIP to use this item.'
+```

docs/ADVANCED/菜单告示牌.md

@@ -0,0 +1,24 @@
+---
+sidebar_position: 2
+---
+
+# 菜单告示牌
+
+右键单击告示牌可用于打开任何菜单。玩家仍然需要菜单特定的权限才能打开它
+
+
+如何创建菜单告示牌：
+
+放置一个告示牌
+
+第一行写 `[Menu]`（您要权限chestcommands.sign）
+
+在第二行写 菜单文件名（可以省略.yml扩展名）
+
+如果创建成功，标志的第一行将变为蓝色，否则将变为红色，并在聊天中显示错误消息
+
+## 例子
+
+对于名为tutorial.yml的文件，标志应该是这样的：
+
+![](_images/menu-sign.jpg)

docs/ADVANCED/颜色.md

@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+---
+
+# 颜色
+
+可以在所有的文本中使用颜色和颜色代码
+
+## RGB颜色
+
+> 自定义颜色仅适用于Spigot 1.16或更高版本，并且只有客户端在Minecraft 1.16或更高版本上才能正确显示
+
+使用十六进制颜色格式显示自定义颜色：`&#<HEX color>`。HEX颜色必须恰好由6个十六进制字符组成（0123456789abdedf，不区分大小写）。
+
+HEX颜色选择器可以帮助找到正确的颜色代码，例如[这个](https://www.w3schools.com/colors/colors_picker.asp)
+
+例子: `/hd create example &#FF87D1Pink`
+
+![](_images/hex-color.jpg)
+
+## 标准色表
+
+![](_images/color.png)
+
+## 标准格式代码
+
+![](_images/code.png)

docs/BASICS/_category_.json

@@ -0,0 +1,6 @@
+{
+  "position": 1,
+  "link": {
+    "type": "generated-index"
+  }
+}

docs/BASICS/占位符.md

@@ -0,0 +1,26 @@
+---
+sidebar_position: 6
+---
+
+# 占位符
+
+占位符可以用于以下图标属性：
+
+- `ACTIONS`
+- `NAME`
+- `LORE`
+- `SKULL-OWNER`
+
+占位符标:
+
+| 占位符 | 描述 |
+| ----------- | ----------- |
+| {player} | 玩家名 |
+| {money} | 玩家的钱 |
+| {world} | 玩家所处世界 |
+| {online} | 服务器在线人数 |
+| {max_players} | 最大在线人数 |
+
+使用 PlaceHolderAPI 提供的占位符
+
+**Note**:必须要带百分号 如 %player_gamemode%

docs/BASICS/安装.md

@@ -0,0 +1,20 @@
+---
+sidebar_position: 2
+---
+
+# 安装
+
+> 安装 chestcommands 的步骤与任何其他 Bukkit插件相同，如下.
+
+1. 从 Bukkit Dev 下载 [latest version](https://dev.bukkit.org/projects/chest-commands/files) 1.7.10用[3.3.1](https://dev.bukkit.org/projects/chest-commands/files/2977162)
+2. 将下载下来的 JAR 文件放到 `/plugins` 目录
+3. 重启服务器，你将看到 `/plugins/ChestCommands` 目录
+4. 使用 `/menu` 命令打开示例菜单
+5. 阅读此文档
+
+## 经济
+
+chestcommands 支持经济，并且需要有效的经济设置。您必须已安装：
+
+- Vault（最新版本）
+- 与Vault兼容的经济型插件(如EssentialsX)