home products documents terms contact shop (coming soon!)

Language Configuration

Customize messages and add translations.

Customize all CobbleRanked messages in config/cobbleranked/language/.

Available Languages

FileLanguage
en-Us.json5English (default)
ja-Jp.json5Japanese

Setting Language

Edit config/cobbleranked/config.yaml:

# config.yaml
language: "ja-jp"  # en-us or ja-jp

Reload with /rankedadmin reload.

Message Structure

{
  "queue": {
    "joined": "&aYou joined the {format} queue!",
    "left": "&eYou left the queue.",
    "already_in": "&cYou're already in queue."
  },
  "battle": {
    "start": "&a&lBattle starting!",
    "win": "&6&l🎉 Victory!",
    "lose": "&c&lDefeat..."
  }
}

Placeholders

Messages support dynamic placeholders:

PlaceholderDescription
{player}Player name
{opponent}Opponent name
{format}Battle format
{elo}Current ELO
{elo_change}ELO gained/lost
{rank}Current rank
{season}Season name

Creating Custom Languages

  1. Copy en-Us.json5 to new file (e.g., ko-Kr.json5)
  2. Translate all strings
  3. Set language in config

Example Messages

English

{
  "queue": {
    "joined": "&aYou joined the {format} queue!",
    "match_found": "&6Match found! Click to accept."
  },
  "elo": {
    "gained": "&a+{elo_change} ELO &7(Now: {elo})",
    "lost": "&c-{elo_change} ELO &7(Now: {elo})"
  }
}

Japanese

{
  "queue": {
    "joined": "&a{format}キューに参加しました!",
    "match_found": "&6対戦相手が見つかりました!クリックして承認。"
  },
  "elo": {
    "gained": "&a+{elo_change} ELO &7(現在: {elo})",
    "lost": "&c-{elo_change} ELO &7(現在: {elo})"
  }
}

Hot Reload

Language changes apply immediately:

/rankedadmin reload

See Also