search
🗨️ Discord♥️ Sponsor

hashtag
💬 messages.yml Reference

Want your plugin to match your server's vibe? The messages.yml file lets you customize every single message players see. Whether you're running a serious roleplay server or a meme-filled chaos realm, you've got full control.

circle-info

Location: plugins/TrialChamberPro/messages.yml

After making changes, reload with /tcp reload

---

hashtag
🎨 Color Codes & Formatting

All messages support Minecraft color codes using &:

hashtag
Colors

&0 - Black          &8 - Dark Gray
&1 - Dark Blue      &9 - Blue
&2 - Dark Green     &a - Green
&3 - Dark Aqua      &b - Aqua
&4 - Dark Red       &c - Red
&5 - Dark Purple    &d - Light Purple
&6 - Gold           &e - Yellow
&7 - Gray           &f - White

hashtag
Formatting

hashtag
Examples

prefix

Prepended to most messages. Keep it short!

Examples:

  • Minimalist: "&8[&6TCP&8] "

  • Fancy: "&8[&6⚔ &eTrialChamber&6 ⚔&8] "

  • Roleplay: "&7[&5Ancient Chamber&7] "

  • No prefix: "" (empty string)

hashtag
Chamber Management

Placeholders:

  • {chamber} - Chamber name

  • {world} - World name

  • {volume} - Total blocks in chamber

Customization ideas:

Minimalist:

Fancy:

Roleplay:

hashtag
Scanning

Placeholders:

  • {chamber} - Chamber name

  • {vaults} - Number of vaults found

  • {spawners} - Number of trial spawners found

  • {pots} - Number of decorated pots found

  • {error} - Error message (on failure)

Examples:

Tech-style:

Adventure-style:

hashtag
Snapshots

Placeholders:

  • {chamber} - Chamber name

  • {blocks} - Block count

  • {size} - File size (e.g., "1.2 MB")

  • {error} - Error message

Examples:

Loading bar vibes:

Immersive:

hashtag
Chamber Resets

Placeholders:

  • {chamber} - Chamber name

  • {time} - Time remaining (e.g., "5m 30s")

  • {error} - Error message

Examples:

Urgent/dramatic:

Calm/informative:

Roleplay/lore:

hashtag
Vaults

Placeholders:

  • {type} - Vault type: "Normal" or "Ominous"

  • {time} - Cooldown time remaining

  • {player} - Player name

  • {required_type} - Key type needed

Examples:

Excited/rewarding:

Mystical:

Gameplay-focused:

hashtag
Trial Keys

Placeholders:

  • {amount} - Number of keys

  • {type} - "Normal" or "Ominous"

  • {player} - Player name

  • {normal} - Normal key count

  • {ominous} - Ominous key count

hashtag
Statistics

Placeholders:

  • {player} - Player name

  • {count} - Stat count

  • {time} - Formatted time (e.g., "2h 15m")

Customization:

Clean list:

Game-style:

hashtag
Leaderboards

Placeholders:

  • {stat} - Stat type (e.g., "Chambers Completed")

  • {rank} - Player's rank (1, 2, 3...)

  • {player} - Player name

  • {value} - Stat value

Examples:

Medal system:

With actual medals for top 3 (requires creative formatting):

hashtag
Chamber Completion & Entry

Placeholders:

  • {chamber} - Chamber name

  • {player} - Player name

Examples:

Achievement-style:

Subtle:

Dramatic:

hashtag
Protection

Customization:

Strict:

Funny:

Immersive:

hashtag
Teleportation

Placeholders:

  • {chamber} - Chamber name

Examples:

Magical:

Simple:

hashtag
Chamber Info

Placeholders:

  • {chamber} - Chamber name

  • {world} - World name

  • {minX}, {minY}, {minZ}, {maxX}, {maxY}, {maxZ} - Coordinates

  • {volume} - Block count

  • {exit} - Exit location or "Not set"

  • {interval} - Reset interval (e.g., "48 hours")

  • {time} - Last reset time

  • {count} - Count of vaults/spawners

  • {status} - Snapshot status

hashtag
Time Formatting

Placeholders:

  • {days}, {hours}, {minutes}, {seconds} - Time values

