合并格式化代码和MiniMessage & 调整页面

8aka-Team · Nov 30, 2024 · 5bb3b8d · 5bb3b8d
1 parent 61e6d26
commit 5bb3b8d
Show file tree

Hide file tree

Showing 15 changed files with 82 additions and 85 deletions.
diff --git a/docs-java/advance/Resource-pack-distribution.md b/docs-java/advance/Resource-pack-distribution.md
@@ -1,6 +1,6 @@
 ---
 title: 资源包分发
-sidebar_position: 10
+sidebar_position: 6
 ---
 
 # 资源包分发

diff --git a/docs-java/advance/Skript/skript.md b/docs-java/advance/Skript/skript.md
@@ -1,7 +1,7 @@
 ---
 slug: /plugins/other/Skript
 title: Skript 概览
-sidebar_position: 11
+sidebar_position: 8
 ---
 
 # 概览

diff --git a/docs-java/advance/YAML/YAML.md b/docs-java/advance/YAML/YAML.md
@@ -1,7 +1,7 @@
 ---
 title: YAML
 slug: /Sundry/YAML
-sidebar_position: 4
+sidebar_position: 2
 ---
 
 

diff --git a/docs-java/advance/all-server-core.md b/docs-java/advance/all-server-core.md
@@ -1,7 +1,7 @@
 ---
 title: 服务端核心收录
 slug: /Advance/all-server-code
-sidebar_position: 13
+sidebar_position: 12
 ---
 
 # 服务端核心收录

diff --git a/docs-java/advance/apply-for-a-domain-name.md b/docs-java/advance/apply-for-a-domain-name.md
@@ -1,6 +1,6 @@
 ---
 title: 申请域名
-sidebar_position: 6
+sidebar_position: 3
 ---
 
 # 申请域名

diff --git a/docs-java/advance/bot.md b/docs-java/advance/bot.md
@@ -1,6 +1,6 @@
 ---
 title: 机器人搭建
-sidebar_position: 12
+sidebar_position: 10
 ---
 
 # 机器人搭建

diff --git a/docs-java/advance/chinese-username.md b/docs-java/advance/chinese-username.md
@@ -1,6 +1,6 @@
 ---
 title: 中文游戏名
-sidebar_position: 10
+sidebar_position: 7
 ---
 
 # 使用中文名进入服务器

diff --git a/docs-java/advance/command.yml.md b/docs-java/advance/command.yml.md
@@ -1,6 +1,6 @@
 ---
 title: Command.yml
-sidebar_position: 6
+sidebar_position: 4
 ---
 
 # Command.yml 介绍

diff --git a/docs-java/advance/format-code.md b/docs-java/advance/format-code.md
diff --git a/docs-java/advance/kether/kether.md b/docs-java/advance/kether/kether.md
@@ -1,7 +1,7 @@
 ---
 title: kether 教程
 slug: /Advance/kether
-sidebar_position: 12
+sidebar_position: 11
 ---
 
 # 概览

diff --git a/docs-java/advance/loginchoices.md b/docs-java/advance/loginchoices.md
@@ -1,6 +1,6 @@
 ---
 title: 登录方式
-sidebar_position: 7
+sidebar_position: 5
 ---
 
 # 登录方式

diff --git a/docs-java/advance/slime-world.md b/docs-java/advance/slime-world.md
@@ -1,6 +1,6 @@
 ---
 title: Slime 世界格式
-sidebar_position: 11
+sidebar_position: 9
 ---
 
 # Slime 世界格式

diff --git a/docs-java/advance/MiniMessage.md → ...java/process/plugin/more/color-message.md b/docs-java/advance/MiniMessage.md → ...java/process/plugin/more/color-message.md
@@ -1,15 +1,65 @@
 ---
-title: MiniMessage
-sidebar_position: 9
+title: 颜色代码
+sidebar_position: 7
 ---
 
