Minecraft

项目：在Minecraft里观看哔哩哔哩直播

前言

首先恭喜音MAD活动 MADCORE.wav 圆满落幕！

可惜本次活动我没去现场，哈哈。不过本次活动我主持了 Minecraft 服务器转播活动 MINECORE.jar，游戏录像可以在这里看到。

接下来我来说一下做转播选择的方案以及踩到的坑。

转播方案一

准备工作

方案一比较复杂，而且实测效果并不好。

转播链路如下：

B站直播源 -> [上海某处公网服务器 Streamlink -> MediaMTX] -> [托管Minecraft的公网服务器 WATERFrAMES模组]

需要准备如下软件：

其中 Streamlink 和 FFmpeg 需要手动添加到系统变量里，这里就不再赘述了。

配置 MediaMTX

我让 GPT 5.6 给我写了配置文件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# \mediamtx\mediamtx.yml

###############################################
# 日志
###############################################

logLevel: info
logDestinations: [stdout, file]
logFile: "C:/LiveRelay/logs/mediamtx.log"

###############################################
# RTSP输入，仅允许本机FFmpeg连接
###############################################

rtsp: true
rtspTransports: [tcp]
rtspEncryption: "no"
rtspAddress: 127.0.0.1:8554

###############################################
# 关闭不需要的协议
###############################################

rtmp: false
webrtc: false
srt: false
moq: false

###############################################
# HLS输出
###############################################

hls: true
hlsAddress: :8888
hlsEncryption: false
hlsAllowOrigins: ["*"]

# 即使暂时没有客户端，也持续生成HLS，
# 玩家进入时不需要等待第一批分片
hlsAlwaysRemux: true

# MPEG-TS兼容性最好，适合LibVLC/WATERMeDIA
hlsVariant: mpegts

hlsSegmentCount: 6
hlsSegmentDuration: 1s
hlsSegmentMaxSize: 50M
hlsDirectory: ""

###############################################
# 直播路径
###############################################

paths:
  bilibili:
    source: publisher
    maxReaders: 15

然后在终端里输入 mediamtx.exe mediamtx.yml 即可启动。

需要注意：记得设置出站规则 协议 TCP 端口 8888，否则在 MC 里无法访问推流。

我让 GPT 5.6 给我写了中继脚本，AI 太好用了你知道吗。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# \scripts\relay-bilibili.cmd
@echo off
setlocal EnableExtensions DisableDelayedExpansion

set "ROOM=https://live.bilibili.com/5055636"
set "STREAMLINK=C:\Program Files\Streamlink\bin\streamlink.exe"
set "FFMPEG=D:\Miro-Work\madcore-liverelay\ffmpeg\bin\ffmpeg.exe"
set "TARGET=rtsp://127.0.0.1:8554/bilibili"

if not exist "%STREAMLINK%" (
    echo [ERROR] Streamlink not found:
    echo %STREAMLINK%
    pause
    exit /b 1
)

if not exist "%FFMPEG%" (
    echo [ERROR] FFmpeg not found:
    echo %FFMPEG%
    pause
    exit /b 1
)

:RESTART

echo.
echo ==================================================
echo [%date% %time%] Starting Bilibili relay
echo Room:   %ROOM%
echo Target: %TARGET%
echo ==================================================
echo.

"%STREAMLINK%" ^
  --no-config ^
  --loglevel info ^
  --retry-streams 5 ^
  --retry-max 0 ^
  --retry-open 5 ^
  --ringbuffer-size 64M ^
  --stream-timeout 60 ^
  --stream-segment-attempts 5 ^
  --stream-segment-threads 2 ^
  --hls-live-edge 3 ^
  --player "%FFMPEG%" ^
  --player-verbose ^
  --player-args "-hide_banner -loglevel info -fflags +genpts+discardcorrupt -i {playerinput} -map 0:v:0 -map 0:a:0? -vf fps=30,format=yuv420p -c:v libx264 -preset veryfast -tune zerolatency -profile:v high -level:v 4.1 -b:v 4500k -maxrate 5000k -bufsize 10000k -g 60 -keyint_min 60 -sc_threshold 0 -bf 0 -refs 1 -fps_mode:v cfr -c:a aac -b:a 160k -ar 48000 -ac 2 -f rtsp -rtsp_transport tcp -muxdelay 0.1 %TARGET%" ^
  "%ROOM%" hls

set "EXITCODE=%ERRORLEVEL%"

echo.
echo [%date% %time%] Relay stopped. Exit code: %EXITCODE%
echo Restarting in 5 seconds...
timeout /t 5 /nobreak >nul
goto RESTART

直接双击打开就行，别用 PowerShell 打开。

测试

本机内可以在浏览器内输入网址 http://127.0.0.1:8888/bilibili/index.m3u8 测试推流是否正常。

缺点

实际跑起来画面很卡，可能有优化空间但是感觉不如接下来这个方案。

还有输入网址的时候有概率崩端，保险做法是直接把网址粘贴进去。

转播方案二

直接在大家的电脑里塞一个 CEF 框架，哈哈。

需要安装如下内容：

  • 模组 WebDisplays 客户端与服务端均需安装
  • 模组 MCEF 仅客户端安装

直接弄个屏幕然后输入网址就完事了，虽然所有人访问同一个网址，但是实际内容有差别，最好给每个人发一个激光笔让他们自己调。

