Skip to content

Commit 4ba8588

Browse files
SerinaNyaSerinaNya
committed
⚡️ perf(yggdrasil): update
1 parent 66d7f76 commit 4ba8588

File tree

3 files changed

+259
-252
lines changed

3 files changed

+259
-252
lines changed

‎docs/yggdrasil/authlib-injector.md‎

Lines changed: 158 additions & 139 deletions
Original file line numberDiff line numberDiff line change
@@ -1,139 +1,158 @@
1-
<script setup>
2-
import { ref } from 'vue'
3-
import GetAuthlibInjector from '../../components/GetAuthlibInjector.vue'
4-
5-
const latest = ref('')
6-
const updated = ref('')
7-
const download = ref('')
8-
9-
fetch('https://authlib-injector.yushi.moe/artifact/latest.json').then(r => r.json()).then(r => {
10-
latest.value = r.version
11-
updated.value = new Date(r.release_time).toLocaleString()
12-
download.value = r.download_url
13-
})
14-
</script>
15-
16-
# authlib-injector
17-
18-
> authlib-injector 为玩家提供统一的非 Mojang 登录体验。大多数的外置登录都使用 authlib-injector 来实现。
19-
20-
---
21-
22-
<GetAuthlibInjector :latest="latest" :updated="updated" :download="download" />
23-
24-
## 单服务端
25-
26-
1. 将服务器配置文件 `server.properties` 中 `online-mode` 一项的值设为 `true`
27-
28-
::: code-group
29-
30-
``` properties:line-numbers=23 [server.properties]
31-
online-mode=true
32-
```
33-
34-
:::
35-
36-
2. 在你的服务端的启动指令的 `-jar` 参数前添加如下参数
37-
38-
::: code-group
39-
40-
``` bash-vue [需要添加的内容]
41-
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
42-
```
43-
44-
``` bash-vue [完整的启动指令示例]
45-
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
46-
```
47-
48-
:::
49-
50-
- `authlib-injector-{{ latest }}.jar` 为指向 authlib-injector 的 `jar` 的路径或文件名
51-
- `https://littleskin.cn/api/yggdrasil` 为 LittleSkin 的 Yggdrasil API 地址
52-
53-
## Velocity <Badge type="tip" text="Minecraft 1.13 +" />
54-
55-
Modern forwarding 是 Velocity 支持的一种独创格式。它以高效的二进制格式转发所有玩家信息。但是，它仅适用于 Minecraft 1.13 或更高版本。
56-
57-
> [!TIP] 提示
58-
> 本文仅会对「为 Velocity modern forwarding 配置 LittleSkin 外置登录」做出说明。
59-
>
60-
> 本案例使用 Velocity + Paper 作为示例。
61-
>
62-
> 具体的 Velocity 配置请结合参考 [Velocity 文档](https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding)。
63-
64-
<!--@include: ./velocity.template.md-->
65-
66-
- 对于以上所有
67-
68-
**每个**服务端都应该配置 authlib-injector，以便其能正确地处理外置登录。
69-
70-
在**每个**服务端的启动指令的 `-jar` 参数前添加如下参数。
71-
72-
::: code-group
73-
74-
``` bash-vue [需要添加的内容]
75-
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
76-
```
77-
78-
``` bash-vue [Velocity 完整的启动指令示例]
79-
java "-Dauthlibinjector.disableHttpd" -Xms512M -Xmx512M -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar velocity-3.3.0-SNAPSHOT-351.jar
80-
```
81-
82-
``` bash-vue [Paper 子服务器 完整的启动指令示例]
83-
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
84-
```
85-
86-
:::
87-
88-
- `authlib-injector-{{ latest }}.jar` 为指向 authlib-injector 的 `jar` 的路径或文件名
89-
- `https://littleskin.cn/api/yggdrasil` 为 LittleSkin 的 Yggdrasil API 地址
90-
91-
## Waterfall / BungeeCord <Badge type="warning" text="不再推荐" />
92-
93-
BungeeCord 和 Waterfall 属于亲兄弟好姐妹，因此，以下配置同时适用于两者。
94-
95-
- 对于 Waterfall / BungeeCord
96-
97-
检查 `config.yml`，确保 `online-mode` 项的值为 **`true`** :point_left:
98-
99-
::: code-group
100-
101-
``` yaml:line-numbers=17 [config.yml]
102-
online-mode: true
103-
```
104-
105-
:::
106-
107-
- 对于子服务端
108-
109-
检查 `server.properties` 文件，确保 `online-mode` 项的值为 **`false`** :point_left:
110-
111-
::: code-group
112-
113-
``` properties:line-numbers=23 [server.properties]
114-
online-mode=false
115-
```
116-
117-
:::
118-
119-
- 对于以上所有
120-
121-
**每个**服务端都应该配置 authlib-injector，以便其能正确地处理外置登录。
122-
123-
在**每个**服务端的启动指令的 `-jar` 参数前添加如下参数。
124-
125-
::: code-group
126-
127-
``` bash-vue [需要添加的内容]
128-
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
129-
```
130-
131-
``` bash-vue [Waterfall / BungeeCord 完整的启动指令示例]
132-
java -Xms512M -Xmx512M -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar waterfall-562.jar
133-
```
134-
135-
``` bash-vue [Paper 子服务器 完整的启动指令示例]
136-
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
137-
```
138-
139-
:::
1+
---
2+
outline: [2, 3]
3+
---
4+
5+
6+
<script setup>
7+
import { ref } from 'vue'
8+
import GetAuthlibInjector from '../../components/GetAuthlibInjector.vue'
9+
10+
const latest = ref('')
11+
const updated = ref('')
12+
const download = ref('')
13+
14+
fetch('https://authlib-injector.yushi.moe/artifact/latest.json').then(r => r.json()).then(r => {
15+
latest.value = r.version
16+
updated.value = new Date(r.release_time).toLocaleString()
17+
download.value = r.download_url
18+
})
19+
</script>
20+
21+
# authlib-injector
22+
23+
> authlib-injector 为玩家提供统一的非 Mojang 登录体验。大多数的外置登录都使用 authlib-injector 来实现。
24+
25+
> [!WARNING] 这不是插件，也不是 Mod
26+
> authlib-injector 使用方式较为特殊，将其 JAR 文件放入服务端的 `plugins/` 或 `mods/` 目录下不会有任何作用。
27+
28+
## 获取 JAR 文件
29+
30+
<GetAuthlibInjector :latest="latest" :updated="updated" :download="download" />
31+
32+
下载 `authlib-injector-{{ latest }}.jar` 文件后，将其放入 **服务端启动脚本** 或 **服务端文件** 所在的文件夹中。
33+
34+
## 配置各类服务端
35+
36+
> [!TIP] 🤗 在面板服上配置 authlib-injector
37+
> 配置 authlib-injector 时不可避免地需要修改服务端启动命令/参数。
38+
>
39+
> 部分 Minecraft 服务器租赁商可能会使用 [MCSManager](https://mcsmanager.com/) 或 [Pterodactyl® Panel 翼龙面板](https://pterodactyl.io/) 等 Minecraft 服务器管理面板以便销售和管理服务器实例。
40+
>
41+
> 有些用户可能无法自行修改服务端启动命令/参数。**请与服务器租赁商沟通，让其帮助你配置。**
42+
43+
### 单服务端（非群组服）<Badge text="✨ 常用" />
44+
45+
1. 将服务器配置文件 `server.properties` 中 `online-mode` 一项的值设为 `true`
46+
47+
::: code-group
48+
49+
``` properties:line-numbers=23 [server.properties]
50+
online-mode=true
51+
```
52+
53+
:::
54+
55+
2. 在你的服务端的启动指令的 `-jar` 参数前添加如下参数
56+
57+
::: code-group
58+
59+
``` bash-vue [需要添加的内容]
60+
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
61+
```
62+
63+
``` bash-vue [完整的启动指令示例]
64+
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
65+
```
66+
67+
:::
68+
69+
- `authlib-injector-{{ latest }}.jar` 为指向 authlib-injector 的 `jar` 的路径或文件名
70+
- `https://littleskin.cn/api/yggdrasil` 为 LittleSkin 的 Yggdrasil API 地址
71+
72+
### Velocity <Badge type="tip" text="Minecraft 1.13 +" />
73+
74+
Modern forwarding 是 Velocity 支持的一种独创格式。它以高效的二进制格式转发所有玩家信息。但是，它仅适用于 Minecraft 1.13 或更高版本。
75+
76+
> [!TIP] 提示
77+
> 本文仅会对「为 Velocity modern forwarding 配置 LittleSkin 外置登录」做出说明。
78+
>
79+
> 本案例使用 Velocity + Paper 作为示例。
80+
>
81+
> 具体的 Velocity 配置请结合参考 [Velocity 文档](https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding)。
82+
83+
<!--@include: ./velocity.template.md-->
84+
85+
- 对于以上所有
86+
87+
**每个**服务端都应该配置 authlib-injector，以便其能正确地处理外置登录。
88+
89+
在**每个**服务端的启动指令的 `-jar` 参数前添加如下参数。
90+
91+
::: code-group
92+
93+
``` bash-vue [需要添加的内容]
94+
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
95+
```
96+
97+
``` bash-vue [Velocity 完整的启动指令示例]
98+
java "-Dauthlibinjector.disableHttpd" -Xms512M -Xmx512M -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar velocity-3.3.0-SNAPSHOT-351.jar
99+
```
100+
101+
``` bash-vue [Paper 子服务器 完整的启动指令示例]
102+
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
103+
```
104+
105+
:::
106+
107+
- `authlib-injector-{{ latest }}.jar` 为指向 authlib-injector 的 `jar` 的路径或文件名
108+
- `https://littleskin.cn/api/yggdrasil` 为 LittleSkin 的 Yggdrasil API 地址
109+
110+
### Waterfall / BungeeCord <Badge type="warning" text="不再推荐" />
111+
112+
BungeeCord 和 Waterfall 属于亲兄弟好姐妹，因此，以下配置同时适用于两者。
113+
114+
- 对于 Waterfall / BungeeCord
115+
116+
检查 `config.yml`，确保 `online-mode` 项的值为 **`true`** :point_left:
117+
118+
::: code-group
119+
120+
``` yaml:line-numbers=17 [config.yml]
121+
online-mode: true
122+
```
123+
124+
:::
125+
126+
- 对于子服务端
127+
128+
检查 `server.properties` 文件，确保 `online-mode` 项的值为 **`false`** :point_left:
129+
130+
::: code-group
131+
132+
``` properties:line-numbers=23 [server.properties]
133+
online-mode=false
134+
```
135+
136+
:::
137+
138+
- 对于以上所有
139+
140+
**每个**服务端都应该配置 authlib-injector，以便其能正确地处理外置登录。
141+
142+
在**每个**服务端的启动指令的 `-jar` 参数前添加如下参数。
143+
144+
::: code-group
145+
146+
``` bash-vue [需要添加的内容]
147+
-javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil
148+
```
149+
150+
``` bash-vue [Waterfall / BungeeCord 完整的启动指令示例]
151+
java -Xms512M -Xmx512M -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar waterfall-562.jar
152+
```
153+
154+
``` bash-vue [Paper 子服务器 完整的启动指令示例]
155+
java -Xms4G -Xmx16G -javaagent:authlib-injector-{{ latest }}.jar=https://littleskin.cn/api/yggdrasil -jar paper-1.20.4-409.jar --nogui
156+
```
157+
158+
:::

0 commit comments

Comments
 (0)