Skip to content

Commit

Permalink
格式修改,语义优化
Browse files Browse the repository at this point in the history
  • Loading branch information
Radiation-pi committed Nov 3, 2024
1 parent 8f1209b commit ee005da
Show file tree
Hide file tree
Showing 11 changed files with 93 additions and 69 deletions.
2 changes: 1 addition & 1 deletion docs-java/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar_position: 1

👋 欢迎来到笨蛋开服教程 **Java** 板块!

此板块是一篇主要针对 **高版本 Java 版** 服务器的开服指南,而非**基岩版****远古核心**
此板块是一篇主要针对 **高版本 Java 版** 服务器的开服指南,而非 **基岩版****远古核心**

# 开始你的旅程

Expand Down
2 changes: 1 addition & 1 deletion docs-java/start/basic/server-file-structure.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ sidebar_position: 3
└─region
```

对于类似 Catserver 的混合服务器,文件夹结构是类似的,基本就多了 mods 文件夹,少了 Bukkit 的下游服务器特有的配置(如 `purpur.yml` 等)。
对于类似 Catserver 的混合服务器,文件夹结构是类似的,基本就多了 `/mods` 文件夹,少了 Bukkit 的下游服务器特有的配置(如 `purpur.yml` 等)。

:::info

Expand Down
32 changes: 24 additions & 8 deletions docs-java/start/basic/server-management-command.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ sidebar_position: 10
:::danger
不要尝试在frp上使用这个指令,你会惊奇的发现,所有人都进不去
不要尝试在 frp 上使用这个指令,你会惊奇的发现,所有人都进不去
:::
Expand All @@ -69,20 +69,36 @@ sidebar_position: 10
## /plugins
看到服务器所有安装的插件(玩家也可以执行此指令)
看到服务器所有安装的插件,这个指令的权限默认是打开的,所有人都能看到。
如果你不想玩家看到插件列表,你可以使用 `Plugin Hide Pro` 插件
如果你不想玩家通过指令获取插件列表,可以将以下权限设置为 `false`

```

Check failure on line 76 in docs-java/start/basic/server-management-command.md

View workflow job for this annotation

GitHub Actions / deploy

Fenced code blocks should have a language specified

docs-java/start/basic/server-management-command.md:76 MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md040.md

Check failure on line 76 in docs-java/start/basic/server-management-command.md

View workflow job for this annotation

GitHub Actions / deploy

Fenced code blocks should have a language specified