缺点

MCEF 初次启动时会下载大量资源，然而在国内没有镜像，导致下载的特别慢。

本质就是在游戏画面内塞一个网页，而且只能让所有人同时看一个网页，网页的具体内容因人而异（因为浏览器在端侧）。

很吃内存。

音量不受游戏控制（需要自己在系统的音量合成器里调整 JCEF 的音量）。

WebDisplays 有概率会在你进入服务器的时候直接崩端，不知道什么毛病，得多次重新进服。

总结

在 MC 里搞转播就是一个坑，没有受虐癖别搞。

Minecraft

项目：又一个Minecraft窗口标题修改模组

前言

这个标题可能会让人误以为我重新造了轮子，但这个只是我分叉了别人写的模组且经过修改并再发布的版本。

我维护的一个整合包十分依赖这个模组，这个模组的优点如下：

  • 许可证允许我这么干
  • 结构简单
  • 性能不错
  • 同时支持 Fabric 和 NeoForge
  • 可以改图标而且分辨率较高，比隔壁同类型某模组不知道高到哪里去了

唯一的问题是作者已经将近十个月没有更新了，当前版本的代码早就不兼容新版 Minecraft 了。

我做了什么

遵循牢梁之力，我使用 AI 工具使这个模组获得了高版本支持，这里是代码仓库。

我使用的工具是 Claude Code + DeepSeek-V4，实际测试能跑，没有引入额外的问题，效果还是不错的。

关于 Harness 的一些碎碎念

可能会有人吐槽我怎么还在用 Claude Code，但是我base_url填的是 DeepSeek 的地址，数据不会发到A畜那里，应该也没关系。

不过我确实担心A畜会不会塞新的暗桩进去，目前我有两个打算：

  • 等 DeepSeek Harness 公开
  • 买个 ChatGPT Plus 订阅然后改用 ChatGPT(前 Codex) 狠狠蹬

我用的模型不多，我也不打算装一堆工具，反正模型就那几个，工具再多有啥用呢。

关于模型的一些碎碎念

虽然我做这个模组的时间在7月31号之前，而且主要发力的模型还是 deepseek-v4-pro。

不过听说 deepseek-v4-flash-0731 的性能好像很不错，真期待 Pro 的表现。

不过我考虑用 OpenAI 的模型，毕竟 GPT 5.6 Sol 好像是仅次于 Claude Fable 5（这个我没亲自体验过）的六边形强者。

总之无论是 Harness 也好还是模型也罢，最重要的还是使用者本身的学识更重要，所以即便是在 AI 时代，学习对应领域的知识还是很重要，否则就只能成为要靠轮椅（AI工具）行走的电棍（人类）了。

Other

恢复失效的acg.tv链接

前言

早期B站有大量转载自N站（Niconico视频网站）的内容，而B站提供了一个短链接服务用于把SM号跳转到N站。

由于现在这个acg.tv短链接已经死了（虽然他们依旧在给这个域名续费），因此我们需要通过额外的操作来恢复这个跳转功能。

如果你仍需要使用短链接跳转到N站，可以使用“nico.ms”这个网站。

安装插件

如果你使用Chromium系浏览器，可以在Chrome应用商店安装Redirector插件。

安装完成后，在插件设置里点击“Add Rule”。

在弹出窗口里输入如下内容：

1
2
3
4
5
6
7
8
Mode 在下拉菜单里选择
Regex

Match URL 输入
^https?://acg.tv/(sm\d+)

Redirect To 输入
https://nico.ms/$1

点击“Save”保存。

测试

点击这里以测试规则是否生效。

Minecraft

构建适用于Minecraft 26.1.2版本的CoreProtect插件

哦对了

Intelli 已在 Commit 6994ec2修改了代码，现在可以直接在这个仓库里下载到适用于 26.1.2 的版本，不需要自行修改代码。

下文内容已过时，仅供参考。

前言

由于目前公开发布的 CoreProtect 社区版最高仅支持 MC 1.21.10，如果需要高版本支持，就得到 Patreon 上给作者赞助。

尽管我们可以在这个仓库找到已经构建好的版本，但是只能在最高 26.1 的版本上启动，在更高的版本上插件会拒绝启动。

所幸在 CoreProtect 的 Discord 中有人分享了通过修改代码从而使 CoreProtect 在 26.1.2 上启动的构建教程，因此本文将简单介绍如何自行构建可用于高版本的 CoreProtect 插件。

需要注意的是，本文具有较强的时效性（比如作者随时可能修改代码，从而使插件可以直接用在高版本上），同时有人反馈使用新版本后会找不到历史数据，笔者不幸已中招。

准备

你需要安装 JDK 25 和 Maven。

注意选对操作系统和 CPU 架构，下载完直接按照向导安装就行（记得勾选添加系统变量 JAVA_HOME ）。

请根据这个教程下载并安装即可，看完“验证安装”那一节就可以回到本教程了。

确保 JDK 25 是你电脑上的默认 Java 版本。

开始

首先到 CoreProtect 的仓库下载源代码，一般页面上会有个显眼的绿色“Code”按钮，点一下那个按钮，在展开菜单里点击“Download ZIP”，这样就算下载下来了。

