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

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 (like Resistance or Regeneration) to protect new players.
• 🎆 Cinematic Welcomes: Display high-quality titles and subtitles on the player's screen with customizable fade times.
• 🎵 Visual & Audio Flair: Trigger specific sound effects and particle clouds at the spawn location for an immersive entry.
• ⏱️ Global Action Delay: Set a specific tick delay before actions trigger to ensure the player has fully loaded into the world.

🛠️ Configuration Example

The mod generates a fjc-common.toml file in your server's config folder. Every feature can be toggled independently.

# 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