Used for cooldowns, reset timers, etc. Combined like: "2d 5h 30m"

Examples:

Verbose:

Ultra-minimal:

hashtag
System Messages

Shown when commands are used before the plugin finishes async initialization.

hashtag
Info Display Format

Placeholders:

  • {x}, {y}, {z} - Coordinates

These are displayed as values in the chamber info command output.

hashtag
Spawner Waves

Placeholders:

  • {type} - Spawner type: "Trial" or "Ominous"

  • {killed} - Number of mobs killed

  • {total} - Total mobs expected

  • {duration} - Time to complete (e.g., "1m 30s")

  • {wave} - Wave number

Examples:

Celebratory:

Competitive:

hashtag
Spectator Mode

Placeholders:

  • {chamber} - Chamber name

Examples:

Encouraging:

Roleplay:

hashtag
GUI Action Messages

Placeholders:

  • {chamber} - Chamber name

  • {count} - Number of players

  • {seconds} - Time in seconds

  • {error} - Error message

  • {value} - Setting value (e.g., "5 minutes", "Enabled")

  • {type} - Vault/loot type: "Normal" or "Ominous"

  • {table} - Loot table name

  • {item} - Item type name

  • {pool} - Pool name

  • {setting} - Setting name

Customization:

Tech-style:

Immersive:

hashtag
Help Messages

Customize the entire help menu to match your server's command style!

Examples:

Compact:

Detailed:

hashtag
🎯 Complete Theme Examples

hashtag
Minimalist Theme

Vibe: Clean, no-nonsense, modern.

hashtag
Fantasy/Roleplay Theme

Vibe: Immersive, magical, story-driven.

hashtag
Competitive/PvP Theme

Vibe: Intense, competitive, action-focused.

hashtag
Casual/Friendly Theme

Vibe: Friendly, approachable, lighthearted.

hashtag
🌍 Multi-Language Support

Want to support multiple languages? You can create separate message files!

  1. Copy messages.yml to messages_es.yml (Spanish), messages_fr.yml (French), etc.

  2. Translate all messages

  3. Use a language switcher plugin to change which file is loaded per-player

    circle-info

    Note: TrialChamberPro doesn't have built-in per-player language switching (yet), but you can manually swap files and reload for server-wide language changes.

    .

hashtag
💡 Pro Tips

circle-check

Test your messages! Trigger each message in-game to see how it looks in chat. Some look great in the config but ugly in-game.

circle-exclamation

Don't overdo colors. Too many colors = eyesore. Stick to 2-3 main colors for consistency.

circle-info

Use prefixes wisely. If you have a very long prefix, consider shortening it or removing it entirely for certain messages (like warnings).

hashtag
🎨 Color Palette Ideas

hashtag
Earthy/Natural

  • Primary: &a (green), &e (yellow)

  • Accent: &6 (gold), &7 (gray)

hashtag
Mystical/Magical

  • Primary: &d (light purple), &5 (dark purple)

  • Accent: &b (aqua), &f (white)

hashtag
Tech/Modern

  • Primary: &b (cyan), &f (white)

  • Accent: &7 (gray), &8 (dark gray)

hashtag
Fire/Danger

  • Primary: &c (red), &6 (gold)

  • Accent: &4 (dark red), &e (yellow)

hashtag
🔄 Applying Changes

After editing messages.yml:

All messages update immediately. No restart needed!

hashtag
❓ Common Questions

"Can I remove the prefix from all messages?" Yes! Set prefix: "" (empty string).

"What if I want different prefixes for different message types?" You'll need to manually add prefixes to individual messages instead of using the global prefix.

"Can I use hex color codes?" Not in the current version, but it's planned for a future update!

"What if I mess up the YAML formatting?" The plugin will fail to load messages and log errors. Always backup before editing!

"Can I add custom messages for my own plugins?" TrialChamberPro only uses the messages defined here. For custom messages, you'd need to modify the plugin or request new placeholder support.

hashtag
🎯 What's Next?

You've completed the configuration trilogy! 🎉

Check out the guides for hands-on usage:

Now go make those messages uniquely yours! ✨

PreviousLoot.ymlNextYour First Chamber

Last updated