BuildContest 插件
BuildContest 是一个 Velocity 插件,用于简化建筑竞赛中为每个团队设立专用服务器的设置流程。该插件使用 Docker Compose 启动子服务器,并自动将玩家转移至对应的子服务器参与竞赛。团队配置和服务器信息会持久化存储。
功能特性
- 自动创建子服务器:通过 HTTP API 调用 Docker Compose 创建团队服务器,并将其注册到 Velocity。
- 自动玩家转移:当玩家加入主服务器时,会自动被转移到其所属的子服务器。
- 权限控制:使用 Bearer Token 对 HTTP 请求进行身份验证。
- 防止重复参与:在添加团队时,如果某玩家已存在于其他团队,则无法加入其他团队。
安装步骤
-
准备环境
- 安装 Velocity 代理服务器。
- 确保已安装并正确配置 Docker 和 Docker Compose。
-
创建 Minecraft 竞赛服务器镜像(子服务器)
- 建议使用 Little Wrench 作为服务器基础。
- 将端口设置为
25565,并确保通过代理可以正确访问,包括正确的forwarding-mode设置。 - 创建一个用于构建服务器镜像的 Dockerfile。
- 构建镜像,例如执行
docker build -t minecraft-contest:latest . - 创建一个
docker-compose.yml文件以启动子服务器。
-
下载插件
- 前往 版本页面
-
配置插件
- 将插件 jar 文件放入 Velocity 的
plugins/目录中。 - 首次启动 Velocity 服务器以生成配置文件,然后停止服务器进行调整。
- 将插件 jar 文件放入 Velocity 的
-
配置文件说明
- 修改
plugins/BuilderContest/目录下的config.yml以设置端口和其他参数。 - 将
docker-compose-default.yml放置在插件目录中,作为启动子服务器的模板。
- 修改
-
启动服务器
- 启动服务器,并从生成的
config.yml中获取bearer-token。
- 启动服务器,并从生成的
配置文件说明
config.yml
ktor:
http-port: 8080 # HTTP 服务端口。
port-start: 30000 # 子服务器的起始端口。
bearer-token: # Bearer Token;首次使用时请留空。
allow-host: "*" # 允许的宿主地址。
docker-compose-default.yml 示例
- 使用
#SERVER_NAME_PLACEHOLDER作为 Docker 容器名称的占位符。 - 使用
#SERVER_PORT_PLACEHOLDER作为端口的占位符。
version: '3.8'
services:
minecraft_server:
image: minecraft-contest:latest
container_name: "#SERVER_NAME_PLACEHOLDER"
ports:
- #SERVER_PORT_PLACEHOLDER:25565
volumes:
# 将本地世界目录挂载到容器内的指定路径
- ./worlds/#SERVER_NAME_PLACEHOLDER/world:/app/world
environment:
EULA: "TRUE"
restart: unless-stopped
使用说明
HTTP API
- 插件启动后,默认会在端口
8080上启动一个 HTTP 服务。 - 关键 API 端点:
- 添加团队:
POST /team/add,需要 Bearer Token 认证,载荷字段包括teamId、teamName和members。
- 添加团队:
请求示例
curl --location --request POST 'http://localhost:8080/team/add' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sSCj4piDoEfV2zIo_C8lD7S4ul0YlVOyBr2BkKpdsTI (从 config.yml 中获取)' \
--data-raw '{
"teamId": "team_1",
"teamName": "Team 1",
"members": ["Hanamizu_", "user1"]
}'
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