添加完善内容 更新联系信息

.vitepress/config.ts

@@ -4,6 +4,8 @@ import {zhConfig} from "./zhCN";
 import {ruConfig} from "./ruRU";
 import {zhTWConfig} from "./zhTW";
 import {enUSConfig} from "./enUS";
+import { MarkdownOptions } from 'vitepress';
+// import mdOpts from './mdOpts.mts';
 
 export default defineConfig({
 
@@ -13,6 +15,7 @@ export default defineConfig({
     ],
     //...
     ...sharedConfig,
+    // ...mdOpts, 
 
     title: 'CSKB',
 

.vitepress/mdOpts.mts

@@ -0,0 +1,23 @@
+import { MarkdownOptions } from "vitepress";
+import { getHighlighter } from 'shiki'
+import { fs } from "original-fs";
+
+const skript = JSON.parse(fs.readFileSync('./customLangs/skript.json', 'utf8'))
+
+const highlighter = await getHighlighter({
+  langs: [skript],
+  themes: ['nord']
+})
+
+const html = highlighter.codeToHtml(code, {
+  lang: 'my-lang',
+  theme: 'nord'
+})
+
+
+
+// export default {
+//     markdown: {
+
+//     }
+// }

.vitepress/sharedConfig.ts

@@ -4,13 +4,14 @@ import {ruSearchBarLocale} from "./searchBar/ruRU";
 import {zhTWSearchBarLocale} from "./searchBar/zhTW";
 import {enUSSearchBarLocale} from "./searchBar/enUS";
 
+
 export const sharedConfig = defineConfig({
 
     markdown: {
         // options for @mdit-vue/plugin-toc
         // https://github.com/mdit-vue/mdit-vue/tree/main/packages/plugin-toc#options
         toc: { level: [1, 2, 3] },
-        lineNumbers: true
+        lineNumbers: true,
     },
 
     themeConfig: {

.vitepress/sideBar/zhCN.ts

@@ -13,17 +13,65 @@ export const sidebar: DefaultTheme.SidebarItem[] = [
         ]
     },
     {
-        text: "CMFS",
+        text: "ProjBobcat",
         collapsed: true,
         items: [
-            {text: "简介", link: "/zhCN/CMFS/"},
+            {text: "简介", link: "/zhCN/projbobcat/"},
+            {text: "开始", link: "/zhCN/projbobcat/beforeWeStart"},
             {
-                text: '帮助!',
-                link: '/zhCN/CMFS/help/',
+                text: "安装与配置",
+                link: "/zhCN/projbobcat/installationAndConfig",
+                items: [
+                    {text: "配置 Azure 应用", link: "/zhCN/projbobcat/createNewAzureApp"}
+                ]
+            },
+            {
+                text: "验证模型",
                 collapsed: true,
+                link: "/zhCN/projbobcat/authenticators/",
+                items:[
+                    {text: "离线验证模型", link: "/zhCN/projbobcat/authenticators/offline"},
+                    {text: "Yggdrasil 验证模型（旧版）", link: "/zhCN/projbobcat/authenticators/yggdrasil"},
+                    {text: "Microsoft 验证模型（新版）", link: "/zhCN/projbobcat/authenticators/microsoft"}
+                ]
+            },
+            {
+                text: "安装器",
+                collapsed: true,
+                link: "/zhCN/projbobcat/installers/",
                 items: [
-                    {text: "无效的会话？", link: "/zhCN/CMFS/help/invalid-session"},
-
+                    {text: "CurseForge 整合包安装器", link: "/zhCN/projbobcat/installers/curseforge"},
+                    {text: "Fabric 安装器", link: "/zhCN/projbobcat/installers/fabric"},
+                    {text: "Forge 安装器", link: "/zhCN/projbobcat/installers/forge"},
+                    {text: "LiteLoader 安装器", link: "/zhCN/projbobcat/installers/liteloader"},
+                    {text: "Optifine 安装器", link: "/zhCN/projbobcat/installers/optifine"},
+                    {text: "Quilt 安装器", link: "/zhCN/projbobcat/installers/quilt"}
+                ]
+            },
+            {
+                text: "资源补全器",
+                link: "/zhCN/projbobcat/resourceCompleter/",
+                items: [
+                    {
+                        text: "资源解析器",
+                        collapsed: true,
+                        link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/index",
+                        items: [
+                            {text: "Assets 解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/assetInfoResolver"},
+                            {text: "log4j 日志格式化组件解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/gameLoggingInfoResolver"},
+                            {text: "Libraries 解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/libraryInfoResolver"},
+                            {text: "版本信息解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/versionInfoResolver"}
+                        ]
+                    },
+                    {text: "创建和配置补全器", link: "/zhCN/projbobcat/resourceCompleter/createAndConfigCompleter"}
+                ]
+            },
+            {
+                text: "附加解析器",
+                link: "/zhCN/projbobcat/additionalParsers/",
+                items: [
+                    {text: "游戏档案解析器", link: "/zhCN/projbobcat/additionalParsers/gameProfileParser"},
+                    {text: "账户档案解析器", link: "/zhCN/projbobcat/additionalParsers/accountProfileParser"}
                 ]
             }
         ]
@@ -114,76 +162,39 @@ export const sidebar: DefaultTheme.SidebarItem[] = [
         ],
     },
     {
-        text: "Minecraft",
-        collapsed: true,
-        items: [ 
-            {text: "皮肤规范", link: "/zhCN/skin/"} 
-        ]
-    },
-    {
-        text: "ProjBobcat",
+        text: "CMFS",
         collapsed: true,
         items: [
-            {text: "简介", link: "/zhCN/projbobcat/"},
-            {text: "开始", link: "/zhCN/projbobcat/beforeWeStart"},
-            {
-                text: "安装与配置",
-                link: "/zhCN/projbobcat/installationAndConfig",
-                items: [
-                    {text: "配置 Azure 应用", link: "/zhCN/projbobcat/createNewAzureApp"}
-                ]
-            },
-            {
-                text: "验证模型",
-                collapsed: true,
-                link: "/zhCN/projbobcat/authenticators/",
-                items:[
-                    {text: "离线验证模型", link: "/zhCN/projbobcat/authenticators/offline"},
-                    {text: "Yggdrasil 验证模型（旧版）", link: "/zhCN/projbobcat/authenticators/yggdrasil"},
-                    {text: "Microsoft 验证模型（新版）", link: "/zhCN/projbobcat/authenticators/microsoft"}
-                ]
-            },
+            {text: "简介", link: "/zhCN/CMFS/"},
             {
-                text: "安装器",
+                text: '帮助!',
+                link: '/zhCN/CMFS/help/',
                 collapsed: true,
-                link: "/zhCN/projbobcat/installers/",
-                items: [
-                    {text: "CurseForge 整合包安装器", link: "/zhCN/projbobcat/installers/curseforge"},
-                    {text: "Fabric 安装器", link: "/zhCN/projbobcat/installers/fabric"},
-                    {text: "Forge 安装器", link: "/zhCN/projbobcat/installers/forge"},
-                    {text: "LiteLoader 安装器", link: "/zhCN/projbobcat/installers/liteloader"},
-                    {text: "Optifine 安装器", link: "/zhCN/projbobcat/installers/optifine"},
-                    {text: "Quilt 安装器", link: "/zhCN/projbobcat/installers/quilt"}
-                ]
-            },
-            {
-                text: "资源补全器",
-                link: "/zhCN/projbobcat/resourceCompleter/",
                 items: [
-                    {
-                        text: "资源解析器",
-                        collapsed: true,
-                        link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/index",
-                        items: [
-                            {text: "Assets 解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/assetInfoResolver"},
-                            {text: "log4j 日志格式化组件解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/gameLoggingInfoResolver"},
-                            {text: "Libraries 解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/libraryInfoResolver"},
-                            {text: "版本信息解析器", link: "/zhCN/projbobcat/resourceCompleter/resourceInfoResolver/versionInfoResolver"}
-                        ]
-                    },
-                    {text: "创建和配置补全器", link: "/zhCN/projbobcat/resourceCompleter/createAndConfigCompleter"}
-                ]
-            },
-            {
-                text: "附加解析器",
-                link: "/zhCN/projbobcat/additionalParsers/",
-                items: [
-                    {text: "游戏档案解析器", link: "/zhCN/projbobcat/additionalParsers/gameProfileParser"},
-                    {text: "账户档案解析器", link: "/zhCN/projbobcat/additionalParsers/accountProfileParser"}
+                    {text: "无效的会话？", link: "/zhCN/CMFS/help/invalid-session"},
+
                 ]
             }
         ]
     },
+    {
+        text: 'Skript导引',
+        collapsed: true,
+        items: [
+            {text: "开始", link: "/zhCN/skript/"},
+            {text: "入门", link: "/zhCN/skript/startup"},
+            {text: "注册起始点", link: "/zhCN/skript/register-entry"},
+
+        ]
+    },
+    {
+        text: "Minecraft",
+        collapsed: true,
+        items: [ 
+            {text: "皮肤规范", link: "/zhCN/skin/"} 
+        ]
+    },
+
     {text: "通用最终用户许可协议", link: "/zhCN/geula"}
 ];
 

zhCN/guide/contact.md

@@ -2,20 +2,21 @@
 
 ###### 与我们取得联系！
 
-*更新于：2023年11月28日*
-
-| 平台                | 联系方式                                                 |
-| ------------------- | -------------------------------------------------------- |
-| QQ群（LauncherX 1） | 589798569                                                |
-| QQ群（LauncherX 2） | 772039197                                                |
-| QQ群（CMFS）        | 419902868                                                |
-| QQ群（ProjBobcat）  | 677872263                                                |
-| QQ群（新成员审核）  | 1040526762                                               |
-| #########           | ########                                                 |
-| Bilibili            | [llr老腊肉](https://space.bilibili.com/31267692)         |
-| KOOK                | [CoronaStudio](https://www.kookapp.cn/app/invite/rCdGVn) |
-| 酷安                | [CoronaStudio](https://www.coolapk.com/feed/24778166)    |
-|                     |                                                          |
+*更新于：2024年3月23日*
+
+| 平台                          | 联系方式                                                     |
+| ----------------------------- | ------------------------------------------------------------ |
+| QQ群（LauncherX 1）           | 589798569                                                    |
+| QQ群（LauncherX 2）           | 772039197                                                    |
+| QQ群（CMFS）                  | 419902868                                                    |
+| QQ群（ProjBobcat）            | 677872263                                                    |
+| QQ群（新成员审核）            | 1040526762                                                   |
+| #########                     | ########                                                     |
+| Bilibili                      | [llr老腊肉](https://space.bilibili.com/31267692)             |
+| 合作QQ频道(包含LauncherX支持) | [「我的世界」](https://pd.qq.com/s/1qab65hj3)                |
+| KOOK                          | [CoronaStudio](https://www.kookapp.cn/app/invite/rCdGVn)     |
+| 酷安                          | [CoronaStudio](https://www.coolapk.com/feed/24778166)        |
+| MineBBS                       | [CoronaStudio](https://www.minebbs.com/members/coronastudio.83949/) |
 
 
 

zhCN/lxguide/others/report-with-logs.md

@@ -35,14 +35,40 @@ EventVwr, 即Event Viewer 事件查看器. 它存在于System32目录下, 名称
 
 调整下半部分的大小 (鼠标拖拽上下窗口的中间分界线) 确认是否如上图所示: Application: LauncherX.Avalonia.exe<br>并且包含许多「at」开头的错误信息. 如果是, 您可以将这些错误信息复制发给我们 (LXIT/邮箱等, 详见: [向我们反馈](/zhCN/lxguide/report-issue))
 
-
-
 :::tip
 
 请记好LauncherX发生错误时的时间, 这有助于快速寻找对应的事件项目. <br>如若需要刷新事件管理器展示的列表, 请点击左上角菜单栏的「操作-刷新」
 
 :::
 
+## macOS日志
+
+### 不是崩溃弹窗吗?
+
+崩溃弹窗中的内容往往包含的是与系统内核深度相关的信息, 一般对诊断LauncherX没有任何帮助.
+
+### 如何获取LauncherX崩溃瞬间的日志
+
+首先, 请确认这个错误会**稳定复现**.
+
+然后, 打开终端, 并找到您的LauncherX主文件 (一般应该放在**应用程序**文件夹, 文件名称一般是`LauncherX.Avalonia.app`)
+
+右键点击它并点击“显示包内容”
+
+在包内容中, 依次打开目录: Contents/MacOS/ . 这里面应该可以找到一个名为LauncherX.Avalonia的文件. 这是LauncherX的入口.
+
+将这个文件拖入终端并点击Enter, LauncherX就会伴随着终端窗口中的日志滚动而开始运行.
+
+在这个状态下尝试复现导致崩溃的问题. 如果确实崩溃了, 终端窗口中应该会显示如图的内容:
+
+![figure correct item](/img/lxguide/reportWithLogs/lx_macos_logs.png)
+
+请将这一段**Unhandled Exception**复制给我们作为线索.
+
+## Linux日志
+
+使用终端运行LauncherX将会显示完整的日志. 请参考上文关于**macOS日志**的内容向我们提供线索!
+
 ## 游戏日志
 
 敬请期待. 与此相关的阅读: [了解更多关于日志窗口的信息](/zhCN/lxguide/features/log-window)

zhCN/skript/index.md

@@ -0,0 +1,83 @@
+# Skript脚本语言入门指南: 准备工作
+
+:::tip 本文将指引您构建一个编写和调试Skript的环境.
+
+:::
+
+[[toc]]
+
+## 介绍
+
+### 关于Skript
+
+Skript(简称sk)：作为一种十分接近英语这一自然语言的脚本语言，一定程度上降低了服主们发挥创意的门槛。而总还是有的：首先你要对你的英语水平很有自信——能看懂文档的范例即可；其次就是在逻辑上能够理解之——作为脚本语言，并不是能用交际英语就可以解决一切问题；也不是Siri，和它描述需求它就能为你实现（Siri也不能）。所以，要想在Sk的世界随心徜徉，首先要记住，你如何与sk交流，Skript(的解释器)才能 “听懂” (实际上所有编程语言都是这样)。
+
+与此同时，Minecraft的各个概念（实体、区块、规则之类）还有一些计算机基础知识与名词（string字符串、integer整数之类, 不过skript应该说是弱类型语言吧? 有最基本的区分: string对应text, player是玩家类型, number默认是long但是可以直接无感地变成double, 很多类型都可以通过parse as语法进行转换. ）也是必不可少的，但是由于其容易通过搜索引擎了解，故不在此赘述。
+
+### 安装
+
+首先需要一个基于Bukkit的Minecraft服务端, 并且已经初始化. 然后前往[SkriptLang Github Release](https://github.com/SkriptLang/Skript/releases)下载最新版Skript插件构建, 将下载好的.jar文件放置在`~<server_root>/plugins/`下, 然后重新启动服务端. 在将插件放置在此位置并启动服务端后, Skript将在plugins目录下创建自己的工作目录`skript`. 
+
+使用服务端命令`/sk info` 来确认Skript是否已安装, 以及版本信息和附属插件版本信息.
+
+### Skript文件
+
+Skript脚本的文件存放在它的**工作目录** 的子文件夹`scripts` 下, 内容是纯文本. 所有Skript脚本文件它的文件扩展名是`.sk`, 手动在文件名的最前方添加符号`-`将会使其内容不被加载(与命令`/sk disable <script_name>.Skript`是同样的效果) 
+
+在这个文件夹下新建文本文档并修改扩展名为`.sk`以创建你的第一个Skript脚本文件.
+
+
+
+## 搭建调试环境
+
+:::tip 为了更好地编写和调试脚本, 建议自行搭建一个独立于运营服务端的环境.
+
+:::
+
+在最开始, 请先自行寻找一个地方创建文件夹, 命名最好让自己看得懂. 以后我们称呼这个文件夹为「Skript 目录」
+
+### 编辑器
+
+我们推荐使用 **Visual Studio Code** 来编写Skript. 但是实际上, 可以用任意一个文本文件编辑器来编辑Skript脚本. 只是根据笔者经验, VSCode是最方便的.
+
+前往[VSCode 下载页面](https://code.visualstudio.com/download) 选择适合自己电脑的版本下载并安装. 安装完成后打开VSCode, 在左侧找到一个「四个方块」组成的图标 (有点类似&#xe74c; ), 鼠标悬浮后若提示「扩展(Extension)」, 则点击它. 
+
+在它的搜索框内搜索「Skript + SkriptInsight」, 选择作者为「NickAc」的项目, 点击「安装(Install)」
+
+按需重启VSCode.
+
+找到先前创建的Skript目录, 右键点击它, 点击“在VSCode打开” (Windows11目前貌似要先点击「显示更多选项」), 现在你的VSCode就已经将 Skript 目录作为一个项目打开了.
+
+点击VSC窗口右上角的「上白下黑」的按钮 (切换面板, 图标类似于&#xe745;), 以打开下方命令行面板. 这个面板中命令行的起始点即为Skript目录.
+
+### 用于调试脚本的服务端
+
+在Skript 目录中放置一个Bukkit/Spigot/Paper/… 服务端, 然后在上文中打开的命令行面板中操作控制台, 像正常开服一样将其初始化.
+
+初始化后, 为其安装 **兼容的** Skript. 
+
+在VSC左侧的竖列图标中, 确保选中了从上往下数的第一个图标 (资源管理器), 然后选择到scripts文件夹. 使用「新建文件…」按钮(图标类似 &#xf56e; 但是右下角有个+符号) 在当前选中的目录下创建新文件.
+
+运行服务端命令 `/sk help` 来查看skript帮助. 
+
+## 其他
+
+可以创建一个新的脚本然后粘贴以下内容来简化执行`/sk reload scripts` 命令. 
+
+`````skript
+command /skr:
+		trigger:
+				if sender has permission "admin":
+						broadcast "脚本将在3秒内开始重载, 可能带来卡顿" # 可选, 用于提示其他玩家. 如果在专用测试环境中调试, 则可删除此行.
+						wait 3 second # 配合上一条.
+						make sender execute command "/sk reload scripts"
+						broadcast "完成重载"
+						stop
+`````
+
+这样就可以使用新注册的命令`/skr`来重载所有脚本了. 
+
+
+
+
+