Waiting Screen Mod

A powerful server-side mod that creates customizable waiting rooms for your Minecraft Fabric server. Perfect for events, minigames, or any situation where you need players to wait before starting.

Features

Custom Images: Display any image as a waiting screen background
Player Counter: Real-time display of waiting players (e.g., “3/10 players”)
Server-Side Control: No client mod required – works with vanilla clients
ESC Menu Lock: Prevents players from accessing menus while waiting
Exempt System: Bypass waiting for specific players (admins, VIPs)
Easy Configuration: Simple commands to manage waiting screens
Multiple Screens: Switch between different waiting screen images

Usage

Basic Commands

/waitingscreen start <players> – Start waiting room (requires specified number of players)
/waitingscreen stop – End waiting and release all players
/waitingscreen screen <name> – Change the displayed image
/waitingscreen exempt <player> – Add player to exempt list
/waitingscreen unexempt <player> – Remove player from exempt list

Setup

Install the mod in your server’s mods/ folder
Add your custom images to config/waitingscreens/
Use commands to control the waiting room

Requirements

Minecraft 1.21.1
Fabric Loader
Fabric API

Configuration

Images must be placed in the config/waitingscreens/ directory. Supported formats: PNG, JPG

Use Cases

Event lobbies
Minigame waiting rooms
Tournament preparation
Server queue systems
Custom game modes

License

This project is licensed under the MIT License.

Bug Reports

Found a bug? Report it on the GitHub Issues page.

常见问题

waitingscreenmod 支持哪些 Minecraft 版本？

waitingscreenmod 支持 Minecraft Java 版 1.21.1，可用的加载器：Fabric。下载时注意选择和你游戏版本一致的文件。

waitingscreenmod 怎么安装？

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名下面。运行环境：客户端和服务端都要装。

介绍