World damage/healing, destructible buildings, multiplier rewrite, logging improvements

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -43,6 +43,16 @@ body:
         None
     validations:
       required: false
+  - type: textarea
+    id: abcommands
+    attributes:
+      label: AutoBalance Debug Commands
+      description: |
+        Please include text or an image of the `.ab mapstat` command. If your issue is concerning scaling of creatures, please also include the `.ab creaturestat` command while targeting the problematic creature.
+      placeholder: |
+        None
+    validations:
+      required: false
   - type: textarea
     id: commit
     attributes:

README.md

@@ -1,11 +1,34 @@
 # ![logo](https://raw.githubusercontent.com/azerothcore/azerothcore.github.io/master/images/logo-github.png) AzerothCore
-## AutoBalanceModule
+
+## AutoBalance
+
 - Latest build status with azerothcore: [![Build Status](https://github.com/azerothcore/mod-autobalance/workflows/core-build/badge.svg?branch=master&event=push)](https://github.com/azerothcore/mod-autobalance)
 
 This module is intended to scale based on number of players, instance mobs and bosses' health, mana, and damage.
 
+**NOTE:** This module requires at least [this commit](https://github.com/azerothcore/azerothcore-wotlk/commit/f127e583aae3cfa51a77d056c1892a7de07ffb52) of AzerothCore in order to work correctly. Older versions are not supported.
+
 All settings are well-described in the configuration file.
 
+**PLEASE** include the output from the `.ab mapstat` and `.ab creaturestat` commands (while targeting a problematic creature) when reporting issues. This will help us to quickly identify the problem and provide a solution.
+
+## In-game Commands
+| Command | Permission | Description |
+| :------ | :--------- | :---------- |
+| `.ab mapstat` | All Players | Displays AB-calcualted settings for the current map, including player count, difficulty, world modifiers, and others. |
+| `.ab creaturestat` | All Players | Displays AB-calculated settings for the targeted dungeon creature including level scaling, difficulty, modifiers, and boss status. |
+| `.ab setoffset` | Game Masters | Sets the server-wide player difficulty offset. Instances will be scaled as though they had this many more/less players than they really do. |
+| `.ab getoffset` | All Players | Gets the current server-wide player difficulty offset. Instances will be scaled as though they had this many more/less players than they really do. |
+| `.reload config` | Game Masters | Reloads all your configuration files, including `AutoBalance.conf`. This lets you update AutoBalance settings without restarting your worldserver. This module is designed to contiue to work as expected when this command is issued. |
+
+## Logger Names
+| Logger | Description |
+| :----- | ----------- |
+| `Logger.module.AutoBalance` | Main logger, verbose debug logs. Map detection, list management, creature adjustments, multiplier, modifiers. Catch-all. |
+| `Logger.module.AutoBalance_CombatLocking` | Debug logs related to the combat locking/unlocking mechanism for maps. |
+| `Logger.module.AutoBalance_DamageHealingCC` | Debug logs for the spell/melee/CC modifications that are made in real-time. |
+| `Logger.module.AutoBalance_StatGeneration` | Detailed debug logs that show all the calculation steps in how different multipliers are derived. |
+
 ## References
 - [Interactive Inflection Point Spreadsheet](https://docs.google.com/spreadsheets/d/100cmKIJIjCZ-ncWd0K9ykO8KUgwFTcwg4h2nfE_UeCc/copy)
 - [InflectionPoint Curve Examples](https://i.imgur.com/x42UnUR.png)

conf/AutoBalance.conf.dist

@@ -1,4 +1,18 @@
 [worldserver]
+##########################
+#
+# Logging
+#
+# Add these lines to your worldserver.conf file to enable logging for AutoBalance.
+#
+# 4 = Info (Default), 5 = Debug
+#
+##########################
+# Logger.module.AutoBalance=4,Console Server
+# Logger.module.AutoBalance_CombatLocking=4,Console Server
+# Logger.module.AutoBalance_DamageHealingCC=4,Console Server
+# Logger.module.AutoBalance_StatGeneration=4,Console Server
+
 ##########################
 #
 # Enable / Disable Settings
@@ -300,6 +314,8 @@ AutoBalance.playerCountDifficultyOffset=0
 #        Health | Mana | Armor | Damage
 #           Adjusts the StatModifier for the appropriate stat. Affected by the Global StatModifier above.
 #
+#           NOTE: "Damage" affects both creature damage and world damage.
+#
 #           Default: 1.0
 #
 #        Boss.Global | Boss.Health | Boss.Mana | Boss.Armor | Boss.Damage
@@ -807,12 +823,19 @@ AutoBalance.LevelScaling.DynamicLevel.DistanceCheck.PerInstance="189 500"
 
 #
 #     AutoBalance.LevelScaling.LevelEndGameBoost
+#
+#        NOTICE: This setting is currently not implemented pending a rewrite.
+#                Enabling it here has NO effect.
+#
+#        See: https://github.com/azerothcore/mod-autobalance/issues/156
+#
+#        Old description:
 #        End game creatures have an exponential (not linear) regression
 #        that is not correctly handled by db values. Keep this enabled
 #        to have stats as near possible to the official ones.
 #
-#        Default:     1 (1 = ON, 0 = OFF)
-AutoBalance.LevelScaling.EndGameBoost = 1
+#        Default:     0 (1 = ON, 0 = OFF)
+AutoBalance.LevelScaling.EndGameBoost = 0        # setting to 1 does not do anything
 
 ##########################
 #