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 (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