Configuration of config.yml

LifeMod config.yml – Practical Customization Guide

The config.yml file lets you control all messages, notifications, and item names/descriptions for LifeMod. You can adapt every message to your community’s style, language, and branding.

1. General Prefix & Error Messages

All messages use a prefix for branding.

prefix: "&7[&6Moderation&7] &f» "

• Change this to fit your server’s name and color scheme.

Error messages:

user-error: "&cOops! An error occurred: &e%context%"
user-help: "&7If this keeps happening, contact an admin or check your config."
admin-error: "&8[Debug] Error: %error% - %message%"
admin-location: "&8[Debug] At: %location%"

• %context%, %error%, %message%, and %location% are dynamic variables for context.

2. Chat Moderation

Chat notifications for forbidden words:

chatManager:
  notification: "&c%player% attempted to send a forbidden word !"
  enabled: true
  blacklist:
    - fuck
    - bitch
    - suck

• Add or remove words from the blacklist as needed.

• Edit the notification to match your moderation tone.

3. Command Activation/Deactivation

Disable any command by setting it to false:

For information, when you disable a command, the command is COMPLETELY disabled, so you can replace a command such as vanish with another command because the way the commands work is that if a command is disabled, it is disabled at the root level.

commands-enabled:
  gamemode: true
  vanish: true
  heal: true
  # ...etc.

Deactivation message:

command-deactivate: "&cThis command is deactivate."

• Edit this message for clarity or humor.

4. Moderation Items (GUI Tools)

Each moderation tool can be renamed, recolored, or described differently:

Tool	Name Example	Description Example
Inventory	&bInventory Viewer	&7Right-click a player to view their inventory.
Freeze	&bFreeze Player	&7Right-click a player to freeze or unfreeze them.
Random TP	&bRandom Teleport	&7Right-click to teleport to a random player.
Vanish	&bVanish	&7Right-click to toggle vanish mode.
Kill	&cKill Player	&7Right-click a player to instantly kill them.
KB Tester	&eKnockback Tester	&7Test knockback on players.
CPS Tester	&bCPS Tester	&7Clique sur un joueur pour tester ses CPS !

• Change the name and description fields to match your server’s language and style.

• Adjust material, slot, and customModelData as needed.

5. Command Usage & Help

Usage message for /lifemod:

lifemod:
  usage: "&cUsage: /lifemod [reload|info]"

Help menu (GUI):

help:
  title: "&a&lHelp menu for usage and description of commands"
  slots: 54
  items:
    Lifemod:
      id: PAPER
      slot: 12
      name: '&aLifeMod Command'
      lore:
        - '&7'

• Customize the help title, item names, and lore for clarity and branding.

6. Plugin & Server Info

Plugin info (with variables):

info:
  - "§8§m--------------------------------------------------"
  - "§6§lLifeMod §7§o- §fPlugin Info"
  - " §e• §fPlugin version: §a%plugin_version%"
  - " §e• §fServer version: §a%server_version% §7(%bukkit_version%)"
  - " §e• §fAuthors: §b%authors%"
  - " §e• §fDatabase: §d%database_type%"
  - " §e• §fDiscord integration: %discord_status%"
  - " §e• §fLuckPerms integration: %luckperms_status%"
  - " §e• §fUpdate notifier: %update_status%"
  - " §e• §fGithub: §9https://github.com/Lampalon/LifeMod"
  - "§8§m--------------------------------------------------"

• Edit lines or add new variables as needed.

Server info:

textserverinfo:
  - "&8&m--------------------------------------------------"
  - "&6&lServer Info"
  - " &e• &fVersion: &a%version%"
  - " &e• &fType: &a%type%"
  - " &e• &fMax players: &a%max_players%"
  - " &e• &fDifficulty: &a%difficulty%"
  - " &e• &fOnline players: &a%online_players%"
  - " &e• &fVanished players: &a%vanished_players%"
  - "&8&m--------------------------------------------------"

7. Discord Integration

Webhook URL:

discord:
  enabled: false
  webhookurl: "Insert your webhook here !"

• Set your Discord webhook for alerts and notifications.

8. Command Alerts (Broadcast, Feed, Fly, etc.)

Each command can send a formatted alert, using variables like %player% and %message%:

Example for /broadcast:

broadcast:
  title: "New Alert!"
  description: "> %player% has execute broadcast command containing the message %message%!"
  footer:
    title: "Powered By LifeGroup"
    logo: "https://mc-heads.net/avatar/%player%/"
  color: "#FF0000"

• Change the title, description, and color for each command.

• Use %player% and %message% for dynamic content.

• The logo can use the player’s Minecraft avatar.

Other commands (fly, freeze, heal, etc.) follow the same structure.

9. Dynamic Variables

You can use variables such as:

• %player% (executing player)

• %message% (message content)

• %context% (context content for debug errors)

Always test your changes after editing to ensure variables display correctly.

10. Best Practices

• Backup your lang.yml before editing.

• Use /lifemod reload to apply changes without restarting.

• Keep colors and formatting consistent for a professional look.

• Adjust messages for accessibility (readable colors, clear language).

This structure allows you to fully personalize LifeMod’s messages, GUI, and notifications to fit your server’s identity and community needs, using real, editable examples from your configuration.