-# MiniMessage
+# 颜色代码
+
+改变你服务器中信息的颜色！
+
+## 格式化代码
+
+**格式化代码(Formatting code)**，又称**颜色代码(Color code)**，能使在游戏中加入含颜色和格式信息。
+
+在 Minecraft 中，可以以分节符号(`§`)产生带色文字。
+
+![](_images/格式化代码/Minecraft_Formatting.gif)
+
+你也可以用 [颜色代码生成器](https://mcg.tuanzi.ink/) 来生成它。
+
+:::note
+
+通常在游戏客户端中，你不能打出 `§` 这个符号。需要使用 `\u00A7` 或者 `\u00a7`
+
+在配置文件中，你可以直接复制粘贴这个符号而不用自己输入。
+
+你也可以在按住 `Alt` 键的同时，**小键盘** **按顺序** 输入 `167` 以输出 `§` 符号
+
+_(注意: ![image](https://github.com/user-attachments/assets/49472da4-9b50-4fa3-92d1-f14cdb08cbb4) 使用新版时字符对应错误，请使用旧版)_
+
+:::
+
+:::tip
+
+为了方便，多数插件的配置中支持使用 `&` 来代表 `§` 。
+
+比如下面这个 TrMenu 菜单例子：
+
+```yaml
+Icons:
+  test:
+    display:
+      material: stone
+      lore:
+        - '&11 &22 &33'
+        - '&aa &bb &cc'
+```
+
+![](_images/格式化代码/游戏内.png)
+
+:::
+
+如果你想要更绚丽的颜色和更丰富的功能(比如点击文本执行命令)。
+
+可以去看 [MiniMessage](#minimessage) 部分。
+
+## MiniMessage
 
 MiniMessage 旨在用简单字符串表示聊天组件，便于用户学习和开发人员扩展。
 
 MiniMessage 的实质是一个叫 Adventure 的库，这是它的 [文档](https://docs.advntr.dev/getting-started.html)。
 
-## 支持列表
+### 支持列表
 
 目前，一些平台已经支持原生使用 Adventure 来扩展字符串，以下是内置此库的列表：
 
@@ -34,7 +84,7 @@ MiniMessage 的实质是一个叫 Adventure 的库，这是它的 [文档](https
 
 :::
 
-## 如何使用
+### 如何使用
 
 :::warning
 
@@ -77,5 +127,6 @@ Icons:
 
 ### 参考
 
+- https://zh.minecraft.wiki/w/%E6%A0%BC%E5%BC%8F%E5%8C%96%E4%BB%A3%E7%A0%81
 - https://docs.advntr.dev/minimessage/format.html
 - https://docs.advntr.dev/platform/native.html
diff --git a/docs-java/process/plugin/more/faq.md b/docs-java/process/plugin/more/faq.md
@@ -1,6 +1,6 @@
 ---
 title: 常见问题
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 # 常见问题

diff --git a/docs-java/process/plugin/plugin.md b/docs-java/process/plugin/plugin.md
@@ -11,22 +11,10 @@ sidebar_position: 1
 建议阅读：
 
 - [YAML 语法](/docs-java/advance/YAML/YAML.md) - 了解大部分插件配置文件的语法。
-- [插件特征文件](/docs-java/process/plugin/more/plugin-signature-file.md) - 了解插件的一些信息。
-- [格式化代码](/docs-java/advance/format-code.md) - 了解彩色字体，下划线，删除线等。
-- [MiniMessage](/docs-java/advance/MiniMessage.md) - 了解 RGB 颜色，文本悬浮和点击文字执行等。
+- [特征文件](/docs-java/process/plugin/more/plugin-signature-file.md) - 了解插件的一些信息。
+- [颜色代码](./more/color-message.md) - 改变服务器中文本的颜色
 - [什么是乱码](https://nitwikit.yizhan.wiki/start/basic/what-is-messy-code) - 了解文本文件中的字符有时为什么会变得奇奇怪怪。
 
-:::danger
-
-服务器在**开发阶段**可以使用 PlugmanX，ServerUtils 等插件热重载插件。
-
-过了开发阶段后切记，多数插件自带了重载 如何 [重载插件](#重载插件) ？。
-
-尽量少使用热重载插件，因为如果插件本身并不支持热重载，即使热重载了也容易出问题。
-
-请阅读 [此文章](https://madelinemiller.dev/blog/problem-with-reload/) 来了解为何。
-
-:::
 
 ## 基本操作
 
@@ -38,6 +26,18 @@ sidebar_position: 1
 
 如 `/tab reload`
 
+:::danger
+
+服务器在**开发阶段**可以使用 PlugmanX，ServerUtils 等插件热重载插件。
+
+过了开发阶段后切记，多数插件自带了重载（上方就是）。
+
+尽量少使用热重载插件，因为如果插件本身并不支持热重载，即使热重载了也容易出问题。
+
+请阅读 [此文章](https://madelinemiller.dev/blog/problem-with-reload/) 来了解为何。
+
+:::
+
 ### 列出插件
 
 使用 `/plugins` 或者 `/pl` 列出插件列表。