First join Control

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