docs-java/start/basic/server-management-command.md:76 MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md040.md
bukkit.command.plugins
bukkit.command.version
bukkit.command.help
```
通过简单的权限设置,玩家将无法通过指令获取服务器的插件列表,但某些作弊客户端
能够通过分析 tab 补全,利用某些版本的漏洞,获取服务器插件列表。
如果介意被获取插件,可以安装 `Plugin Hide Pro` 或 `CommandWhiteist` 插件
## /op [玩家名称]
给予指定玩家OP(操作员)权限
给予指定玩家 OP(操作员)权限
## /deop [玩家名称]
解除玩家的 OP 权限
:::danger
千万不要随意给玩家OP,恶意玩家可以使用此权限损坏服务器,甚至入侵宿主机
千万不要随意给玩家 OP ,恶意玩家可以使用此权限损坏服务器,甚至入侵主机。
:::
需要注意,OP 间可以互相 deop,只要一个人获取了 OP 就能下掉其他所有的 OP,
## /deop [玩家名称]
这是一个非常危险的权限,如果可能,请用权限管理插件而不是给一堆 OP
解除玩家的OP权限
:::
4 changes: 3 additions & 1 deletion docs-java/start/basic/what-is-datapack.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,9 @@ sidebar_position: 6

# 数据包注意事项

数据包是存在加载顺序的,在数据包各个功能同一个分类下不同的加载顺序会导致不同的结果也就是不同的覆盖产生。这个顺序存储在 `world/level.dat` 。您可以通过单人创建存档时调整数据包的位置决定数据包的加载顺序
数据包是存在加载顺序的,在数据包各个功能同一个分类下不同的加载顺序会导致不同的结果也就是不同的覆盖产生。

这个顺序存储在 `world/level.dat` 。您可以通过单人创建存档时调整数据包的位置决定数据包的加载顺序

您可以通过 `/datapack` 查看已经加载或未加载的数据包

Expand Down
2 changes: 1 addition & 1 deletion docs-java/start/basic/what-is-mod.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Minecraft 模组( Mod )一般来说模组会利用 Forge 或 Fabric 作为前置

## 安装位置

插件是需要安装在服务器根目录的 `mods` 文件夹,然后需要**重启**服务器。
插件是需要安装在服务器根目录的 `/mods` 文件夹,然后需要 **重启** 服务器。

## 模组的优点

Expand Down
4 changes: 2 additions & 2 deletions docs-java/start/basic/what-is-namespace.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ sidebar_position: 8

例如,在上面的比喻中:

- 左侧的 IDa.txt 表示为 命名空间A:IDa.txt
- 右侧的 IDa.txt 表示为 命名空间B:IDa.txt
- 左侧的 ID a.txt 表示为 命名空间 A:ID a.txt
- 右侧的 ID a.txt 表示为 命名空间 B:ID a.txt

## 物品

Expand Down
4 changes: 2 additions & 2 deletions docs-java/start/basic/what-is-nbt.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ sidebar_position: 9

## 概念

> NBT(二进制命名标签,NamedBinary Tags)格式是一种由众多的标签所组成的树状数据结构。在Minecraft中,其被广泛用于向存档文件中存储数据。所有的标签都有一个独立的数字ID和名称,以及一个负载。
> NBT(二进制命名标签,NamedBinary Tags)格式是一种由众多的标签所组成的树状数据结构。在Minecraft中,其被广泛用于向存档文件中存储数据。所有的标签都有一个独立的数字 ID 和名称,以及一个负载。
>
>另一种玩家更熟悉的是字符串形式的NBT,通常在命令里使用。这种格式常被称为SNBT(字符串化的二进制命名标签,Stringified NBT)。
> 另一种玩家更熟悉的是字符串形式的 NBT ,通常在命令里使用。这种格式常被称为 SNBT(字符串化的二进制命名标签,Stringified NBT)。
用大白话说,就是描述:

Expand Down
28 changes: 14 additions & 14 deletions docs-java/start/config-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar_position: 5

## 笨蛋脚本

[下载](https://dl.yizhan.wiki/windows-latest/config-eazy.exe),我们会询问一些问题,帮你**自动配置**
[下载](https://dl.yizhan.wiki/windows-latest/config-eazy.exe),我们会询问一些问题,帮你 **自动配置**

目前可以配置的

Expand Down Expand Up @@ -64,9 +64,9 @@ level-seed=

:::note

你可能会发现一些结构,比如村庄的生成,并不会遵循种子,是由于 `Spigot` 及其下游服务端加入了随机种子,地形的生成也会出现一些偏差
你可能会发现一些结构,比如村庄的生成,并不会遵循种子,是由于 `Spigot` 及其下游服务端加入了随机种子,

一些服务端也会添加一些地形生成优化补丁,通常会小范围改变地形生成
地形的生成也会出现一些偏差,一些服务端也会添加一些地形生成优化补丁,通常会小范围改变地形生成

当然,你仍然可以利用种子定位群系,比如找史莱姆区块

Expand Down Expand Up @@ -117,7 +117,7 @@ spawn-protection=16
allow-nether=true
```

设置为`false`可以禁用地狱
设置为 `false` 可以禁用地狱

## 默认游戏模式