在你的下载文件夹里找到刚才下载的压缩包，找个空文件夹解压出来，然后我们要修改一些文件了。

pom.xml

  • 找到“pom.xml”文件，用文本编辑器（比如 VSCode 或者记事本）打开。

  • 找到第 7 行中，写着 <project.branch></project.branch> 的地方。

  • 改成这样 <project.branch>development</project.branch>。

ConfigHandler.java

  • 找到 src/main/java/net/coreprotect/config/ 文件夹。

  • 打开“ConfigHandler.java”文件。

  • 在第 58 行，把字符串 LATEST_VERSION 的值改为 26.1.2 。

  • 就像这样：public static final String LATEST_VERSION = "26.1.2";

构建

现在在“pom.xml”所处的那个文件夹打开 Terminal，输入 mvn clean install，程序会自动下载依赖并开始构建，等到出现“BUILD SUCCESS”字样，即可在 /target 文件夹找到编译好的插件 jar 包。

虽然文件版本是 23.2，但功能上等同于 24.0 的赞助版本。

Server Daily

自检用 meilisearch 部署教程

前言

部署起来比 ElasticSearch 简单，可惜没什么应用接入，我是接给我的 OpenList 用的。

简单到基本上跟着官方文档走就能搞出来。

安装

建议找个非 root 账号来运行 meilisearch。

1
2
# Install Meilisearch
curl -L https://install.meilisearch.com | sh

执行完毕后，当前文件夹下会多出 meilisearch 二进制可执行文件和 data.ms 文件夹。

配置

默认安装似乎不会给配置文件，我把我的配置文件贴在下面仅供参考。

新建一个 meilisearch_config.toml 放在 meilisearch 的安装目录下，然后把下面的内容粘贴进去。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# This file shows the default configuration of Meilisearch.
# All variables are defined here: https://www.meilisearch.com/docs/learn/configuration/instance_options#environment-variables

# Designates the location where database files will be created and retrieved.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#database-path
db_path = "./data.ms"

# Configures the instance's environment. Value must be either `production` or `development`.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#environment
env = "production"

# The address on which the HTTP server will listen.
http_addr = "localhost:7700"

# Sets the instance's master key, automatically protecting all routes except GET /health.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#master-key
master_key = "foobar" # 你应该为自己设置一个master key

# Deactivates Meilisearch's built-in telemetry when provided.
# Meilisearch automatically collects data from all instances that do not opt out using this flag.
# All gathered data is used solely for the purpose of improving Meilisearch, and can be deleted at any time.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#disable-analytics
no_analytics = true

# Sets the maximum size of accepted payloads.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#payload-limit-size
http_payload_size_limit = "100 MB"

# Defines how much detail should be present in Meilisearch's logs.
# Meilisearch currently supports six log levels, listed in order of increasing verbosity:  `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE`
# https://www.meilisearch.com/docs/learn/configuration/instance_options#log-level
log_level = "INFO"

# Sets the maximum amount of RAM Meilisearch can use when indexing.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#max-indexing-memory
# max_indexing_memory = "2 GiB"

# Sets the maximum number of threads Meilisearch can use during indexing.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#max-indexing-threads
# max_indexing_threads = 4

#############
### DUMPS ###
#############

# Sets the directory where Meilisearch will create dump files.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#dump-directory
dump_dir = "dumps/"

# Imports the dump file located at the specified path. Path must point to a .dump file.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#import-dump
# import_dump = "./path/to/my/file.dump"

# Prevents Meilisearch from throwing an error when `import_dump` does not point to a valid dump file.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ignore-missing-dump
ignore_missing_dump = false

# Prevents a Meilisearch instance with an existing database from throwing an error when using `import_dump`.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ignore-dump-if-db-exists
ignore_dump_if_db_exists = false


#################
### SNAPSHOTS ###
#################

# Enables scheduled snapshots when true, disable when false (the default).
# If the value is given as an integer, then enables the scheduled snapshot with the passed value as the interval
# between each snapshot, in seconds.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#schedule-snapshot-creation
schedule_snapshot = false

# Sets the directory where Meilisearch will store snapshots.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#snapshot-destination
snapshot_dir = "snapshots/"

# Launches Meilisearch after importing a previously-generated snapshot at the given filepath.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#import-snapshot
# import_snapshot = "./path/to/my/snapshot"

# Prevents a Meilisearch instance from throwing an error when `import_snapshot` does not point to a valid snapshot file.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ignore-missing-snapshot
ignore_missing_snapshot = false

# Prevents a Meilisearch instance with an existing database from throwing an error when using `import_snapshot`.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ignore-snapshot-if-db-exists
ignore_snapshot_if_db_exists = false


###########
### SSL ###
###########

# Enables client authentication in the specified path.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-authentication-path
# ssl_auth_path = "./path/to/root"

# Sets the server's SSL certificates.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-certificates-path
# ssl_cert_path = "./path/to/certfile"

# Sets the server's SSL key files.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-key-path
# ssl_key_path = "./path/to/private-key"

# Sets the server's OCSP file.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-ocsp-path
# ssl_ocsp_path = "./path/to/ocsp-file"

# Makes SSL authentication mandatory.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-require-auth
ssl_require_auth = false

# Activates SSL session resumption.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-resumption
ssl_resumption = false

# Activates SSL tickets.
# https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-tickets
ssl_tickets = false

