Join Screen v1.0

Most servers drop players straight into the game with nothing but a chat message. There is no first impression, no branding moment, no reason for a new player to stop and look.

JoinScreen fixes that. When a player joins, they are greeted by a fully customizable GUI welcome screen rendered through your server resource pack. You control every item, every texture, every command that runs when a button is clicked. A separate first-join screen plays once and then switches to the default screen for every subsequent login. Configurable fullscreen fade transitions give the handoff a polished, premium feel.

This is not a chat message. It is an arrival.



The flow is designed to be seamless from the moment a player connects:

1. Player joins - Blindness and invulnerability are applied automatically while the resource pack loads.
2. Resource pack loads - A configurable sound plays, effects are removed, and the welcome screen opens.
3. Player sees the screen - A chest GUI (up to 54 slots) with custom textures, items, lore, and click actions.
4. Player clicks Advance - Commands run, optional fullscreen fade plays, and the player enters the server.

The screen is force-advance by default - players cannot close it without clicking the advance button. Every step is configurable.



◆ Welcome Screen

• Chest GUI inventory, up to 54 items with full slot control
• Custom item names, lore, material, and CustomModelData per slot
• Per-item commands: run as player or as console on click
• Force-advance mode prevents closing without clicking the advance button
• Configurable open delay, configurable show-once-per-session

◆ First-Join Screen

• Separate screen displayed only on a player's very first join
• Persisted in data.yml - never shown again after first advance
• Same full feature set as the default welcome screen
• Ideal for rules, introductions, or character creation flows

◆ Fullscreen Fade

• Configurable fade-in, stay, and fade-out durations in ticks
• Rendered through the resource pack via a Unicode overlay character
• Triggers on advance or manually via /joinscreen fade
• Works with any custom overlay texture you provide

◆ Resource Pack Handling

• Auto-applies blindness and invulnerability until the pack loads
• Kicks players who decline the resource pack with a custom multi-line message
• Configurable kick on failed download
• Plays a configurable sound when the pack finishes loading
• Bundled resource pack template auto-extracts and zips on first run

◆ Chat Customization

• Hide join and quit messages entirely
• Custom join and quit messages with {player} and PlaceholderAPI support

◆ Unicode & Resource Pack Integration

• Configurable Unicode characters for background, fade overlay, and title textures
• Easy integration with Oraxen, ItemsAdder, or any existing resource pack
• Override any Unicode mapping without touching the source code

◆ Multi-Language Support

• 2 built-in languages: English and Polish
• All messages use legacy color codes with hex (&#RRGGBB) support
• Language switch is a single line in config.yml
• Missing keys fall back gracefully to English

• Lobby and hub servers Greet every player with a branded welcome screen before they enter your network. Make the first moment count.
• RPG and adventure servers Show a starting screen with class selection, rules acceptance, or lore introduction on first join. The first-join screen fires exactly once.
• Survival and SMP Present server rules, discord links, or donation info before players enter the world. Force-advance mode guarantees they see it.
• Network owners Single-command install, full reload support, no restarts for config changes. Drop it in any game mode running Paper 1.21+.

Bundled template, auto-extracted and zipped on first run



◆ Commands



◆ Permissions