# GreetCraft<\/p>\n
\n
\n<\/p>\n
A lightweight, fully configurable Paper plugin that welcomes players with rich, formatted join messages powered by MiniMessage.<\/p>\n
## Features<\/p>\n
– **MiniMessage support** \u2014 Gradients, hex colours, decorations, and more via the MiniMessage standard
\n– **Broadcast messages** \u2014 Optionally announce joins to the entire server
\n– **Placeholder system** \u2014 Inject player name, world, online count, and other dynamic values
\n– **Live reload** \u2014 Apply config changes without restarting via `\/greetcraft reload`
\n– **Graceful fallback** \u2014 Automatically uses legacy formatting on Spigot\/Bukkit where MiniMessage is unavailable
\n– **Fine-grained permissions** \u2014 Control access at a per-feature level
\n– **Minimal footprint** \u2014 Designed to have negligible impact on server performance
\n– **Modern API usage** \u2014 Built against Paper’s latest APIs<\/p>\n
## Requirements<\/p>\n
| Requirement | Minimum |
\n|—|—|
\n| Java | 17 |
\n| Minecraft | 1.20 |
\n| Server software | Paper 1.20+ (see [Compatibility](#compatibility)) |<\/p>\n
## Installation<\/p>\n
1. Download the latest release from Modrinth.
\n2. Place the `.jar` file into your server’s `plugins\/` directory.
\n3. Restart the server. Avoid using `\/reload confirm` in production environments.
\n4. Edit `plugins\/GreetCraft\/config.yml` to your liking.
\n5. Run `\/greetcraft reload` to apply changes without a restart.<\/p>\n
## Configuration<\/p>\n
The configuration file is generated automatically at `plugins\/GreetCraft\/config.yml` on first run.<\/p>\n
“`yaml
\n# Enable MiniMessage formatting.
\n# Set to false to use legacy (&) formatting codes instead.
\nuse-minimessage: true<\/p>\n
# Message sent privately to the joining player. # Whether to broadcast a message to all online players when someone joins. # Message broadcast to all players on join. # Set to true to suppress the default “Player joined the game” message. ## Placeholders<\/p>\n These placeholders can be used in any message field within `config.yml`.<\/p>\n | Placeholder | Description | ## MiniMessage Formatting<\/p>\n When `use-minimessage: true` is set, you can use the full MiniMessage tag syntax in your messages.<\/p>\n “`yaml # Rainbow text # Hex colour # Combined tags For a full reference of available tags, see the MiniMessage Documentation.<\/p>\n ## Commands<\/p>\n | Command | Description | Permission | **Aliases:** `\/gc`, `\/greet`<\/p>\n ## Permissions<\/p>\n | Node | Description | Default | ## Compatibility<\/p>\n | Platform | Support level | MiniMessage formatting requires Paper or a Paper fork. On Spigot and Bukkit, the plugin automatically falls back to standard `&`-based formatting codes.<\/p>\n ## Contributing<\/p>\n Bug reports and feature requests are welcome.<\/p>\n – **Modrinth:** Use the issue tracker on the Modrinth project page When reporting a bug, please include your server software, version, and a full copy of any relevant error output from the console.<\/p>\n ## Licence<\/p>\n This project is released under the [MIT Licence](LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":" A powerful and configurable Paper Server plugin that greets players with beautiful, formatted messages when they enter the server.<\/p>\n","protected":false},"featured_media":78010,"template":"","meta":{"_minecraft_slug":"greetcraft","_minecraft_project_id":"JUBzjUml","_minecraft_author":"leotrax3d","_minecraft_license":"MIT","_minecraft_downloads":19,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"greetcraft.zip","_minecraft_size_bytes":10990,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:36:13.137183Z","_minecraft_date_created":"2026-02-19T07:42:34.855497Z","_minecraft_date_modified":"2026-02-26T19:23:16.431538Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/greetcraft","_minecraft_icon_attachment_id":78010,"_minecraft_imported_at":"2026-06-04T11:58:39+00:00","_minecraft_import_hash":"e6d3b78ed6f9f4d264a842399a3798bd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,125,89,126,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-78009","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nwelcome-message: ‘
\nbroadcast-join: true<\/p>\n
\nbroadcast-message: ‘
\noverride-join-message: false
\n“`<\/p>\n
\n|—|—|
\n| `%player%` | The joining player’s username |
\n| `%displayname%` | The joining player’s display name |
\n| `%world%` | The name of the world the player joined in |
\n| `%online%` | The current number of online players |<\/p>\n
\n# Colour gradient
\nwelcome-message: ‘
\nwelcome-message: ‘
\nwelcome-message: ‘<#00ff00>Welcome, %player%!<\/#00ff00>‘<\/p>\n
\nwelcome-message: ‘
\n“`<\/p>\n
\n|—|—|—|
\n| `\/greetcraft` | Displays plugin version and information | `greetcraft.use` |
\n| `\/greetcraft reload` | Reloads `config.yml` without a restart | `greetcraft.reload` |<\/p>\n
\n|—|—|—|
\n| `greetcraft.use` | Access to the `\/greetcraft` command | `true` |
\n| `greetcraft.reload` | Access to `\/greetcraft reload` | `op` |
\n| `greetcraft.*` | Grants all GreetCraft permissions | `op` |<\/p>\n
\n|—|—|
\n| Paper | Full support (recommended) |
\n| Purpur | Full support |
\n| Folia | Full support |<\/p>\n
\n– **GitHub:** Open an issue or pull request on the GitHub repository<\/p>\n