Mikarific/HuskChat

A simple & customizable no-frills Minecraft proxy chat system

★ 0Forks 0GitHub ↗Compare

README

HuskChat Banner

GitHub CI JitPack API Support Discord

Documentation, Guides & API · Resource Page · Bug Reports

HuskChat is a no-frills, simple and customisable cross-server chat system for Minecraft networks running BungeeCord and Velocity frontend servers.†

It's designed to be easy to configure with an elegant out-of-box setup, while also being highly configurable, suiting a variety of use cases by allowing you to define channels and manage who can send and receive messages within them.

† This plugin does not support Chat Reporting. Velocity 1.19.2+ users will need to use a fork that disables signed chat message enforcing for the time being. (more…)

Features

  • Works great out of the box, install on your Velocity or BungeeCord-based proxy and use right away
  • Hooks with LuckPerms to display user prefixes and suffixes
  • Private messaging and replying commands - including group private messages
  • Define who can send and receive messages in channels
  • Define shortcut commands to let players quickly switch channels
  • Machine learning powered profanity filter
  • Customisable spam limiting filter, anti-advertising & special emoji
  • Utilise modern 1.16+ formatting, with RGB and Gradient support via MineDown

Commands

  • /channel (and make shortcuts for each channel)
  • /msg, /r (including group messages)
  • /socialspy, /localspy
  • /broadcast
  • Full list & permissions

Channels

Channels are what players talk in and can be switched between using the /channel command or specialised channel shortcut command. By default, HuskChat has the following channels setup, perfect for a typical proxy server setup:

  • local - Local scoped channel with /local, /l shortcut commands, for sending messages to players on the same server.
  • global (default channel) - Global scoped channel with /global, /g shortcut commands, for sending messages across the network.
  • staff - Global scoped channel with /staff, /sc shortcut commands. Great for letting staff communicate easily. Players need the huskchat.channel.staff.send and huskchat.channel.staff.receive permissions to send and receive messages in this channel respectively.
  • helpop - Global scoped channel with /helpop shortcut command. Great for letting players easily contact staff. Players need the huskchat.channel.helpop.receive permission to receive messages in this channel.

Channels are fully customizable, including formatting, permission-restricting, broadcast scope, shortcut command amd more.

Building

To build HuskHomes, you'll need python (>=v3.6) with associated packages installed; jep and alt-profanity-check. You can install these with pip install jep and pip install alt-profanity-check. These are needed to run the profanity filter tests.

Then, simply run the following in the root of the repository:

./gradlew clean build

License

HuskHomes is licensed under Apache-2.0 License.

Translation

Translations of the plugin locales are welcome to help make the plugin more accessible. Please submit a pull request with your translations as a .yml file.

bStats

This plugin uses bStats to provide me with metrics about its usage:

You can turn metric collection off by navigating to plugins/bStats/config.yml and editing the config to disable plugin metrics.

Links


© William278, 2022. Licensed under the Apache-2.0 License.

Contributors

WiIIiam278TrueWinterdependabot[bot]joshcannotcode10935336CeddixironboundredMalzSmith

Issues