#############################
### Experimental features ###
#############################

# Experimental metrics feature. For more information, see: <https://github.com/meilisearch/meilisearch/discussions/3518>
# Enables the Prometheus metrics on the `GET /metrics` endpoint.
experimental_enable_metrics = false

# Experimental RAM reduction during indexing, do not use in production, see: <https://github.com/meilisearch/product/discussions/652>
experimental_reduce_indexing_memory_usage = false

# Experimentally reduces the maximum number of tasks that will be processed at once, see: <https://github.com/orgs/meilisearch/discussions/713>
# experimental_max_number_of_batched_tasks = 100

部署

我自己写了一个 bash 脚本，可以直接后台启动 meilisearch。

1
2
3
4
5
#!/bin/bash

screen -S meilisearch_session -dm bash -c './meilisearch  --config-file-path="./meilisearch_config.toml"'

echo "可以使用 'screen -r meilisearch_session' 查看会话"

在安装目录里新建个文件扩展名为 .sh 的文件，然后把上面的代码粘贴进去就行了。

Server Daily

为想在 MediaWiki 上使用 ElasticSearch 的人准备的简易教程

前言

如标题所示，网上关于这方面的内容要么残缺不全，要么完全用不了。我决定按照自己成功部署的经验来分享一下我的安装教程，这里面的方法不是最佳实践，不过对于小型 Wiki 基本是完全够用的。

软件要求

  • Debian 12
  • Mediawiki 1.43.3
  • ElasticSearch 7.10.2 （CirrusSearch 只兼容7.10版）

你也可以参考官方提供的支持矩阵，但是我说白了这个页面做的很烂。

下载必要文件

首先在这里下载 Linux X86_64 版本。

可能有人看见有 deb 包就直接跑去用 dpkg 安装了，但我实际使用时总是会出现莫名其妙的问题，这也是为什么我不用 apt 安装。

随便找个自己喜欢的文件夹，cd 到那个文件夹，然后输入 wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.10.2-linux-x86_64.tar.gz 。

部署 ElasticSearch

我这里把压缩包下载到了 /opt 里，用 tar -xzf elasticsearch-7.10.2-linux-x86_64.tar.gz 把文件解压出来。

然后我们 cd 到 bin 文件夹里。

由于 root 账户不能用于运行 ElasticSearch（可能会有潜在的安全危险），接下来我们新建一个用户账户用于运行该软件。

1
2
3
groupadd elastic
useradd elastic -g elastic
usermod -L elastic # 锁定这个账号，防止不怀好意的人登录，或者在[这里](https://www.cnblogs.com/shujk/p/13797439.html)找个更安全的方法。

接下来我们开一个 screen 会话，用于运行 ElasticSearch。

1
2
3
4
screen -R ElasticSearch
pwd # 确认一下当前位置是不是 /ElasticSearch/bin，不是的话就 cd 到这里
su elastic # 切换到用于运行 ElasticSearch 的账号
./elasticsearch

因为是用 Java 写的程序，所以启动时会有点慢，一般来说到这里就能直接使用了，如果没有用的话就根据错误日志自行调整。
没问题的话直接 detach 就行了。

测试服务连通性

