SimpleEmojis

SimpleEmojis

SimpleEmojis is a lightweight Minecraft server plugin that allows players to use Unicode emojis in chat by typing simple placeholders like `:skull:`. No resource packs are required — it works purely server-side with default Minecraft Unicode support.

---

Features

- Replace placeholders like `:skull:`, `:heart:`, or `:smile:` with their Unicode emoji equivalents in chat. - Easily configurable emoji mappings via `config.yml`. - Add or remove emoji mappings dynamically with commands. - Compatible with other chat formatting plugins; keeps your prefixes and colors intact. - Tab completion for main commands and emoji placeholders.

---

Installation

1. Download the latest SimpleEmojis `.jar` file. 2. Place it into your server’s `plugins` folder. 3. Start or reload your server to generate the default `config.yml`. 4. Customize emojis in the `plugins/SimpleEmojis/config.yml` file or use commands.

---

Usage

Emoji Placeholders in Chat

Type any emoji placeholder in chat wrapped with colons. Example: ` Hello :skull: world! ` will display as: ` Hello 💀 world! `

---

Commands

All commands require permissions unless you are OP by default.

`/simpleemojis <list|reload|help>`

- help — Shows all currently loaded emoji placeholders and their Unicode equivalents. - help — Reloads the plugin configuration from disk. - help — Displays help and usage information.

Permission: `simpleemojis.admin` (default OP)

---

`/addemoji <placeholder> <emoji>`

Add a new emoji mapping on the fly. The placeholder single Unicode emoji character (`:example:`), and the emoji must be a single Unicode emoji character.

Example: ` /addemoji :star: ⭐ ` Result: Typing `:star:` in chat will show ⭐.

Permission: `simpleemojis.add` (default OP)

---

`/removeemoji <placeholder>`

Remove an existing emoji mapping by its placeholder.

Example: ` /removeemoji :star: `

Permission: `simpleemojis.remove` (default OP)

---

Permissions

| Permission | Description | Default | |----------------------|-------------------------------------------|-----------| | `simpleemojis.admin` | Access `/simpleemojis` commands (list, reload, help) | OP | | `simpleemojis.add` | Use `/addemoji` command to add emojis | OP | | `simpleemojis.remove`| Use `/removeemoji` command to remove emojis | OP |

---

Configuration (`config.yml`)

The configuration contains a map of placeholders to Unicode emojis:

` emojis: ":skull:": "💀" ":heart:": "❤️" ":smile:": "😄" ":fire:": "🔥" `

- Placeholders must be quoted if they contain colons (`:`). - You can edit this file manually or use commands to add/remove emojis. - After editing, reload the config with `/simpleemojis reload`.

---

Support & Contributions

For bug reports or feature requests, please open an issue on the GitHub repository

Contributions and pull requests are welcome!

---

License

MIT License © TomMustBe12

---

Thank you for using SimpleEmojis! 🎉 Make your chat fun and expressive.