Configuration

⚙️ Configuration (config.yml)

The config.yml is the heart of the plugin. Here's a breakdown of the most important settings:

General Settings

Setting	Description	Default
debug	Enable debug mode for detailed logs.	false
defaultLang	The language used if a player hasn't chosen one yet.	en_us
languageDetectionDelay	Delay (in ticks) before detecting player language on join.	100

Storage

Setting	Description	Default
storage.type	Where player data is saved. Options: yaml, sqlite, mysql.	yaml
storage.mysql.host	MySQL server host.	localhost
storage.mysql.port	MySQL server port.	3306
storage.mysql.database	MySQL database name.	iglanguages
storage.mysql.user	MySQL user.	root
storage.mysql.password	MySQL password.	password

Performance

Setting	Description	Default
performance.translationCacheSize	L1 cache for raw translations (before placeholder parsing).	500
performance.parsedMessageCacheSize	Cache for fully-parsed messages (with placeholders resolved).	1000

ProtocolLib

Setting	Description	Default
protocollib.enabled	Enables automatic packet translation via ProtocolLib.	true
protocollib.cacheSize	Cache size for processed packet translations. Cached results expire after 5 minutes.	200

See ProtocolLib-Hook for full details on how packet translation works.

Redis (Cross-Server Sync)

Setting	Description	Default
redis.enabled	Enable Redis pub/sub for syncing language changes across servers.	false
redis.host	Redis server host.	localhost
redis.port	Redis server port.	6379
redis.password	Redis password (leave empty for no auth).	""
redis.use-ssl	Use SSL for Redis connection.	false

Actions

Setting	Description	Default
firstJoinActions	List of actions executed when a player joins for the first time.	(see config)
actionsOnSet.<lang>	Per-language actions executed when a player sets/changes their language.	(see config)

Available Action Types

Action	Syntax	Description
message	message: <text>	Sends a normal message to the player
centered_message	centered_message: <text>	Sends a centered message to the player
playsound	playsound: <sound>;<volume>;<pitch>	Plays a sound for the player
playsound_resource_pack	playsound_resource_pack: <sound>;<volume>;<pitch>	Plays a resource pack sound
console_command	console_command: <command>	Executes a command as console (%player% for player name)
player_command	player_command: <command>	Makes the player execute a command

---

Next: ProtocolLib-Hook