Paragon: move module SQL to AC's data/sql/db-* layout for auto-update

AzerothCore's DBUpdater scans modules/<mod>/data/sql/db-{world,characters,auth}/
(see src/server/database/Updater/UpdateFetcher.cpp). The previous
modules/mod-paragon/sql/{world,characters}/base/ layout was non-standard
and skipped by the updater, so a fresh deploy never had Paragon tables
created automatically.

Move all five SQL files into the standard layout. Files are idempotent
(CREATE TABLE IF NOT EXISTS plus a DELETE+INSERT for the cost table)
and now apply on every dbimport / worldserver start, recorded by hash
in <db>.updates so re-runs are skipped.

Update BUILD-NATIVE.md to drop the manual mysql import section, and
document the SQL layout in the mod-paragon README.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Docker Build
2026-05-08 22:03:42 -04:00
parent 203356aca8
commit df7e943a74
7 changed files with 22 additions and 14 deletions
@@ -0,0 +1,103 @@
-- mod-paragon: extend the gameTable SQL fallback tables to cover class 12.
--
-- AzerothCore loads each gtXxx DBC twice: first the .dbc file on disk, then
-- a `gtxxx_dbc` SQL fallback table that overrides / extends the in-memory
-- index (DBCDatabaseLoader::Load). For Player::OCTRegenMPPerSpirit,
-- Player::GetMissPercentageFromDefence, Player::GetRatingMultiplier and
-- friends, the SQL is the source of truth at runtime, not the DBC.
--
-- The vanilla acore_world ships these tables with rows for class 1..11 only.
-- For class 12 (Paragon), the lookup index is unmapped and every formula
-- silently returns 0 (mana regen, crit, dodge, rating multipliers).
--
-- We mirror Druid (class 11) values into class 12 -- druid is the closest
-- vanilla hybrid (mana + rage + energy across forms) and matches Paragon's
-- multi-resource intent. Same source class as the DBC patches and as
-- player_class_stats_paragon_basemana.sql, so the data stays consistent.
--
-- Lookup formulas (for cross-reference with src/server/game/Entities/Player):
-- gtChanceToMeleeCrit / gtChanceToSpellCrit / gt*RegenHP / gt*RegenMP /
-- gtRegenHPPerSpt / gtRegenMPPerSpt:
-- LookupEntry((class - 1) * GT_MAX_LEVEL + level - 1)
-- class 11 -> Ids 1000..1099 ; class 12 -> Ids 1100..1199
--
-- gtChanceToMeleeCritBase / gtChanceToSpellCritBase:
-- LookupEntry(class - 1)
-- class 11 -> Id 10 ; class 12 -> Id 11
--
-- gtOCTClassCombatRatingScalar:
-- LookupEntry((class - 1) * MAX_COMBAT_RATING + cr + 1)
-- class 11 -> Ids 321..352 ; class 12 -> Ids 353..384
--
-- Idempotent: each block deletes the class-12 Id range first, then re-clones
-- from class 11 via a materialised subquery (so we don't read the same
-- table we're inserting into in undefined order). Re-running the file is
-- safe and produces identical results.
--
-- Wrapped in a single transaction so a mid-script error rolls back the
-- whole thing.
--
-- Apply to acore_world.
START TRANSACTION;
-- gtChanceToMeleeCrit ---------------------------------------------------------
DELETE FROM `gtchancetomeleecrit_dbc` WHERE `ID` BETWEEN 1100 AND 1199;
INSERT INTO `gtchancetomeleecrit_dbc` (`ID`, `Data`)
SELECT t.ID + 100, t.Data
FROM (SELECT `ID`, `Data` FROM `gtchancetomeleecrit_dbc` WHERE `ID` BETWEEN 1000 AND 1099) AS t;
-- gtChanceToSpellCrit ---------------------------------------------------------
DELETE FROM `gtchancetospellcrit_dbc` WHERE `ID` BETWEEN 1100 AND 1199;
INSERT INTO `gtchancetospellcrit_dbc` (`ID`, `Data`)
SELECT t.ID + 100, t.Data
FROM (SELECT `ID`, `Data` FROM `gtchancetospellcrit_dbc` WHERE `ID` BETWEEN 1000 AND 1099) AS t;
-- gtOCTRegenHP ----------------------------------------------------------------
DELETE FROM `gtoctregenhp_dbc` WHERE `ID` BETWEEN 1100 AND 1199;
INSERT INTO `gtoctregenhp_dbc` (`ID`, `Data`)
SELECT t.ID + 100, t.Data
FROM (SELECT `ID`, `Data` FROM `gtoctregenhp_dbc` WHERE `ID` BETWEEN 1000 AND 1099) AS t;
-- gtRegenHPPerSpt -------------------------------------------------------------
DELETE FROM `gtregenhpperspt_dbc` WHERE `ID` BETWEEN 1100 AND 1199;
INSERT INTO `gtregenhpperspt_dbc` (`ID`, `Data`)
SELECT t.ID + 100, t.Data
FROM (SELECT `ID`, `Data` FROM `gtregenhpperspt_dbc` WHERE `ID` BETWEEN 1000 AND 1099) AS t;
-- gtRegenMPPerSpt -------------------------------------------------------------
DELETE FROM `gtregenmpperspt_dbc` WHERE `ID` BETWEEN 1100 AND 1199;
INSERT INTO `gtregenmpperspt_dbc` (`ID`, `Data`)
SELECT t.ID + 100, t.Data
FROM (SELECT `ID`, `Data` FROM `gtregenmpperspt_dbc` WHERE `ID` BETWEEN 1000 AND 1099) AS t;
-- gtChanceToMeleeCritBase -----------------------------------------------------
DELETE FROM `gtchancetomeleecritbase_dbc` WHERE `ID` = 11;
INSERT INTO `gtchancetomeleecritbase_dbc` (`ID`, `Data`)
SELECT t.ID + 1, t.Data
FROM (SELECT `ID`, `Data` FROM `gtchancetomeleecritbase_dbc` WHERE `ID` = 10) AS t;
-- gtChanceToSpellCritBase -----------------------------------------------------
DELETE FROM `gtchancetospellcritbase_dbc` WHERE `ID` = 11;
INSERT INTO `gtchancetospellcritbase_dbc` (`ID`, `Data`)
SELECT t.ID + 1, t.Data
FROM (SELECT `ID`, `Data` FROM `gtchancetospellcritbase_dbc` WHERE `ID` = 10) AS t;
-- gtOCTClassCombatRatingScalar (32 ratings per class, 1-based Ids) ------------
DELETE FROM `gtoctclasscombatratingscalar_dbc` WHERE `ID` BETWEEN 353 AND 384;
INSERT INTO `gtoctclasscombatratingscalar_dbc` (`ID`, `Data`)
SELECT t.ID + 32, t.Data
FROM (SELECT `ID`, `Data` FROM `gtoctclasscombatratingscalar_dbc` WHERE `ID` BETWEEN 321 AND 352) AS t;
COMMIT;
-- Sanity check (read-only). Expected class-12 counts:
-- 100 / 100 / 100 / 100 / 100 / 1 / 1 / 32
-- SELECT 'mc' cnt, COUNT(*) FROM gtchancetomeleecrit_dbc WHERE ID BETWEEN 1100 AND 1199
-- UNION ALL SELECT 'sc' cnt, COUNT(*) FROM gtchancetospellcrit_dbc WHERE ID BETWEEN 1100 AND 1199
-- UNION ALL SELECT 'orh' cnt, COUNT(*) FROM gtoctregenhp_dbc WHERE ID BETWEEN 1100 AND 1199
-- UNION ALL SELECT 'rh' cnt, COUNT(*) FROM gtregenhpperspt_dbc WHERE ID BETWEEN 1100 AND 1199
-- UNION ALL SELECT 'rm' cnt, COUNT(*) FROM gtregenmpperspt_dbc WHERE ID BETWEEN 1100 AND 1199
-- UNION ALL SELECT 'mcb' cnt, COUNT(*) FROM gtchancetomeleecritbase_dbc WHERE ID = 11
-- UNION ALL SELECT 'scb' cnt, COUNT(*) FROM gtchancetospellcritbase_dbc WHERE ID = 11
-- UNION ALL SELECT 'crs' cnt, COUNT(*) FROM gtoctclasscombatratingscalar_dbc WHERE ID BETWEEN 353 AND 384;