Expand All @@ -138,7 +138,7 @@ gamemode=survival
force-gamemode=false
```

如果设置为`true`,玩家加入后将会被强制改为默认游戏模式
如果设置为 `true` ,玩家加入后将会被强制改为默认游戏模式

## 结构生成

Expand Down Expand Up @@ -168,7 +168,7 @@ allow-flight=true

:::warning

最好将此值设为`true`,无论你是否需要飞行,如果你需要反飞行,请查看反作弊一章
最好将此值设为 `true`,无论你是否需要飞行,如果你需要反飞行,请查看反作弊一章

:::

Expand All @@ -178,13 +178,13 @@ allow-flight=true

## 游戏规则

这一部分的配置需要使用`/gamerule`来完成,而非`server.properties`
这一部分的配置需要使用 `/gamerule` 来完成,而非 `server.properties`

[全部](https://minecraft.fandom.com/zh/wiki/%E6%B8%B8%E6%88%8F%E8%A7%84%E5%88%99#%E6%B8%B8%E6%88%8F%E8%A7%84%E5%88%99%E5%88%97%E8%A1%A8)

:::tip

请注意,默认情况下`/gamerule`所设置的游戏规则**只会在**执行命令的世界**生效**
请注意,默认情况下 `/gamerule` 所设置的游戏规则**只会在**执行命令的世界**生效**

[Ultimate Gamerules Manager](https://www.spigotmc.org/resources/ultimate-gamerules-manager-1-13-1-20-3.102215/) 是个不错的插件,适合新手

Expand All @@ -194,24 +194,24 @@ allow-flight=true

是否在聊天框中公告玩家进度的达成。

开启:`/gamerule announceAdvancements true`
开启: `/gamerule announceAdvancements true`

关闭:`/gamerule announceAdvancements false`
关闭: `/gamerule announceAdvancements false`

### 死亡不掉落

设置为true时,死亡时玩家的背包物品和经验值会得到保留。

设置为false时,重生后玩家的物品和部分经验值会掉落在死亡位置。

开启:`/gamerule keepInventory true`
开启: `/gamerule keepInventory true`

关闭:`/gamerule keepInventory false`
关闭: `/gamerule keepInventory false`

### 记录管理员使用过的命令

是否在服务器日志中记录管理员使用过的命令。

开启:`/gamerule logAdminCommands true`
开启: `/gamerule logAdminCommands true`

关闭:`/gamerule logAdminCommands false`
关闭: `/gamerule logAdminCommands false`
53 changes: 29 additions & 24 deletions docs-java/start/install-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,44 +7,45 @@ sidebar_position: 3

:::tip

该教程是为 Mod 服所编写的,插件和混合直接新建文件夹扔进去就完事
该教程是为** Mod **所编写的,插件和混合直接新建文件夹扔进去就完事

:::

全篇以 1.20.4 Mod 服务端安装为例子

如果你看不懂可以使用
[笨蛋脚本](https://dl.yizhan.wiki/windows-latest/select-server.exe)
目前不支持 Fabric
全篇以 1.20.4 Mod 服务端安装为例子,如果看不懂可以使用[笨蛋脚本](https://dl.yizhan.wiki/windows-latest/select-server.exe) **(目前不支持 Fabric)**

## Forge

首先,来到 [Forge 官方网站](https://files.minecraftforge.net/net/minecraftforge/forge/)
### Installer 下载

或者国内下载镜像:[MCSL](https://sync.mcsl.com.cn/core/Forge)
首先,来到 [Forge 官方网站](https://files.minecraftforge.net/net/minecraftforge/forge/)或国内下载镜像 [MCSL](https://sync.mcsl.com.cn/core/Forge)

![](_images/install/1.png)

在左边的 `Minecraft Version` 找到你需要的版本,然后下载下来
在左边的 `Minecraft Version` 找到你需要的版本,然后点击。

![](_images/install/2.png)

请选择 `Installer` ,左边右边都无所谓,打开后,你会来到一个广告窗口,点击最上面的 `SKIP`(没有出现就等一会)

![](_images/install/3.png)

然后你就成功下载了 Forge Installer,但还没有完!,继续
然后你就成功下载了 `Forge Installer`,由于 MC 的 eula 限制,我们需要去单独下载一个 `Minecraft server` 本体

### Minecraft server 下载

在浏览器中输入链接 `https://bmclapi2.bangbang93.com/version/这里填你的MC版本/server`

在浏览器中输入链接
`https://bmclapi2.bangbang93.com/version/这里填你的MC版本/server`
比如 1.20.4 服务器应该是 `https://bmclapi2.bangbang93.com/version/1.20.4/server`

