General Description

AdvancedMute is a Minecraft Bukkit/Paper plugin. Its purpose is:
Filtering players’ chat messages
Automatically muting players who use banned words
Sending logs to Discord
Working compatibly with other mute systems such as AdvancedBans or LiteBans

Command

The plugin has only one command: /advancedmute reload.
Just like in many other plugins, this command allows you to reload the config without restarting the server.

Mute System

The plugin does not handle the mute by itself.
If the option for AdvancedBans or LiteBans is set to true in the config:

AdvancedBans: 
  enabled: true # Set to true if you are using AdvancedBans
  command: "tempmute %player% %duration% %reason%"

LiteBans:
  enabled: false # Set to true if you are using LiteBans
  command: "mute %player% %duration% %reason%"

The plugin will run the command written under command: in the console.

WebHook System

For each mute the plugin issues, it sends a message to the Discord webhook you set here:

discord-log-webhook-url: "PUT_WEBHOOK_HERE"

This makes moderation easier by logging mute actions to Discord.

Config File

discord-log-webhook-url: "PUT_WEBHOOK_HERE" # Sends a Discord notification when a player is muted

AdvancedBans: 
  enabled: false # Set to true if you are using AdvancedBans
  command: "mute %player% %duration% %reason%" # Do NOT put "/" at the beginning!

LiteBans:
  enabled: false # Set to true if you are using LiteBans
  command: "mute %player% %duration% %reason%" # Do NOT put "/" at the beginning!

BannedWords:
  Ailevi:
    Words:
      - "examplebadword1"
      - "examplebadword2"
    Duration:
      Value: 2
      Unit: h # time units: m = minutes, h = hours, d = days
    Color: 16711680
    Reason: "Family-related profanity"

  Slang:
    Words:
      - "exampleslang1"
    Duration:
      Value: 30
      Unit: m # m = minutes, h = hours, d = days
    Color: 16776960
    Reason: "Use of slang word"

As already explained, the Discord log, AdvancedBans, and LiteBans parts are straightforward.
Now let’s talk about the BannedWords section — the most important part of the plugin.

In this section you create categories for banned-word groups.
For example:

Family:
    Words:
      - "examplebadword1"
      - "examplebadword2"
    Duration:
      Value: 2
      Unit: h
    Color: 16711680
    Reason: "Family-related profanity"

Here, a category named Family is created, and the banned words inside this category are listed under Words:.
Whenever a player types any of the words in this list, the plugin triggers and applies a mute based on the duration settings.

Permissions

advancedmute.bypass -> Allows the player to use banned words without being muted

advancedmute.reload -> Allows the player to use the reload command

If you want to ask something, suggest ideas, or report bugs, you can contact me on Discord: nadir_aksolotl

This is my second plugin — I’d appreciate hearing your thoughts!

Genel Tanım

AdvancedMute bir Minecraft Bukkit/Paper pluginidir. Amacı:
Oyuncuların chat mesajlarını filtrelemek.
Yasaklı kelime kullanan oyuncuları otomatik olarak mute etmek.
Discord’a log göndermek.
AdvancedBans veya LiteBans gibi başka mutelerle uyumlu çalışmak.

Komut

Pluginde sadece /advancedmute reload komutu bulunmaktadır bu komut diğer her pluginde olduğu gibi configi sunucuya restart atmanız gerekmeden yeniden yüklemenizi sağlar

Mute İşlemi

Plugin, mute işlemini kendi başına yapmaz.
Eğer configde AdvancedBans veya LiteBans seçeneği true ise

AdvancedBans: 
  enabled: true # Eğer AdvancedBans kullanıyorsanız true yapın
  command: "tempmute %player% %duration% %reason%"

LiteBans:
  enabled: false # Eğer LiteBans kullanıyorsanız true yapın
  command: "mute %player% %duration% %reason%"

altında yazan command: kısmındaki komutu console da çalıştırır

WebHook Sistemi

Plugin, attığı her muteyi sizin

discord-log-webhook-url: "BURAYA_WEBHOOK"

configdeki bu kısma yazdığınız webhook ile mesaj olarak discorda gönderir böylece denetleme kolaylaşır

Config Dosyası

discord-log-webhook-url: "BURAYA_WEBHOOK" # Oyuncular mutelenince bildirim olarak discorda gönderir

AdvancedBans: 
  enabled: false # Eğer AdvancedBans kullanıyorsanız true yapın
  command: "mute %player% %duration% %reason%" # başına "/" koyarsanız çalışmaz!

LiteBans:
  enabled: false # Eğer LiteBans kullanıyorsanız true yapın
  command: "mute %player% %duration% %reason%" # başına "/" koyarsanız çalışmaz!

BannedWords:
  Ailevi:
    Words:
      - "örnekküfür1"
      - "örnekküfür2"
    Duration:
      Value: 2
      Unit: h # zaman birimi m = dakika h = saat d = gün
    Color: 16711680
    Reason: "Ailevi küfür kullanımı"
    
  Argo:
    Words:
      - "örnekargo1"
    Duration:
      Value: 30
      Unit: m # zaman birimi m = dakika h = saat d = gün
    Color: 16776960
    Reason: "Argo kelime kullanımı"

zaten discord log, advancedbans ve litebans kısmını anlatmıştım gelelim diğer kısımlara,
BannedWords kısmı işte pluginin en önemli yerlerinden. Burada önce bir yasaklı kelime sınıfı oluşturursunuz configde olduğu gibi;

  Ailevi:
    Words:
      - "örnekküfür1"
      - "örnekküfür2"
    Duration:
      Value: 2
      Unit: h # zaman birimi m = dakika h = saat d = gün
    Color: 16711680
    Reason: "Ailevi küfür kullanımı"

mesela burada olduğu gibi ailevi sınıfı oluşturulmuş ve bu sınıfa giren kelimeler Words Kısmına yazılmış bu words de yazan kelimeleri oyuncular yazdığında plugin tetikleniyor ve duration kısmında yazan bilgilerle mute artar.

Permissionlar

advancedmute.bypass -> yasaklı kelimeleri kullanma izni verir

advancedmute.reload -> reload komutunu kullanma izni verir

Anlamadığınız yerleri sormak, öneride bulunmak ve ya hata bildirmek için discordum: nadir_aksolotl.

bu 2. yaptığım pluginim düşüncelerinizi belirtirseniz sevinirim.

AdvancedMute

📖About AdvancedMute