Troubleshooting

Having issues with LifeMod? Use this guide to solve the most common problems when editing your config.yml or lang.yml.

YAML Formatting Errors

Symptoms:

• The plugin fails to load.

• Error messages in the console: Could not load config.yml/lang.yml: invalid YAML

How to fix:

• Always use a proper YAML editor (like YAML Lint).

• Check for:

  • Missing or extra spaces/indentation.

  • Tabs instead of spaces (YAML requires spaces).

  • Missing : or quotes.

• Example of correct YAML:

  prefix: "&7[&6Moderation&7] &f» "
  commands-enabled:
    gamemode: true
    vanish: true

Invalid Color Codes or Formatting

Symptoms:

• Messages appear without colors.

• Color codes show as plain text (e.g., &c).

How to fix:

• Use & for color codes, not % or $.

• Double-check that your Minecraft version supports all used codes.

• Example:

  • Correct: &aSuccess!

  • Incorrect: %aSuccess!

Unknown Variables

Symptoms:

• Messages show %player%, %target%, etc., as plain text.

How to fix:

• Make sure you’re using only the variables supported by LifeMod.

• Check the documentation for a list of available variables.

• Do not invent or misspell variables.

Changes Not Applying

Symptoms:

• You edit the config or lang file, but nothing changes in-game.

How to fix:

• Run /lifemod reload after every change to apply updates instantly3.

• If the issue persists, restart your server.

• Ensure you’re editing the correct file in the right folder.

Command Not Working or Disabled

Symptoms:

• Command returns “unknown command” or “this command is deactivate.”

How to fix:

• Check commands-enabled in config.yml to ensure the command is set to true.

• Example:

  commands-enabled:
    fly: true

• If disabled, set to true and reload.

Permission Issues

Symptoms:

• Players or staff can’t use commands they should have access to.

How to fix:

• Make sure permissions are correctly set in your permissions plugin (e.g., LuckPerms).

• Refer to LifeMod’s permission nodes in the documentation.

Console/Startup Errors

Symptoms:

• Errors appear in the console when starting or reloading the server.

How to fix:

• Read the error message; it often points to the line and file with the issue.

• Check for YAML syntax errors, missing values, or unsupported options.

• Restore a backup if you can’t find the error.

Need More Help?

• Backup before every change!

• If you’re stuck, revert to your last working backup.

• Check for plugin updates—your issue may be fixed in a newer version.

• Visit the LifeMod support page for help.

Tip: Always test your config and lang changes on a test server before deploying to production!