SupMod | AdminsTools - Reports - Blacklist & Drop Logger - Webhooks - Coins

SupMod | AdminsTools - Reports - Blacklist & Drop Logger - Webhooks - Coins -----

Moderation, Player and Economy Management Plugin

New Wiki

What is SupMod ?

SupMod is a plugin that allows moderators to better manage users within their server.

How does it work ?

You have access to different commands to fully exploit the plugin.

The command <supmod> can also be replaced by <sm>

/supmod help <=> Displays available commands <=> Perm: supmod.help / supmod.admin.help
/supmod reload <=> Reloads the configuration file <=> Perm: supmod.reload
/supmod version <=> Shows the current version <=> Perm: supmod.version
/supmod menu [admin/drop] <=> Allows access to player parameters/data or drop logging <=> Perm: supmod.admin
/supmod menu [player] <=> Allows access to player parameters/data <=> Perm: supmod.player
/supmod spec_teleport [true/false] Enables or disables spectator gamemode during TP on a player <=> Perm: supmod.admin.spectatortp
/supmod menu admin report {en_cours / clos} <=> Allows access to all reports based on their status <=> Perm: supmod.admin
/supmod webhook [on/off/player_send_message_on_chat/player_join_server/player_leave_server/player_kill_player] {on/off} Send some logs to discord with webhook <=> Perm: supmod.admin
/supmod gamerule Open GameRule GUI to configure your gamerule <=> Perm: supmod.admin
The permission supmod.admin.report.receive allows receiving a message when a user is 'report'

/report {player} <=> Allows players to report another player for various reasons

Pour les menus, par défaut si il n'y a aucune action derrière (pas de report, de mort, de kill, etc ...) l'item ne fonctionnera pas

I/ The different GUI / Menus
To use the plugin, different GUI / Menus are available:

I.1/ The player menu (/supmod menu player)

Here you have all the players present on your server, then by clicking on the corresponding head you will have different actions:

The Head: Allows to see the player's coordinates and teleport to them
The Sign: Allows to see the different "bad words" that the player has said in the chat (word present in the config file)
The Clock: Allows to see the player's in-game playtime
The Chest: Allows to view the player's inventory
The Paper: Allows to view the player's XP, first connection to the server, and last connection
The Sword: Allows to view the different kills the player has made, to see what equipment they had, who they killed, and when
The Book: Allows to view the different 'reports' that the player has received and to be able to 'validate' them
The Totem: Allows to see the player's deaths, what equipment they had, where they died, and when

I.2/ The report system :

Here, players can report other players when their behavior is not appropriate by using the command: /report {player}
The player name is not mandatory. It allows to skip the first step, which is where all the players on the server are listed so that they can be selected. With the command /report {player}, you can specify a player who is not connected!

Here will be listed all the reasons for reporting that you have specified in the config.yml file.

and we got this :

Here will be listed all the postponement reasons that you have specified in the config.yml file

I.3/ The reports / bad words Menu

In concept, the two menus are different, but as for the actions, they remain in the same idea.

When opening a player's reports menu, I can see 2 things: books with feathers (and enchantment) and normal books,
The book with the feather means that the report has not been processed. If it is with a normal book, it means that it has been processed. To change its status, just click on the book:

We have different information, the date, the time, who reported the person, and who validated the report.

I.4/ Viewing different Reports / Chatcontrol

In this case, to avoid going to each profile and seeing the different reports they have, there is the following command: /supmod menu admin report {en_cours / clos} to see all the reports made.

I.5/ Auto-Rule message
You can now send a message a few seconds after the player logs in, to remind them of the rules to follow! (Configurable in the config.yml file)

Code (YAML):

# Automated Rules
# Send a message when a player join the game, with the rule of the server
# Timer, is the time waited before sending the rule after logging in (in secondes)
auto_rule:
active : true
timer : 5

I.6/ Game Rule GUI
Now you can configure your world gamerules, directly in a menu to activate or deactivate them
Check #Updates to see more about it (like screen ...)

II/ Discord Webhook - Logs

Now, you have the possibility to retrieve when a player connects to the server, disconnects, sends a message in the chat, or when a player kills another player and retrieve everything on Discord in the form of a webhook.

III/ Fully Customizable Language
You can now fully configure the text that is displayed, be it messages, menus or webhooks

Exemple of language file

Code (YAML):

