# ChatPings - A Minecraft Server Plugin! ![About](https://i.imgur.com/vMwmokj.png) ChatPings is a plugin that allows you to ping other players like you do in Discord. This plugin can be customized from the ping color and sound to it's sound's volume and pitch! ![Ping Types](https://i.imgur.com/NHZZ2iv.png) This plugin allows you to ping players using three different ping types: - @Player (Pings the certain player via username or EssentialsX nickname) - @everyone (Pings everyone who's on the server) [This requires a permission node] - @someone (Pings a random player that's currently online (even yourself if this option is enabled)) Each ping also plays a sound that you can change in the config.yml, as well as pitch and volume of the sound! ![Commands](https://i.imgur.com/U3lGin9.png) There are commands that can be used by everybody and some that are admin only. #### Admin Commands: - /pingreload: Reloads the config.yml and the lang.yml so they use the new settings you've set. - /pingprefix: Changes the prefix you used for pings. - /pinginfo: Shows information about ChatPings. - /pingresetcooldown : Resets the cooldown time for the player. #### Player Commands: - /pinghelp: Shows a list of commands of this plugin. - /pingtoggle: "Mutes pings" by not playing the sound.* *Players who have the permission node "chatpings.bypass" can bypass the player's ping mute, therefore you'll hear their ping sounds. ![Permissions](https://i.imgur.com/ShwmGFI.png) #### Admin Permissions: - chatpings.admin Permission node for /pingreload, viewing admin commands in /pinghelp and to ping everyone. (Default OP) - chatpings.bypass Permission node to bypass the ping mutes of players (Default OP) #### Player Permissions: - chatpings.help Permission node for /pinghelp. (Default TRUE) - chatpings.toggle Permission node for /pingtoggle. (Default TRUE) - chatpings.player Permission node to ping another player. (Default TRUE) - chatpings.someone Permission node to ping another player. (Default TRUE) ![Ping Pop-Up](https://i.imgur.com/mIiWIVd.png) Ping Pop-Up is a brand new feature in ChatPings that shows who pinged you through for example a title, actionbar or bossbar. Here are the different types you can choose: - title (Shows the text in the middle of the screen) - subtitle (Same as the title, but in smaller) - actionbar (Shows the text above the hotbar) - boss* (Shows the text in a bossbar with the healthbar being a countdown until it disappears) - everything (This option does not require an explaination, does it?) - none (Basically does not show any Pop-Up at all) Apart from that you can also choose how long these pop-ups shall stay on the screen. *The Bossbar Pop-Up only works for version 1.19+! ![Config](https://i.imgur.com/YxsVO0l.png) ``` ping: Prefix: '@' everyoneFormat: everyone someoneFormat: someone placeholder: enter placeholder here pingcooldown: enabled: true duration: player: 5 someone: 5 everyone: 5 everyonePing: color: '&b&l' sound: ENTITY_EXPERIENCE_ORB_PICKUP volume: 3.0F pitch: 0.5F playerPing: color: '&b&l' sound: ENTITY_EXPERIENCE_ORB_PICKUP volume: 3.0F pitch: 0.5F someonePing: color: '&b&l' sound: ENTITY_EXPERIENCE_ORB_PICKUP volume: 3.0F pitch: 0.5F pingYourself: true includePicked: true pop-up: title: none fade-in: 1 duration: 3 fade-out: 1 bosscolor: WHITE ``` ![Language](https://i.imgur.com/T0UHIie.png) ``` title: '&0[&bChat&cPings&0]&r ' reload: start: '&bReloading configurations...' done: '&bReload complete!' toggle: mute: '&bSuccessfully muted pings! &c[Only staff can ping you now!' unmute: '&bSuccessfully unmuted pings!' prefix: success: '&bSuccessfully set prefix to &e{prefix}&b!' reset: '&bSuccessfully reset prefix to default! (@)' help: reload: '&bReloads the config and language file.' prefix: '&bChanges the prefix used for pings.' toggle: '&bMakes that only staff can ping you.' help: '&bShows you this list of commands this plugin has.' resetcooldown: '&bResets a player''s cooldown.' cooldown: resetsuccess: '&bSuccessfully reset cooldown for &e{player}&b!' error: permissions: '&cInsufficient permissions!' args: '&cToo few arguments!' prefix: '&cCannot set prefix to &e/ &cbecause it''s a command prefix!' oncooldown: '&cYour ping is on a cooldown! Wait &e{time} &cmore second(s)!' player: '&cPlayer &e{player} &cdoes not exist!' notoncooldown: '&cPlayer &e{player} &cis not on cooldown!' pop-up: message: '&b&l{name} &6has pinged you!' ``` ![Resources](https://i.imgur.com/bwepvul.png) - Sound volume can be set between 0.0F and 10.0F - Sound pitch can be set between 0.0F and 2.0F - Sound list: [Click here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html) [NOTE] Depending on what version your server is certain sounds will not work! ![Text color and format codes](https://i.imgur.com/q2Othzl.png) ![More Info](https://i.imgur.com/6WUMVFt.png) If you have any questions or bug reports feel free to ask or report in the [Github Issues Area](https://github.com/Niestrat99/ChatPings/issues) or on the [Discord server](https://discord.gg/jntpdcM)!

ChatPings

External resources

Project members

Technical information