From 5bb3b8da3725e9dfec99d7e5cf126109173157dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9Cpostyizhan=E2=80=9D?= <“185839426@qq.com”> Date: Sat, 30 Nov 2024 08:04:30 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=88=E5=B9=B6=E6=A0=BC=E5=BC=8F=E5=8C=96?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E5=92=8CMiniMessage=20&=20=E8=B0=83=E6=95=B4?= =?UTF-8?q?=E9=A1=B5=E9=9D=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../advance/Resource-pack-distribution.md | 2 +- docs-java/advance/Skript/skript.md | 2 +- docs-java/advance/YAML/YAML.md | 2 +- docs-java/advance/all-server-core.md | 2 +- docs-java/advance/apply-for-a-domain-name.md | 2 +- docs-java/advance/bot.md | 2 +- docs-java/advance/chinese-username.md | 2 +- docs-java/advance/command.yml.md | 2 +- docs-java/advance/format-code.md | 54 ---------------- docs-java/advance/kether/kether.md | 2 +- docs-java/advance/loginchoices.md | 2 +- docs-java/advance/slime-world.md | 2 +- .../plugin/more/color-message.md} | 61 +++++++++++++++++-- docs-java/process/plugin/more/faq.md | 2 +- docs-java/process/plugin/plugin.md | 28 ++++----- 15 files changed, 82 insertions(+), 85 deletions(-) delete mode 100644 docs-java/advance/format-code.md rename docs-java/{advance/MiniMessage.md => process/plugin/more/color-message.md} (68%) diff --git a/docs-java/advance/Resource-pack-distribution.md b/docs-java/advance/Resource-pack-distribution.md index ceec0728d3..69d151affd 100644 --- 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 index 340c5b4239..66c9044093 100644 --- 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 index ea9a78f0b5..4aeb29779b 100644 --- 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 index a5e1163fb6..d9bec217e1 100644 --- 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 index 44de943058..520e564f38 100644 --- 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 index f8bf634a17..c69dcd84a0 100644 --- 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 index 68e9f28152..f21b7e5461 100644 --- 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 index 847211a33e..00bfe29882 100644 --- 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 deleted file mode 100644 index 3991e247d0..0000000000 --- a/docs-java/advance/format-code.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: 格式化代码 -sidebar_position: 8 ---- - -# 格式化代码 - -**格式化代码(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.md) 部分。 - -## 参考 - -- https://zh.minecraft.wiki/w/%E6%A0%BC%E5%BC%8F%E5%8C%96%E4%BB%A3%E7%A0%81 diff --git a/docs-java/advance/kether/kether.md b/docs-java/advance/kether/kether.md index 46d50bc3a6..b34a07ef4e 100644 --- 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 index 1f24d98a51..bf32c49d08 100644 --- 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 index fad6a8c6f5..e16403b730 100644 --- 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 b/docs-java/process/plugin/more/color-message.md similarity index 68% rename from docs-java/advance/MiniMessage.md rename to docs-java/process/plugin/more/color-message.md index 62b772e910..68ba735c0e 100644 --- a/docs-java/advance/MiniMessage.md +++ b/docs-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 index 85cb746cb0..62097d7012 100644 --- 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 index 8935fa5944..360b5a44ee 100644 --- 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` 列出插件列表。