输入 curl -X GET "localhost:9200/?pretty" ，如果返回如下内容，则 ElasticSearch 已经可以使用了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "name" : "foobar",
  "cluster_name" : "foo",
  "cluster_uuid" : "bar",
  "version" : {
    "number" : "7.10.2",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "747e1cc71def077253878a59143c1f785afa92b9",
    "build_date" : "2021-01-13T00:42:12.435326Z",
    "build_snapshot" : false,
    "lucene_version" : "8.7.0",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

记得使用 ufw 等防火墙保护你的服务器，你也不希望自己部署的服务被滥用吧。

如果你要把 ElasticSearch 开放到公网，输入 ufw allow 9200 即可，不过你得自己折腾安全性之类的东西了。

安装 MediaWiki 插件

把下面这些插件都丢到 $MW_INSTALL_PATH/extensions 文件夹里。

配置 CirrusSearch

配置流程来自这里，我将按照我的安装方式复述一遍。

首先添加下列内容到这个文件里。

1
2
3
4
5
# ./LocalSettings.php
# Elstaic Search Configs
wfLoadExtension( 'Elastica' );
wfLoadExtension( 'CirrusSearch' );
$wgDisableSearchUpdate = true;

然后运行 CirrusSearch 目录里的维护脚本。

1
2
php $MW_INSTALL_PATH/extensions/CirrusSearch/maintenance/UpdateSearchIndexConfig.php
# 记得把 $MW_INSTALL_PATH 替换成你的 MediaWiki 安装目录。

脚本执行完毕后，删掉 $wgDisableSearchUpdate = true; 这一行。

接下来执行另一个维护脚本（关于这部分，原文针对大型 wiki 给出了解决方案，请阅读原文）。

1
2
3
php $MW_INSTALL_PATH/extensions/CirrusSearch/maintenance/ForceSearchIndex.php --skipLinks --indexOnSkip
php $MW_INSTALL_PATH/extensions/CirrusSearch/maintenance/ForceSearchIndex.php --skipParse
# 记得把 $MW_INSTALL_PATH 替换成你的 MediaWiki 安装目录。

脚本执行完毕后，在 LocalSettings.php 添加如下内容。

1
$wgSearchType = 'CirrusSearch';

额外内容

如果你需要使用 AdvancedSearch 的话，添加下列内容。

1
2
3
4
5
6
7
8
# ./LocalSettings.php
wfLoadExtension( 'AdvancedSearch' );
$wgAdvancedSearchNamespacePresets = [
	'generalHelp' => [
		'enabled' => false,
	],
];
$wgAdvancedSearchDeepcatEnabled = false;
Minecraft

Sonar——可能是目前最好的反假人解决方案

前言

其实大多时候并不缺好用的插件，只是人们不了解好插件的存在。

所以我写了这篇文章，用于分享一下我的开服经验，最主要的是介绍一些我觉得很好用的插件，以后可能会成为一个系列也说不定。

Sonar

介绍

这是一款反作弊类型的插件，可以阻止绝大多数的假人（bot）进入你的服务器。

注：这里的假人并不是生电概念上的假人，而是指使用某些软件直接向服务器发送大量数据包来制造假玩家进服，从而对服务器进行攻击。

Sonar 内置多种反假人模式，可以根据服务器实际情况自行选择，我会在下面给出一种我正在用的配置文件。

支持范围

支持平台：Java 版 1.7.2-1.21.8 | 基岩版需要通过 Geyser 才能处理

软件支持：Velocity (3.3.0 build 330或更高) | BungeeCord (1.20或更高) | Paper、Bukkit 和 Spigot (1.8.8或更高)
注意：该插件依赖 Netty 4.1（或更高），这会导致在一些低版本服务器上不可用，你可以参照插件文档来解决这个问题。

下载

下载：SpigotMC | Modrinth | GitHub

官方文档（只有英文）

安装

把插件放进 plugins 文件夹里就行了，可以通过 /sonar reload 来重载插件，所以我们可以直接修改配置文件。

如果你使用群组服架构，你只需要在 Velocity/BungeeCord 上安装即可，无需在其他服务器上安装。

配置文件

插件自带一个汉化过的配置文件，我会贴在下面，并把要改的地方标注出来。

另外，我目前只在 Velocity 上使用这个插件，不过 Paper 上的配置文件应该差不多。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
# ./sonar/config.yml

# 常规的设置
general:
  # Sonar 是否应该自动检查新的更新?
  # Sonar 使用 GitHub API 检查当前版本是否过时
  check-for-updates: false                   # <-- 建议关闭，毕竟大多时候根本连不上 Github，不如定期手动检查更新
  # Sonar 应该在控制台中打印玩家的 IP 地址吗?
  log-player-addresses: true
  # 具有相同 IP 地址的在线玩家的最大数量
  max-online-per-ip: 3

# 攻击检测器
# 只有当您知道自己在做什么的时候才应该编辑它
attack-tracker:
  # 在一段时间内至少需要多少个新玩家加入才满足触发条件?
  min-players-for-attack: 8
  # 至少经过多少毫秒后才可以解除遭受攻击模式
  # (该值为毫秒. 1秒等于1000毫秒.)
  min-attack-duration: 30000
  # 要重复检测到多少次攻击 才应该被确认为服务器正在遭受攻击?
  # 该值作为缓冲区 以避免可能的误判
  min-attack-threshold: 2
  # 当从遭受攻击状态标记为已缓解攻击状态时
  # 至少需要多少毫秒才允许为对于可能检测到的攻击重新进入遭受攻击状态?
  # (该值为毫秒. 1秒等于1000毫秒.)
  attack-cooldown-delay: 3000

# 您可以让 Sonar 连接到数据库 以便从数据库中保存和读取已经过验证的 IP 和玩家.
# 提示: IP 地址将以纯文本形式保存 请确保您的数据库安全!
database:
  # 要连接到的数据库类型
  # 可用类型: NONE (不使用数据库), MYSQL, MARIADB, H2 (本地数据库)
  type: H2        # <-- H2 足够用了，如果你服务器上有 MySQL 之类的数据库也可以用，不过不如 H2 配置简单
  # Sonar 插件目录中用于 H2 数据库的文件
  filename: verified_players
  # 数据库的地址
  host: localhost
  # 数据库的端口
  port: 3306
  # 数据库名称
  name: sonar
  # 用于登录数据库的用户名
  username: ''
  # 用于登录数据库的密码
  password: ''
  # Sonar 应该在数据库中保留在白名单中的玩家最多多少天?
  maximum-age: 5

# 在遭到攻击时 每个新玩家的登录请求将排队 以避免大量连接同时进行验证
# 队列将每1秒刷新一次
queue:
  # 每秒最多处理多少个登录请求?
  max-polls: 30

# 每个需要验证的玩家都将被发送到一个轻量级的虚拟服务器来检查高级机器人
verification:
  # Sonar 应该在什么时候验证玩家?
  # 可用类型: ALWAYS, DURING_ATTACK
  # - ALWAYS: 玩家始终需要验证 直到他们通过验证为止
  # - DURING_ATTACK: 玩家仅在服务器疑似遭到攻击时验证
  timing: ALWAYS
  checks:
    # 检查玩家的下落移动是否遵循原版客户端.
    gravity:
      # Sonar 是否应该检查玩家的下落移动? (推荐启用)
      enabled: true
      # 当玩家验证失败时 是否向他们发送地图验证码?
      captcha-on-fail: false
      # 玩家跌落在平台上多少tick后才能被算作站在平台上?
      max-movement-ticks: 8

    # 检查玩家是否可以正确地站在方块上
    collision:
      # Sonar 是否应该生成方块平台以检查玩家下落与方块之间的碰撞? (推荐启用)
      enabled: true

    # 检查客户端坐在实体上时是否发送了正确的数据包
    vehicle:
      # Sonar 是否应该让玩家坐在实体上, 以便检查他们的数据包是否合法?
      enabled: true
      # 客户端需要发送的所需的最小数据包数量
      minimum-packets: 2

    # 手持地图验证码
    map-captcha:
      # Sonar 应该在什么时候向玩家发送验证码?
      # 可用类型: ALWAYS, DURING_ATTACK, NEVER
      # - ALWAYS: 始终应用该检查
      # - DURING_ATTACK: 仅在疑似遭受攻击时应用该检查
      # - NEVER: 永远不应用该检查
      timing: NEVER
      # 用于当作验证码的背景的图片
      # 如果未找到指定的图片, 则自动通过噪音生成一个随机的背景图片.
      # 如果图片在该插件的配置文件夹下, 则可以简单地输入图片的文件名.
      background: ''
      # 地图验证码的风格（默认：'modern'）.
      # 要使用旧设计, 请将其设置为 'legacy'.
      style: 'modern'
      # Sonar 应该一次准备多少个验证码?
      precompute: 500
      # Sonar 应该给玩家多少时间完成验证码?
      # (该值为毫秒. 1秒等于1000毫秒.)
      max-duration: 30000
      # 玩家最多能输入多少次错误的验证码?
      max-tries: 3
      # 允许出现在验证码答案中的字符
      # 不建议添加可能看起来彼此相似的数字或字母
      alphabet: 'abcdefhjkmnoprstuxyz'

    # 检查玩家是否正在向服务器发送有效的客户端标识符
    client-brand:
      # 是否启用此检查? (建议启用)
      enabled: true
      # 用于检查客户端标识符的正则表达式
      valid-regex: ^[!-~ ]+$
      # 客户端标识符的最长长度限制
      max-length: 64

    # 用于检查用户名是否有效的正则表达式
    valid-name-regex: ^[a-zA-Z0-9_]+$

  # 开启后 玩家将在验证成功后被重定向到指定的服务器
  # 该功能由 Mojang 在 Minecraft 1.20.5 版本中引入
  # https://docs.jonesdev.xyz/administration/configuring-sonar/configuring-the-verification/using-1.20.5+-transfers
  transfer:
    # Sonar 是否应该将玩家重定向到指定的服务器而不是踢出玩家?
    # 为此您必须在服务器软件的配置文件中允许接受来自transfer的连接.
    # 此外 您可能希望减少 Velocity 或其它服务器软件/插件的登录速率限制
    # 因为这可能会阻止玩家快速地重新连接到服务器
    # 如果你的服务器允许 Bedrock 玩家通过 Geyser 加入, 请确保为 Geyser 设置了
    # TransferTool 扩展, 以便将 Bedrock 玩家重定向到正确的服务器.
    # https://github.com/onebeastchris/TransferTool
    enabled: false             # <-- 建议启用，可以让玩家直接切换到服务器里，无需玩家重新连接
    # 当玩家通过验证后, Sonar 应该将玩家转移到哪个服务器
    # 请输入玩家正常连接服务器时使用的服务器IP或域名
    # 例如使用域名("mc.hypixel.net") 或使用 IP 地址("1.1.1.1").
    destination-host: "play.my-server.com"                   # <-- 记得改成你服务器的 IP/域名
    # Sonar 应该告诉玩家通过以上域名的什么端口来连接到服务器?
    # 如果服务器地址不包含端口 请保留25565.
    destination-port: 25565                   # <-- 当然也别忘了改端口

  # 玩家正在验证时所使用的游戏模式
  # 可用类型: SURVIVAL, CREATIVE, ADVENTURE
  # - SURVIVAL: 生存模式, 所有UI可见
  # - CREATIVE: 创造模式, 隐藏血量和饱食度
  # - ADVENTURE: 冒险模式, 所有UI可见
  gamemode: ADVENTURE
  # 验证过程中玩家所看到的当前世界中的一天时间
  # 您可以在这里找到您想要的时间:
  # https://minecraft.wiki/w/Daylight_cycle
  # 该选项不会改变验证过程.
  # 如果该值设置为 1000, 则不会发送数据包.
  time-of-day: 1000
  # Sonar 缓存它发送到客户端的大部分数据包, 包括 LoginSuccess 数据包.
  # Sonar 应该使用哪个用户名来接收 LoginSuccess 数据包?
  # 如果不修改客户端, 用户名将不会对玩家可见
  cached-username: "Sonar"
  # 当 Sonar 尝试验证玩家时 是否在控制台中打印有关玩家的信息?
  log-connections: true
  # Sonar 是否应该在攻击期间内打印日志?
  log-during-attack: false
  # Sonar 是否应该记录验证过程中玩家的移动位置的变化?
  # 有助于发现错误 但不建议在生产环境下的服务器启用该选项.
  debug-xyz-positions: false
  # Sonar 是否应该检查来自 Geyser 的(基岩版)玩家?
  # 此功能是实验性的. 请报告任何因为误判而导致无法通过检查的问题
  # 如果关闭该选项 Sonar 将不检查这些玩家以便直接连接到服务器.
  check-geyser-players: false
  # 播放器断开连接前停止发送数据包的时间
  # (该值为毫秒. 1秒等于1000毫秒.)
  read-timeout: 8000
  # 服务器在断开玩家连接前停止发送数据包的时间
  # (该值为毫秒. 1秒等于1000毫秒.)
  write-timeout: 10000
  # The maximum number of packets the client is allowed to send in total (during verification).
  max-packets: 325
  # 当玩家在还未通过检查的情况下断开连接后需要等待多少毫秒才可以重新连接?
  # (该值为毫秒. 1秒等于1000毫秒.)
  rejoin-delay: 5000
  # 当玩家验证失败后, Sonar 应该记住他多久?
  # (该值为毫秒. 1秒等于1000毫秒.)
  remember-time: 120000
  # 黑名单应在多少秒后过期? (可能由于频繁验证失败. 在黑名单中将会被拒绝进入服务器.)
  # (该值为毫秒. 1秒等于1000毫秒.)
  blacklist-time: 600000
  # 玩家必须验证失败多少次才会被列入黑名单? (设置为0以完全禁用)
  blacklist-threshold: 2
  # 黑名单中的协议将阻止所有使用该协议的客户端.
  # 您可以在 https://wiki.vg/Protocol_version_numbers 找到所有协议号
  # 例如 Minecraft 1.20 对应的协议号为763.
  blacklisted-protocols: []

原理

插件模拟了一个假的服务器用于给客户端发包（别的啥也干不了），通过测试客户端行为与分析客户端发回的数据包来判断连入的玩家是不是机器人。

因为玩家首先连入的是 Sonar 模拟的假服务器，所以需要配置 transfer 来将玩家转移到真正的服务器。

备注

Sonar 的官网在这里。

目前比较流行的 Sonar 版本是 2.x，而官网上正在售卖 Sonar 3.x，Sonar 3 包括云端检测，但它是付费的。

我仍建议你使用免费的 Sonar 2，毕竟对于大多数中小型服务器，免费版就足够用了。

Minecraft

内网穿透后让 Velocity 获取玩家真实 IP 的方法

由于本土运营商对公网 IP 管控十分严格，有不少 Minecraft 服主会选择使用内网穿透服务来开设服务器。

但是以这种网络结构开设的服务器有一个问题，服务端无法拿到玩家的真实 IP（内网穿透会导致玩家的 IP 都变成 127.0.0.1）。

这会导致部分涉及处理玩家 IP 的功能完全无法使用，比如某些管理插件提供的 /banip IP 封禁功能，因为所有玩家的 IP 都是一样的，执行这个指令后会导致所有玩家都会被封禁。

本文将为有这类困扰的服主提供解决方案。

Case:1 纯代理线路入服

配置 frpc

在 frpc 配置文件中添加下面一行：

1
2
3
4
5
# .\frpc.toml

[[proxies]]
... # 省略隧道的其他信息，不要复制这一行
transport.proxyProtocolVersion = "v2" # 在已有隧道添加这一行即可

修改完需要重启 frpc 后才会生效。

如果你使用的是 SakuraFrp（比如我），可以看此处的文档。

配置 velocity.toml

在 Velocity 的配置文件中，启用如下配置项。

1
2
3
4
# .\velocity.toml

[advanced]
haproxy-protocol = true

重启 Velocity 后，配置项即生效。

Case:2 直连与代理并用

经过 Case:1 对服务器进行设置后，你会发现直连线路无法访问。为了解决这个问题，我们需要请出接下来的妙妙工具。

HAProxyReduce，是 HAProxyDetector 的替代品，支持 Paper/Folia/Velocity。

把它放进 Velocity 工作目录下的 plugins 文件夹就行了。

安装好插件后，先启动一下 Velocity，让插件把默认配置文件吐出来，然后关掉代理端，我们需要调整一下插件配置。

进入 /plugins/haproxy-reduce，打开 whitelist.conf。

1
2
3
4
5
# ./whitelist.conf

127.0.0.0/8 # 默认配置
::1/128 # 默认配置
example.com # 在这里写上玩家连接服务器要用的那个域名就行了，不用写端口号，没域名就写 IP 地址

其他类型的服务端开启 HAproxy 的方法

正在使用 BungeeCord/Waterfall、Paper 及其分支、Geyser 的话，请看这篇文档。

如果你使用的是 Spigot，请继续使用 HAProxyDetector，你可以在这里找到中文的使用方法。

如果你正在使用较新的 Paper 及其分支或 Velocity，换成 HAProxyReduce。

Server Daily

自检用 frp 搭建教程

材料（大嘘）：

  • 服务端：Windows Server 2022 (21H2) | 有公网 | 位于上海某处
  • 客户端：Debian 12 | 有公网 | 位于天津某处
  • frp 版本：v0.64.0

目标：搭建一条用于某 Minecraft 服务器的加速线路。

Step1 下载 frp

最近在网上搜到某个冒充 frp 官方文档的使用 WordPress 搭建的网站，请认准真正的官方文档。

先在此处下载构建好的二进制包，记得看好操作系统和 CPU 架构，如果你找不到的话，记得点下“Show all assets”展开。

另外特别提醒，不要搞混 amd64 和 arm64 ！！！

Step2 安装 frps

由于我使用的服务端是 Windows 操作系统，以下内容仅针对 Windows，你可以在这里找到在 Linux 系统上部署 frps 的教程。

随便找个自己喜欢的文件夹，把压缩包里的“frps.exe”和“frps.toml”解压到这个文件夹里。

frps 的默认端口是 7000，如果你需要改到其他端口，可以修改 frps.toml。

1
2
3
4
# .\frps.toml
bindPort = 11451 # 此处可以换成任意合法的端口号，注意不要开在已经被占用的端口上

auth.token = "foo" # 密钥，防止被陌生人滥用，建议设置的复杂点

接下来，在文件夹窗口按住 Shift 键右键空白处，点击“在此处打开 PowerShell 窗口”。

在 PowerShell 中，输入 .\frps.exe -c .\frps.toml ，即可启动 fprs。

顺便一提，别忘了给 frps 开放必要的端口（比如防火墙、路由器端口转发等）。

Step2.1 使用 MCSManager 管理 frps

这一步非必需，你也可以用自己的方法管理 frps。

如果你正好部署过 MCSManager，那么恭喜你，你获得了一个可以远程管理+自动启动 frps 的工具。

当然，部署 MCSManager 的方法这里不再赘述，去看官方文档。

首先，在 MCSManager Web（以下简称面板）上新建应用，选择直接创建，选择服务器（如果有），然后填写一下名称和启动命令（上面有，就是在 PowerShell 里输的那条），设置好后就可以创建实例了。

不过别着急，我们还需要设置一下才能用。打开你刚创建的实例，在“应用实例设置 -> 高级设置”里，把工作目录改成 frps 所在文件夹，记得点保存。

然后，在“事件任务”里，按需勾选“自动重启”和“自动启动”，记得点保存。

最后点一下右上角那个绿色的启动按钮，测试一下是否正常。如果没有报错，那么恭喜你，frps on mcsm 已成功部署。

Step3 安装 frpc

因为我这里的客户端是 Linux 系统，所以我需要重新下载一个适用于 Linux 的二进制包，如果你的客户端还是 Windows，那你可以重复使用刚才下载的压缩包。

随便找个能把文件上传到服务器的软件，把压缩包里的“frpc”和“frpc.toml”解压到合适的文件夹里，我这里把工作目录选在了 /opt/frpc。

上传好文件后，开始修改 fprc 的配置文件。

1
2
3
4
5
6
7
8
9
10
11
# .\frpc.toml
serverAddr = "server.address" # 服务端的公网地址
serverPort = 11451 # 你之前在 frps 设置的那个端口
auth.token = "foo" # 你在 frps 上设置的那个密钥

[[proxies]]
name = "Minecraft" # 隧道名称
type = "tcp" # 连接类型，对于 Java 版，选 TCP 就行
localIP = "127.0.0.1" # 服务器 IP，如果服务器在同一台机器的话就写“127.0.0.1”
localPort = 23300 # 服务器端口，跟 server.properties 里的 server-port 写一样的就行
remotePort = 23303 # 设置服务端那边的端口，希望你还记得要在防火墙开放端口

设置好后，就可以使用这个命令 ./frpc -c ./frpc.toml 启动 frpc 了。

如果启动不了的话，别忘了检查 frpc 的执行权限。可以用 sudo chmod 755 /opt/frpc/frpc 来赋予权限（记得换成你自己的路径）。

记得测试一下隧道能否连通，一般来说连接地址应该是 serverAddr:remotePort。

Step3.1 使用 MCSManager 管理 frpc

实际上和用 MCSManager 管理 fprs 的步骤差不多。

在面板上新建应用，选择直接创建，选择服务器（如果有），然后填写一下名称和启动命令，设置好后就可以创建实例了。

别着急，我们还需要设置一下才能用。前往你刚创建的实例，在“应用实例设置 -> 高级设置”里，把工作目录改成 frpc 所在文件夹，记得点保存。

然后，在“事件任务”里，按需勾选“自动重启”和“自动启动”，记得点保存。

最后点一下右上角那个绿色的启动按钮，测试一下是否正常。如果输出内容如图所示，那么恭喜你，frpc on mcsm 已成功部署。

Miro

Intro

这道彩虹的尽头会是什么颜色
会是只属于两人的光波吗

/ 介绍 /

省去无趣的自我介绍吧，欢迎来到专属于我的树洞！

/ 近况 /

Unity Engine 和 Godot Engine 双修中，如果学 Unity 是为了找工作，那么学 Godot 就是纯粹的为爱好了。

我喜欢看别人玩那种短流程恐怖游戏，所以我也想试着做相同类型的游戏。

/ 爱好 /

  • 喜欢打音游，目前在玩 Arcaea、Rotaeno 和舞萌DX。
  • 玩 Minecraft，我正在运营一个公益服。

/ 社交账号 /

目前可以公开的情报：

我的 GitHub： Trcmoe
我的个人群 QQ 群号：1055184287
闲暇之余我会尝试运营我的B站频道，点个关注谢谢喵。