Logging system is still in WIP

Overview

Claimorous! provides comprehensive logging options to help server administrators track claim-related activities and troubleshoot issues. These logs can be invaluable for monitoring player behavior, investigating griefing attempts, and maintaining server security.

Logs are stored in the server's log files and can be accessed through standard server log viewing methods.

Available Logging Options

Server administrators can enable or disable logging for various claim-related events:


# [Logging Settings]

# Enable logging for claim creation
log_claim_creation = true

# Enable logging for claim removal
log_claim_removal = true

# Enable logging for claim modifications
log_claim_modification = true

# Enable logging for player warnings (attempted violations)
log_player_warnings = true

# Enable periodic statistics logging
log_periodic_stats = false

# Interval for periodic stats logging (in seconds)
periodic_stats_interval = 3600

# Enable logging for configuration changes
log_config_changes = true

# Enable debug logging (verbose)
log_debug_info = false

Log Types Explained

Claim Creation Logs

When enabled, these logs record when and where players create new claims, including:

  • Player name and UUID
  • Claim location (coordinates)
  • Claim tier

Claim Removal Logs

These logs track when claims are removed, whether by the owner or through other means:

  • Player who removed the claim
  • Original claim owner
  • Claim location (coordinates)
  • Reason for removal (if applicable)

Claim Modification Logs

These logs record changes to existing claims, such as:

  • Permission changes
  • Tier upgrades
  • Essence additions
  • Other configuration changes

Player Warning Logs

These logs record attempted violations of claim protections:

  • Player attempting the action
  • Type of action attempted (block breaking, entity interaction, etc.)
  • Location of the attempt
  • Claim owner

Periodic Statistics Logs

When enabled, these logs provide regular summaries of claim-related statistics:

  • Total number of players with claims
  • Average number of claims per player

Configuration Change Logs

These logs record changes to the Claimorous! configuration:

  • Who made the change (player name or console)
  • What setting was changed
  • Old and new values
  • Timestamp

Debug Logs

These are verbose logs that provide detailed information about the mod's operation:

  • Internal processes and calculations
  • Performance metrics
  • Error traces and warnings
  • Other technical details

Debug logging can significantly increase log file size and may impact server performance. Only enable this option when troubleshooting specific issues.