比如我 1.20.4 服务器应该是 `https://bmclapi2.bangbang93.com/version/1.20.4/server`
下载下来后,你需要将文件重命名为 `minecraft_server.这里填你的MC版本.jar`

下载下来后,你需要将文件重命名为`minecraft_server.这里填你的MC版本.jar`,比如我1.20.4服务器应该是`minecraft_server.1.20.4.jar`,现在你的目录应该长这样
比如 1.20.4 服务器应该是 `minecraft_server.1.20.4.jar` ,现在你的目录应该长这样

![](_images/install/4.png)

接着打开cmd,不会请查看[开启 cmd](launch-server.md#笨蛋脚本),输入以下命令
### 执行安装

接着打开 cmd,不会请查看[开启 cmd](launch-server.md#笨蛋脚本),输入以下命令

````shell
java -jar forge-1.20.4-49.1.2-installer.jar(这里请改成你下载的文件名) --installServer
Expand All @@ -54,28 +55,32 @@ java -jar forge-1.20.4-49.1.2-installer.jar(这里请改成你下载的文件名

## NeoForge

与Forge差不多,官网换[这个](https://neoforged.net/)
与 Forge 差不多,官网换[NeoForge 官网](https://neoforged.net/)

## Fabric

首先前往 Fabric 的[官网](https://fabricmc.net/),或者[下载镜像](https://sync.mcsl.com.cn/core/Fabric)
首先前往 Fabric 的[官网](https://fabricmc.net/)或者[下载镜像](https://sync.mcsl.com.cn/core/Fabric)

然后点击中间那个蓝色的下载按钮
然后点击中间那个蓝色的下载按钮,Fabric 有两种下载方案

Fabric 有两种下载方案,这里我们两个都讲
### 方法 1

进入新页面后点击中间的蓝色下载按钮,此时你会下载一个安装器

点击 服务端 然后依次根据提示进行安装,注意选择空文件夹
点击 **服务端** 然后依次根据提示进行安装,注意选择空文件夹

全部选择完毕后点击安装,等待安装结束

结束后一定一定要点击 下载服务端 以便下载香草服务端(模组服务端都需要这玩意),如果你懒得配置启动脚本也可以点击 生成 按钮让它给你整一个临时的
结束后一定一定要点击 **下载服务端** 以便下载原版服务端(模组服务端都需要这玩意),

如果你懒得配置启动脚本也可以点击 **生成** 按钮让它给你生成一个临时的。

### 方法 2

如果你觉得这种方案太麻烦,回到刚才的网页去点击下方的 Minecraft Server
回到刚才的网页去点击下方的 `Minecraft Server`

依次根据提示进行安装,或者使用底下的安装命令进行快捷安装(限 Linux 用户)

下载完成后拖进空文件夹,随后新建脚本文件将启动命令复制到其中保存
下载完成后拖进空文件夹,随后新建脚本文件将启动命令复制到同一文件夹下,

启动服务器,等待后续安装,出现 Done 等语句后视为安装成功
双击启动服务器,等待后续安装,出现 `Done` 等语句后视为安装成功
4 changes: 2 additions & 2 deletions docs-java/start/launch-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ java -Xms2G -Xmx2G -jar 核心名.jar --nogui

## 最初的开启

双击启动脚本后,大概率会卡在你会看到 Downloading mojang_x.x.x.jar,请耐心等待
双击启动脚本后,大概率会卡在你会看到 `Downloading mojang_x.x.x.jar`,请耐心等待

一旦下载完成,他会提示:

Expand Down Expand Up @@ -166,7 +166,7 @@ java -Xms2G -Xmx2G -jar server.jar --nogui

![](_images/5.png)

此时,你只需要把`xxx.jar.jar`改成`xxx.jar`就可以正常启动了
此时,你只需要把 `xxx.jar.jar` 改成 `xxx.jar` 就可以正常启动了

### Invalid initial heap size: -Xms

Expand Down
Loading

0 comments on commit ee005da

Please sign in to comment.