SupMod_Command:
error : "&1Error executing command, type </supmod help>"
no_perm : "&4You do not have permission to use this command!"
reload : "&6Reload Done!"
version : "&4Version: %version%"
SupMod_GUI:
next_page : "&7Next Page"
previous_page : "&7Previous Page"
return : "&6Return"
title:
gui_drop_player : "&6Check Drop Inventory Player"
gui_report_player : "&6Player Reports - page "
gui_report_of : "&6Reports of "
gui_chatcontrol_of : "&6ChatControl of "
gui_inv_killer : "&6Inventory, Killer "
gui_inv_death_player : "&6Inventory, Death of "
gui_inv_of : "&6Inventory of "
gui_death_of : "&6Death of "
gui_kill_of : "&6Kill of "
gui_data_of : "&6Data of "
gui_player_list : "&6Player List"
gui_player_to_report : "&6Player to Report"
gui_reason_report : "&6Report Reason"
data_gui:
sign:
title : "&7Chat Control"
lore :
- " "
- "Number of bad word used : %n_badword%"
clock:
title : "&7Time Played"
lore:
- "Current time played : %time_played%"
chest:
title : "&7Player Inventory"
lore :
- "See player inventory"
paper:
title : "&6Player Information"
lore:
- "XP : %xp%"
- " "
- "First Connexion : %first_connexion%"
- "Last Connexion : %last_connexion%"
sword:
title : "Number of Kill"
lore :
- "He killed %n_kill% players"
writable_book:
title : "Reports"
lore:
- "Active Report : %active_report%"
- "Total of report : %total_report%"
totem:
title : "Number of Death"
lore:
- "Total of death : %n_death%"
SupMod_Spec:
false_error : "You have already disabled spectator mode during TP."
true_error : "You have already enabled spectator mode during TP."
'false' : "You have disabled spectator mode during TP."
'true' : "You have enabled spectator mode during TP."
error : "Please specify true/false as parameter."
Report:
player_not_found : "Sorry, the entered player name was not found!"
player_auto_report : "You are not allowed to self-report!"
item_error : "Report canceled, problem with the report selection, please contact an admin!"
report_sent : "You have reported %player_get_reported% for %reason%."
report_sent_admin : "%player_who_report% has reported player %player_get_reported% for %reason%."
message_to_player_when_get_reported : "The player %player_who_report% has reported you for %reason%."
WebHook:
new_message:
title : " New Message from : %player%"
description : "Message: %message%"
player_join:
title : "\uD83C\uDF89 %player% joined the game"
description : ""
player_leave:
title : "\uD83D\uDE25 %player% left the game"
description : ""
playerkillplayer:
title : "⚔\uFE0F New Kill"
description : "%p_killer% killed %p_death%"

IV/ Place Holder
Adding some placeholder (with PlaceHolderAPI plugin)
%supmod_count_kill% <> Show how many kills do the player
%supmod_count_death% <> Show how many death have the player
%supmod_time_played% <> Show how many times the player has played
%supmod_count_report% <> Show how many reports do the player
%supmod_count_active_report% <> Show how many active report the player have
%supmod_count_bad_words% <> Show how many bad words send the player
%supmod_last_connexion% <> Show when was his last connexion
%supmod_first_connexion% <> Show when was his first connexion

V/ Send emojy/symbol in Chat !
You can now configure sending emoji or symbol in chat!
Everything is configurable in config.yml or emojy.yml files
Check #Updates to see more about it (like screen ...)

VI/ Economic System | Coins
/coins <> see your balance
/coins balance <player> <> see balance of a player <> Perm : supmod.coins.player
/coins pay <player> <amount> <> pay a player <> Perm : supmod.coins.pay
/coins give <player> <amount> <> to give a specific amount of coins to a player <> Perm : supmod.coins.admin
/coins remove <player> <amount> <> to remove a specific amount of coins to a player <> Perm : supmod.coins.admin
/coins set <player> <amount> <> to set a specific amount of coins to a player <> Perm : supmod.coins.admin
/coins help <> see all this command In Game

All the data is stored in a .yml file, so you can easily modify them if you want.

Default config file:

Code (YAML):

#
# SupMod
#
# Plugin SupMod réalisé par Alstarte

# Please do not modify this parameter / Merci de ne pas modifier ce paramètre
version_config : 1.4.0

# Check plugin version update
#
check_update : true

# Choose you local language
# default en_US (You can find the different available languages in the "lang" folder or create your own while respecting the format)
language : en_US

# Chat control
# Banned words and logging
moderation_chat:
active : false
words :
- shit
- "fuck off"

# GUI management
# The number of heads per page must be between 1 and 28.
gui:
number_of_head_per_page : 28

# Report control
#
report:
prevent_when_reported : false

# Reason for reports
# List of items: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# Limit of 28 report types
report_reason:
r1:
title : "Cheat"
item : DIAMOND_SWORD
lore :
- "To report a player who cheat"
- ""
- "Do your good things !"
r2:
title : "Dupli"
item : CHEST
lore :
- "Pour report un joueur qui dupli"
- ""
- "Faites votre bonne action !"

# Log Drop Player
#
log_drop:
active : false
player_to_check :
- 6f3cbc99-f314-4496-b8ba-72859da3328d
- ac0a217f-219a-4ba0-8ea7-b51419c1965a

# Discord WebHook
# Get Event / Logs of player in discord
# Please note that if your server has a large number of members, the Discord webhook is limited to a certain number of requests, so it may not always work.
webhook:
active : false
link : ""
options:
player_send_message_on_chat : false
player_join_server : false
player_leave_server : false
player_kill_player : false
color:
player_send_message_on_chat : "RANDOM"
player_join_server : "#00FF00"
player_leave_server : "#000099"
player_kill_player : "#FF0000"

# Automated Rules
# Send a message when a player join the game, with the rule of the server
# Timer, is the time waited before sending the rule after logging in (in secondes)
auto_rule:
active : true
timer : 5

# Emojy in Chat
# The default symbol is "<>", so when a player writes <emoji>, the corresponding emoji will appear.
emojy:
active : false
symbol : "<>"

# Enabling Coins
# This is new money for the plugin
# Position for the symbol can be start or end
coins:
enable : true
negative : false
start_balance : 1000
symbol:
enable : true
value : "$"
position : "start"

You can find the documentation here