Minecraft plugin CustomJoinMessages

🔌 About CustomJoinMessages

CustomJoinMessages — is a Minecraft plugin that lets server owners fully customize join and leave messages, play optional sounds, and configure first‑join greetings per permission group. The plugin focuses on simple, permission‑based join/leave control for Spigot/Paper servers and generates a configurable config.yml on first run.

🎯 Purpose

CustomJoinMessages solves the need to show different join/leave messages (and optional per‑player messages/sounds) depending on permissions. It reduces the need for multiple custom scripts and allows admins to manage messages centrally via config.yml. Use cases:

• Distinguish join/leave messages for ranks (VIP, staff, default).
• Show a global announcement and a private message to the joining player.
• Play a sound when a player joins or on first join.

⚙ Main features

• Permission‑based message sections (customjoinmessages.message.).
• First‑join messages (global and player messages) with optional sound.
• Per‑section global chat messages and player private messages.
• Play configurable sounds (sound name, pitch, volume).
• Reload configuration at runtime via command. ()

🧩 Who is this for

CustomJoinMessages is suitable for small to medium Survival, RPG and hub servers that need simple, permission‑driven join/leave customization without heavy dependencies. It is lightweight and aimed at server admins who prefer config‑based control rather than GUIs or database integrations.

🏗 Examples

• Add a vip section to play a special sound and show a VIP join banner to the server while sending a private welcome to the player.
• Use first‑join configuration to greet new players globally and play a level‑up sound for them only.
• Create several permission keys to give staff silent join messages while regular players see global announcements. ()

⌨️ Commands

Note: the plugin exposes the main command as /customjoinmessages with alias /cjm; the only confirmed subcommand documented is reload. ()

🔐 Permissions

(These permission nodes are named in the official resource; message nodes are used per config key. Defaults are those commonly applied: message nodes require assignment, while reload is typically op‑level.) ()

⚙ Installation

📥 Install

• Download the plugin .jar from the official resource page.
• Place the .jar in your server plugins/ folder.
• Restart the server (do not use /reload).
• On first startup the plugin will generate its folder and config.yml with example sections. ()

📦 Dependencies

• No external dependencies are listed in the official resource. CustomJoinMessages runs without Vault/PlaceholderAPI/ProtocolLib according to the documentation. ()

🧾 Configuration

• The plugin generates a config.yml on first run with example first-join-message, messages sections, sound settings, and variables (%player%, %server%).
• Configurable entries include global-message, player-message, and global-sound (sound-name, pitch, volume).
• The plugin uses permission keys to select which message section applies to a player. ()

Database support

• No MySQL/SQLite/database configuration is present in the official documentation. If your workflow requires persistent storage beyond config files, the official resource provides no information. ()

🧠 Additional information

• Known conflicts: the official resource does not list specific conflicts. As with any join/leave plugin, expect interaction with other plugins that also modify join/leave messages (double messages) unless those are disabled or coordinated. ()
• Limitations: documented and tested for Minecraft 1.13 on the official resource; newer compatibility is not documented on that page. ()
• Metrics / bStats: not listed in the official resource.
• Discord support / official support channels: not listed on the official resource.

❓ FAQ

Q: How do I add a custom join message for VIPs? A: Add a new section under messages: in config.yml (e.g. vip:) with join, leave, global-message and optional global-sound. Give VIP players the permission customjoinmessages.message.vip. ()

Q: Can I play a sound when someone joins? A: Yes — each message section can define global-sound with sound-name, pitch, and volume. The plugin uses standard Bukkit sound names. ()

Q: How do I reload changes to config.yml without restarting the server? A: Use the reload command: /customjoinmessages reload (or /cjm reload) if you have customjoinmessages.reload permission. ()

Q: Does the plugin send a private welcome message to the joining player? A: Yes — player-message entries are sent privately to the joining player and can be configured per section. ()

🤝 When this plugin is useful

If you need a lightweight, config‑driven way to control join/leave visibility and sounds per permission group on a Spigot/Paper server, CustomJoinMessages provides a focused solution without extra dependencies. The plugin is best when you prefer simple YAML configuration over GUIs or database backends. ()