# Hello, chat!
\nA small plugin, that allows players to use smiles in the Minecraft server chat.
\nIt works together with a server (client) resource pack, which contains a file
\nwith custom smiles.<\/p>\n
_The main features of this small plugin are:_
\n* Small size;
\n* **Advanced customization**: the ability to change plugin messages in config.yml,
\nadd or remove smiles for every taste, depending on the server datapack;
\n* The ability **to use multiple placeholders** for a single smile (it will be useful, e.g., when used together with plugins that integrate Discord with the minecraft server);
\n* The plugin uses **its own access control system** for smiles: now it isn’t needed to pile up the server permissions with perms for each smile!
\n* The ability to copy the placeholder of a smile by simply pressing the LMB in the chat;
\n* The ability to assign premium smiles.<\/p>\n
# So, what’s the first step?
\nThe main configuration file of the plugin can be divided into two parts:
\n* message texts;
\n* smiles definition.<\/p>\n
In the **message texts section**, you can write absolutely any text for each situation (lack of rights, wrong player, etc.).
\nSo instead of the prefix **Smindless**, you can, for example, use the name of the server. Keep in mind that messages support color schemes.<\/p>\n
As for the **smiles definition section**, it consists of a set of smiles with the following format:
\n“`
\n[Smile Key]:
\n inputs: “:placeholder_1:,:placeholder_2:,…,:placeholder_N:”
\n output: Decoded unicode symbol
\n premium: true\/false
\n“`
\n**Smile key** is the key that will need to be specified in the commands for managing access rights to the smile.
\nIt should be any set of characters **without a space**.<\/p>\n
**Inputs** is what the player must type in the chat in order for the text to turn into a smile. Must have a format `:sometext:`.
\nMultiple placeholders are separated by a comma. Keep in mind that it is preferable to have a short placeholder if you do
\nnot want the player to manually enter text for a long time to convert into a smile. <\/p>\n
**Output** is what any of the typed placeholders will turn into.<\/p>\n
**Premium** indicates whether this smile is a premium. It can be `true`, `false`, or omitted. If omitted, it is considered as `false`.<\/p>\n
For example, for the next smile
\n“`
\ncute:
\n inputs: “:cute:”
\n output: “\u9003”
\n“`
\n> Wow, it’s sooo cute!:cute: <\/p>\n
will turn into<\/p>\n
>Wow, it’s sooo cute!\u9003<\/p>\n
This hieroglyph turns into a beautiful smile face with a server datapack. The first file
\nfrom the datapack contains a sequence of unicode characters on the 90th page, and the second file
\ndisplays these characters in the chat, respectively. The size of the second file is 768 by 786 pixels. This file contains 16 by 16 images (smiles).
\nIt’s easy to guess that the size of one smile with this file size will be 48 by 48 pixels. The file size can be reduced or increased,
\nbut do not use sizes where the size of the smile will have fractional values!<\/p>\n
# Main commands After that, you can check the list of smiles through the command You may have noticed _gray smiles_ in the screenshots – these are the smiles that the player won’t be able to send, The next pair of commands is to grant or revoke premium smiles. In order not to mess with access control commands, it is also possible to view lists of available smiles from other players, That’s all for now! Keep in mind that access to smiles is stored in the plugin folder in two sub-folders – _ban-list_ and _premium-list_. # NOTICE At the moment, the plugin hasn’t been sufficiently tested due to the lack of human resources for testing (interaction with Discord hasn’t been fully investigated, but its support is expected). Please let me know in the telegram bot if you find a problem.<\/p>\n # License # Do you have a question or proposal? A small plugin that allows players to use smiles in the minecraft server chat.<\/p>\n","protected":false},"featured_media":143941,"template":"","meta":{"_minecraft_slug":"smindless","_minecraft_project_id":"Jvaat6nx","_minecraft_author":"Ortodontalio","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":109,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smindless.zip","_minecraft_size_bytes":73281,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:33:57.604972Z","_minecraft_date_created":"2024-04-08T01:58:47.857767Z","_minecraft_date_modified":"2024-04-07T16:40:22.126240Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smindless","_minecraft_icon_attachment_id":143941,"_minecraft_imported_at":"2026-06-08T14:15:08+00:00","_minecraft_import_hash":"1bcec15ee1eab2b7c7e4037d9a24fa59","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,867,129],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94],"class_list":["post-143940","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4"],"yoast_head":"\n
\nThe only command provided by the plugin is \/smi<\/code>. Next, flags are used for certain operations.
\nThe most important operation that must be performed at the beginning of the server work, or every time the list of smiles in config.yml is changed, is \/smi reload<\/code> or \/smi r<\/code>.
\n> \/smi r<\/b><\/code> – loads a list of smiles into memory so that they become available to players
\n> (or overloads the list if there have been changes; you don’t need to overload the server every time,
\n> it is enough to execute this command if there have been changes)<\/p>\n\/smi list<\/code> or \/smi l<\/code>.
\n> \/smi l<\/b><\/code> – get a list of smiles. In this menu, you can use the LMB to copy some smile, then paste it into the chat.
\n> 
\n> If you hover the mouse over some smile, you can see its placeholders – this is the text that needs to be printed in order
\n> for the smile to appear in the chat when sending a message.
\n> <\/p>\n
\neven if the player copies or enters a placeholder. This is because this smile has been banned for the player or
\nthe player doesn’t have premium access for this smile. To block or allow the use of a smile, there are commands
\n\/smi b {playerName} {smilePlaceholder}<\/code> and \/smi ub {playerName} {smilePlaceholder}<\/code>, respectively.
\n> \/smi b {playerName} {smilePlaceholder}<\/b><\/code> – the command to block the possibility of using the smile from the specified player.
\n> Please use placeholders, not the smiles themselves, for all access control commands.
\n> 
\n> After blocking, the smile will turn gray, which means that there is no access to this smile.
\n>
\n> \/smi ub {playerName} {smilePlaceholder}<\/b><\/code> – it works the same way, only on the contrary, it unlocks the smile.<\/p>\n
\n> \/smi g {playerName} {smilePlaceholder}<\/b><\/code> – grants the right of access to the premium smile to the specified player.
\n> 
\n> \/smi ug {playerName} {smilePlaceholder}<\/b><\/code> – works the same way, only it takes away access rights to the premium smile.<\/p>\n
\nas well as to give and take away rights using LMB.
\n> \/smi pl {playerName}<\/b><\/code> – show a list of smiles for the specified player.
\n> Use the LMB to give or take away the rights to a certain smile from the player.
\n> <\/p>\n
\nSo you can also add or remove smiles’ keys (these are the keys from the config.yml file, not placeholders!)<\/b> from players through files in these sub-folders.<\/p>\n
\nAt the moment, **there are only 7 smiles in the resource pack. For smiles to work, you must have disabled Unicode font support in the language selection menu in the game!**<\/p>\n
\nThis project uses the [GNU AGPLv3 license (GNU Affero, GNU Affero General Public License Version 3)](COPYING).<\/p>\n
\nIf you have any suggestions, ideas, and also bugs found, please contact the telegram bot,
\nI will try to answer you as soon as possible, and I will be glad to receive your messages.
\nPlease do not write spam or insults, otherwise you will be blocked.<\/p>\n","protected":false},"excerpt":{"rendered":"