The ultimate administrative tool for a perfect first impression.

First Join Control gives server owners and modpack creators total authority over a player's initial entry into the world. Instead of leaving the first experience to chance, FJC allows you to orchestrate a cinematic, standardized, and helpful welcome sequence that triggers only once.

Whether you want to teleport players to a specific tutorial hub, grant them a survival kit, or simply welcome them with a grand title and sound effects, FJC handles it all through a single, easy-to-use configuration file.

✨ KEY FEATURES

Precision Spawning Set exact coordinates (X, Y, Z) and orientation (Yaw, Pitch) across any dimension.
Automated Starter Kits Define a list of items and quantities to be added to the player's inventory immediately.
Status Effects Apply temporary or permanent potion effects (such as Resistance or Regeneration) to protect new players.
Cinematic Welcomes Display high-quality titles and subtitles on the player's screen with fully customizable fade timings.
Visual & Audio Flair Trigger specific sound effects and particle clouds at the spawn location for an immersive first entry.
Global Action Delay Set a global tick delay before actions execute to ensure the player has fully loaded into the world.

🛠 CONFIGURATION EXAMPLE

The mod automatically generates a file named: fjc-common.toml

Location: config folder of your server or modpack

Each feature can be enabled or disabled independently.

EXAMPLE CONFIGURATION (TOML)

First Join Control - Configuration

[general]

Should the actions execute only on the player's first join?

first_join_only = true

Global delay in ticks before executing actions (20 ticks = 1 second)

spawn_delay = 40

[spawn] enabled = true x = 100.5 y = 64.0 z = -200.5 dimension = "minecraft:overworld" yaw = 180.0 pitch = 0.0

[items] enabled = true

Format: item_id;count

starter_items = [ "minecraft:stone_sword;1", "minecraft:bread;8", "minecraft:torch;16" ]

[effects] enabled = true

Format: effect_id;duration_ticks;amplifier

player_effects = [ "minecraft:resistance;200;1", "minecraft:regeneration;100;0" ]

[visual] enabled = true

Format: particle_id;count

particles = [ "minecraft:portal;100", "minecraft:cloud;30" ]

Format: sound_id;volume;pitch

sounds = [ "minecraft:entity.enderman.teleport;1.0;1.0" ]

[messages] enabled = true chat_message = "§aWelcome to the server!" title = "§6Welcome" subtitle = "§fYour journey begins here…" title_fade_in = 10 title_stay = 60 title_fade_out = 10