Merge branch 'postyizhan:main' into main

docs-java/advance/kether/idk.md

@@ -0,0 +1,36 @@
+---
+title: 不知道放在哪
+sidebar_position: 6
+---
+
+## 命名空间
+
+建议阅读：https://www.yuque.com/sacredcraft/kether/namespace
+
+## inline
+
+inline是在一段文本中插入语句，实际上会创造一个新的kether环境
+
+例如这个 TrMenu 例子中：
+```yaml
+  'A':
+    display:
+      material: stone
+    actions:
+      - meta set a to 1
+      - tell &a
+      - tell inline {{&a}}
+```
+第一个 tell 打印了 1
+
+而第二个 tell 打印了空值
+
+因为第二个 tell 后面是一个新的 kether 环境，里面没有原 kether 环境里的变量
+
+同时，你也不能使用原插件提供的 kether 私有语句，不过你可以尝试 [导入语句](https://www.yuque.com/sacredcraft/kether/namespace#zVbkg)
+
+![](_images/inline.png)
+
+## join
+
+join 是拼接多个语句，不会像 inline 那样创造新的环境，所以没有上述特性，join 里的语句会使用原 kether 环境

docs-java/advance/kether/if.md

@@ -236,6 +236,8 @@ any [ 动作1 动作2 动作3 更多 ]
 
 ### 妙妙写法
 
+#### all_any多行
+
 ```
 all [ 条件1 条件2 ]
 any [ 条件1 条件2]
@@ -249,3 +251,31 @@ any [
     条件2
 ]
 ```
+
+####  判断null字符串
+
+如果一个动作，变量，或者其他什么东西会有输出null的情况，而你想判断这个情况
+
+但是 `null` 是一个已有的动作：https://kether.tabooproject.org/list.html#Null
+
+> 返回一个空值。
+
+可是我想判断的是 `null` 这四个字母！这咋办？
+
+还记得之前学的 [literal](basic.md#actiontoken和literal) 吗？
+
+```yaml
+check 你要判断的东西 == literal null
+```
+
+告诉kether我要的null是个字符串而不是使用 null动作
+
+#### 判断空值
+
+https://kether.tabooproject.org/list.html#Pass
+
+> 返回一个空字符串。
+
+```yaml
+check 你要判断的东西 == pass
+```

docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Math.md

@@ -68,7 +68,7 @@ sidebar_position: 3
 
 使用 `{}` 代替变量的 `%`
 
-比如 [Server扩展](https://wiki.placeholderapi.com/users/placeholder-list/#server)的 `%server_online%`显示当前服务器在线玩家数
+比如 [Server扩展](https://wiki.placeholderapi.com/users/placeholder-list/#server)的 `%server_online%` 显示当前服务器在线玩家数
 
 ![](_images/Math/4.png)
 

docs-java/process/plugin/other/Menu/DeluxeMenus.md

@@ -4,6 +4,8 @@ sidebar_position: 3
 
 # DeluxeMenus
 
+:::info
+
 `文档（英文）` https://wiki.helpch.at/helpchat-plugins/deluxemenus
 
 `SpigotMC` https://www.spigotmc.org/resources/deluxemenus.11734/

docs-java/process/plugin/other/Menu/Invero.md

@@ -0,0 +1,195 @@
+---
+sidebar_position: 5
+---
+
+# Invero
+
+Invero 俗称 TrMenu v4
+
+**目前**还不推荐使用
+
+文档不全，部分案例付费入群获取，但是目前不对外出售
+
+别人备份的源码 1.0.3版本 https://github.com/inrhor/Invero
+
+作者自己发的 1.0.8版本 也是老板本 https://gitlab.com/Arasple/Invero
+
+~~文档 https://legacy.invero.fining.io/~~
+
+文档地址改了，我就不放新地址了
+
+## 案例
+
+### 妙妙写法
+
+#### 子图标写true
+
+与 [这里](TrMenu.md#子图标写true) 相同的原理
+
+#### 子图标写动作
+
+与 [这里](TrMenu.md#子图标写动作) 相同的原理
+
+#### 生成器配置多行lore
+
+```yaml
+generator:
+  output:
+    material: 'NAME_TAG'
+    # ! 重要！ 开启lore解析增强
+    enhancedLore: true
+  elements:
+  - name: 'demo1'
+    lore: |-
+      lore1
+      \n lore2
+  - name: 'demo2'
+    lore: |-
+      lore1
+      \n lore2
+```
+
+#### vault经济与PlayerPoints经济
+```yaml
+  'A':
+    head: stone
+    name: 给予扣除检测vault经济
+    action:
+      money give 100
+      money take 100
+      if money has 300 then tell >300 else tell <300
+  'B':
+    head: stone
+    name: 给予扣除检测PlayerPoints经济
+    action:
+      points give 100
+      points take 100
+      if points has 300 then tell >300 else tell <300
+```
+
+#### ctx与persist与&
+```yaml
+items:
+  '1':
+    head: stone
+    name: '菜单语境'
+    # 这只是临时的，在菜单关闭后就会消失
+    action:
+      context set awa to 1
+      tell context get awa
+      tell &awa
+  '2':
+    head: stone
+    name: '玩家持久变量'
+    # 持久的，关闭菜单也不会消失
+
+    # 单一个体玩家的独立持久变量
+    # 有点像是papi
+    # 玩家A的名为qwq的变量存储1 get得到会是1
+    # 玩家B的名为qwq的变量存储2 get得到会是2
+    lore:
+      - 'persist设置后不会立即更新kether语境中的变量 但context会'
+      - '所以你可以看到persist底下一个是输出2一个输出2-persist'
+    action:
+      tell ---context---
+      context set player@qwq to 2
+      tell context get player@qwq
+      tell &player@qwq
+
+      tell ---persist---
+      persist set qwq to 2-persist by PLAYER
+      tell persist get qwq by PLAYER
+      tell &player@qwq
+  '3':
+    head: stone
+    name: '全局变量'
+    # 持久的
+
+    # 比如变量www里面存储了 1
+    # 那么不管哪个玩家读取www这个全局都是读出1
+    # 你把变量www里面存储改成 2
+    # 那么不管哪个玩家读取www这个全局都是读出2
+    lore:
+      - '和玩家持久变量写的lore一个理'
+    action:
+      tell ---context---
+      context set global@www to 3
+      tell context get global@www
+      tell &global@www
+
+      tell ---persist---
+      persist set www to 3-persist by global
+      tell persist get www by global
+      tell &global@www
+```
+
+#### 单面板配置玩家背包
+
+```yaml
+menu:
+  title: '单面板配置玩家背包'
+  # 虚拟容器 建议开启
+  virtual: true
+  # 隐藏玩家背包 必须开启
+  hide-player-inventory: true
+
+layout:
+  - '         '
+  - ' A       '
+  - '         '
+  - '         '
+  - '         '
+  - '         '
+  - 'BBBBBBBBB'
+  - '         '
+  - '         '
+  - '         '
+
+icons:
+  'A':
+    material: iron_ingot
+  'B':
+    material: stone
+    name: '玩家背包'
+```
+
+### 每日签到
+
+[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-每日签到.yml)
+
+### tpa选人菜单
+
+[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-tpa选人菜单.yml)
+
+### 称号系统
+
+[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-称号系统.yml)
+
+### 商店
+
+:::tip
+
+你需要安装 [CheckItem](../../Front-Plugin/PlaceHolderAPI/CheckItem.md)
+
+并 [开启give和remove](../../Front-Plugin/PlaceHolderAPI/CheckItem.md#启用give和remove) 和 [更改-boolean](../../Front-Plugin/PlaceHolderAPI/outline.md#更改-boolean)
+
+:::
+
+不想写，以后再说8，你可以先照着trm那边去学
+
+#### 以物易物
+
+#### 购买
+
+#### 个人限购
+
+#### 全服限购
+
+#### 出售
+
+#### 个人限售
+
+#### 全服限售
+
+
+

docs-java/process/plugin/other/Menu/TrMenu.md

@@ -44,21 +44,55 @@ sidebar_position: 4
 
 Invero 俗称 TrMenu v4
 
-**目前**还不推荐使用
+详情请见 [Invero](Invero.md)
 
-文档不全，部分案例付费入群获取，但是目前不对外出售
+## 案例
 
-别人备份的源码 1.0.3版本 https://github.com/inrhor/Invero
+:::warning
 
-作者自己发的 1.0.8版本 也是老板本 https://gitlab.com/Arasple/Invero
+请使用 最新的 **TrMenu社区版** 不保证**旧**版本可用性
 
-~~文档 https://legacy.invero.fining.io/~~
+:::
 
-文档地址改了，我就不放新地址了
+### 妙妙写法
 
-# 案例
+#### 子图标写true
 
-## TrMenu v3
+`condition` 最后的结果为 true 就会显示这个子图标
+
+```yaml
+  'A':
+    display:
+      material: stone
+    icons:
+      - condition: 'true'
+        display:
+          name: '我有没有条件啊！我到底有没有条件啊！'
+```
+
+所以你可以直接写 true 让他显示这个子图标
+
+![](_images/为难.jpg)
+
+#### 子图标写动作
+
+因为 `condition` 会执行里面的kether语句
+
+所以你可以这样子在菜单打开或重新计算子图标的时候跑一遍这些语句
+
+```yaml
+  'A':
+    display:
+      material: stone
+    icons:
+      - condition: 'tell 想不到骚话'
+      - condition: 'tell 想不到骚话'
+      - condition: 'tell 想不到骚话'
+      - condition: 'tell 想不到骚话'
+      - condition: 'tell 想不到骚话'
+```
+
+![](_images/子图标写动作.png)
 
 ### 玩家信息
 
@@ -66,7 +100,7 @@ Invero 俗称 TrMenu v4
 
 **右键玩家执行动作**
 
-https://github.com/Dreeam-qwq/TrMenu/blob/stable/v3/plugin/src/main/resources/settings.yml
+https://hhhhhy.gitbook.io/trmenu-v3/usage/shortcuts
 
 此处为右键玩家打开名为 Profile 的菜单
 
@@ -85,7 +119,7 @@ https://github.com/Dreeam-qwq/TrMenu/blob/stable/v3/plugin/src/main/resources/me
 
 **蹲下+替换副手执行动作**
 
-https://github.com/Dreeam-qwq/TrMenu/blob/stable/v3/plugin/src/main/resources/settings.yml
+https://hhhhhy.gitbook.io/trmenu-v3/usage/shortcuts
 
 ```yaml
   Sneaking-Offhand:
@@ -102,16 +136,120 @@ https://github.com/Dreeam-qwq/TrMenu/blob/stable/v3/plugin/src/main/resources/se
 
 不过这些配置主要是用来学习的，不会有人直接cv过去用吧
 
-## Invero
+### 商店
 
-### 每日签到
+:::tip
 
-[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-每日签到.yml)
+你需要安装 [CheckItem](../../Front-Plugin/PlaceHolderAPI/CheckItem.md)
 
-### tpa选人菜单
+并 [开启give和remove](../../Front-Plugin/PlaceHolderAPI/CheckItem.md#启用give和remove) 和 [更改-boolean](../../Front-Plugin/PlaceHolderAPI/outline.md#更改-boolean)
 
-[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-tpa选人菜单.yml)
+:::
 
-### 称号系统
+#### 以物易物
 
-[查看配置](https://github.com/postyizhan/NitWikit/blob/main/docs-java/process/plugin/other/Menu/demo/inv-称号系统.yml)
+**知识点：**
+
+- TrMenu 文档熟读并背诵
+- [kether](/docs-java/advance/kether/basic.md)
+- [CheckItem](../../Front-Plugin/PlaceHolderAPI/CheckItem.md)
+
+```yaml
+  '写法1':
+    display:
+      name: '两个钻石换三个绿宝石'
+      material: stone
+    actions:
+      - condition: 'papi %checkitem_mat:diamond,amt:2%'
+        actions:
+          - 'papi %checkitem_remove_mat:diamond,amt:2%'
+          - 'papi %checkitem_give_mat:emerald,amt:3%'
+        deny:
+          - 'tell inline "物品不够，你有{{papi %checkitem_amount_mat:diamond,amt:2%}}个，还差{{math 2 - papi %checkitem_amount_mat:diamond,amt:2%}}个"'
+  '写法2':
+    display:
+      name: '两个钻石换三个绿宝石'
+      material: stone
+    actions:
+      - if papi %checkitem_mat:diamond,amt:2% then {
+          papi %checkitem_remove_mat:diamond,amt:2%
+          papi %checkitem_give_mat:emerald,amt:3%
+        } else tell inline "物品不够，你有{{papi %checkitem_amount_mat:diamond,amt:2%}}个，还差{{math 2 - papi %checkitem_amount_mat:diamond,amt:2%}}个"
+```
+
+#### 购买
+
+```yaml
+  '写法1':
+    display:
+      name: '10块钱买2个钻石'
+      material: stone
+    actions:
+      - condition: 'money 10'
+        actions:
+          - 'take-money: 10'
+          - 'papi %checkitem_give_mat:emerald,amt:3%'
+        deny:
+          - tell inline "钱不够，你有{{papi %vault_eco_balance%}}块，还差{{math 10 - papi %vault_eco_balance%}}块"
+  '写法2':
+    display:
+      name: '10块钱买2个钻石'
+      material: stone
+    actions:
+      - if money 10 then {
+          command inline"money take {{player name}} 10"
+          papi %checkitem_give_mat:emerald,amt:3%
+        } else tell inline "钱不够，你有{{papi %vault_eco_balance%}}块，还差{{math 10 - papi %vault_eco_balance%}}块"
+```
+
+#### 个人限购
+
+**知识点：**
+
+- TrMenu 文档熟读并背诵
+- [kether](/docs-java/advance/kether/basic.md)
+- [CheckItem](../../Front-Plugin/PlaceHolderAPI/CheckItem.md)
+- [妙妙写法](#妙妙写法)
+- [\{condition=\}条件](https://hhhhhy.gitbook.io/trmenu-v3/menu/action/option#tiao-jian)
+
+```yaml
+  'C':
+    display:
+      name: '10块钱买2个钻石（限购20个）'
+      material: stone
+    icons:
+      - condition: meta set KEY to 限购数据1
+      - condition: data set papi %trmenu_meta_KEY% to 20
+    actions:
+      - condition: meta set 单价 to 10
+      - condition: all [ money papi %trmenu_meta_单价% check data get meta get KEY > 0 ]
+        actions:
+          # 扣钱
+          - 'take-money: %trmenu_meta_单价%'
+          # 扣一次限购
+          - data set papi %trmenu_meta_KEY% to join [ math data get meta get KEY - 1 ]
+          - tell join [ "剩余限购次数：" data get meta get KEY " 剩的钱：" papi %vault_eco_balance% ]
+          # 给货
+          - papi %checkitem_give_mat:emerald,amt:3%
+        deny:
+          - tell inline 钱不够，你有{{papi %vault_eco_balance%}}块，还差{{math papi %trmenu_meta_单价% - papi %vault_eco_balance%}}块 {condition=not money meta get 单价}
+          - tell inline 限购次数用完了 {condition=check data get meta get KEY == 0}
+```
+
+#### 全服限购
+
+上面个人限购的 data 改成 globaldata
+
+自己看文档：https://hhhhhy.gitbook.io/trmenu-v3/menu/action/types#shu-ju-cao-zuo
+
+#### 出售
+
+和上面的购买几乎一样的逻辑，自己去学 CheckItem 然后把 give 改成 remove
+
+#### 个人限售
+
+和上面的个人限售几乎一样的逻辑，自己去学
+
+#### 全服限售
+
+上面的会了这个你就会写了

docs-java/process/plugin/other/TAB&Scoreboard/TAB.md

@@ -23,3 +23,5 @@ sidebar_position: 2
 这个插件只是名字叫TAB，其实TAB、计分板、bossbar等功能它都有，但总是有不看配置文件和文档的大聪明...
 
 TAB插件的计分板相关: https://docs.superiormc.cn/v/tab-wiki/core-features/ji-fen-ban
+
+汉化（见贴内）：https://www.minebbs.com/resources/tab-tab.9057/

docs-java/process/plugin/plugin.md

@@ -8,6 +8,8 @@ sidebar_position: 1
 
 **本文档中提到的插件都有较多用户基础和完善的 Wiki，具体插件请查看插件的 Wiki。**
 
+![](_images/wiki背诵.jpg)
+
 ![](_images/概览/餐叉.jpg)
 
 **建议阅读**

docs-java/start/basic/server-management-command.md

@@ -63,17 +63,17 @@ sidebar_position: 8
 
 ## /pardon-ip [IP地址]
 
-解封封禁过的玩家
+解封封禁过IP地址的玩家
 
 ## /plugins
 
 看到服务器所有安装的插件(玩家也可以执行此指令)
 
-如果你不想玩家看到插件列表，你可以使用Plugin Hide Pro
+如果你不想玩家看到插件列表，你可以使用 `Plugin Hide Pro` 插件
 
 ## /op [玩家名称]
 
-给予指定玩家OP权限
+给予指定玩家OP（操作员）权限
 
 :::danger
 

docs-java/start/basic/what-is-plugin.md

@@ -5,4 +5,4 @@ sidebar_position: 4
 
 # 什么是插件？
 
-请见 [通用 | 什么是卡顿](https://yizhan.wiki/NitWikit/start/basic/what-is-plugin)
+请见 [通用 | 什么是插件](https://yizhan.wiki/NitWikit/start/basic/what-is-plugin)

docs-java/start/basic/what-is-startup-script.md

@@ -5,4 +5,4 @@ sidebar_position: 4
 
 # 什么是启动脚本？
 
-请见 [通用 | 什么是服务端？](https://yizhan.wiki/NitWikit/start/basic/what-is-startup-script)
+请见 [通用 | 什么是启动脚本？](https://yizhan.wiki/NitWikit/start/basic/what-is-startup-script)

docs-java/start/server-core-choose.md

@@ -141,7 +141,7 @@ import TabItem from '@theme/TabItem';
 
 - 性能 - 相比paper拥有更强的优化
 - 特性 - 为生电而生，专门的生电向特性支持
-- 兼容 - 完全支持paper能使用的全部插件
+- 兼容 - 支持paper能使用的几乎所有插件
 - 支持 - 国人开发的核心
 
 **劣势**：