Welcome to the Guild System module by Moloko.

This module is designed to enhance guild interactions and rewards in your server environment, including configurable rates and announcements.

RU locales README_RU

Overview

mod-guild-system

The primary goal of this module is to adapt the guild leveling system, originally introduced in the Cataclysm expansion, for use exclusively with the Wrath of the Lich King (WoTLK) expansion. This adaptation is specifically tailored for servers utilizing the AzerothCore build.

Guild level taken from this article.

Personal guild reputation uses the normal WotLK faction pipeline (CalculateReputationGain → ModifyReputation), weekly cap 4375.

---

Features

• Configurable settings for enabling/disabling specific features.
• Debugging options for testing and validation.
• Experience gain from quests, boss kills, battlegrounds, and arenas.
• True weekly XP cap with configurable weekday and time.
• Personal guild reputation via Faction.dbc (GuildSystem.Reputation.FactionId) with weekly cap.
• Guild rewards vendor via gossip (ScriptName = guild_system_vendor).
• Guild bonus spells synced on login, join/leave, and guild level-up (cached).
• Notification in the guild chat about guild level-up.
• Player commands .ginfo, .glevel, .grep.

---

Functions

GuildSystemBaseXP == 250 xp
Reputation base: QuestReward / KillReward / PvPReward (defaults 250 / 125 / 125)

1. Guild XP from Complete Quests

• Base XP: baseXP = GuildSystemRateXPQuest * GuildSystemBaseXP
• Level Difference:
  • Halved if the player is significantly over-leveled (levelDifference > 5).
  • Doubled if the quest is significantly harder (levelDifference < -5).
• Multiplier: Scales with GuildSystemRateXP.

2. Guild XP from Boss Kills

• Base XP: baseXP = GuildSystemRateXPKillBoss * GuildSystemBaseXP
• Boss Check: type_flags & CREATURE_TYPE_FLAG_BOSS_MOB
• Level Difference: same rules as quests (> 5 / < -5).
• Multiplier: Scales with GuildSystemRateXP.

3. Guild XP from PvP

• Base XP: baseXP = GuildSystemRateXPPvP * GuildSystemBaseXP
• Awarded via OnBattlegroundEndReward for both battlegrounds and arenas (bg->isArena()).
• Multiplier: Scales with GuildSystemRateXP.

4. Weekly XP cap

• Cap amount: GuildSystem.WeeklyXP
• Reset once per week at GuildSystem.WeeklyXP.WDay + Hours + Minute (local server time).
• Default weekday: Tuesday (2).

5. Personal guild reputation

• Granted on quest turn-in / boss kill / BG end independently of guild XP.
• Uses the same pipeline as normal faction rewards: base amount → Player::CalculateReputationGain → ReputationMgr::ModifyReputation.
• Quests: daily/weekly/monthly/repeatable/quest sources by quest flags. Base: GuildSystem.Reputation.QuestReward (default 250).
• Boss / PvP: KillReward / PvPReward (default 125) with REPUTATION_SOURCE_KILL.
• Weekly personal cap: GuildSystem.Reputation.WeeklyCap (default 4375), reset on the same weekday/time.
• Required GuildSystem.Reputation.FactionId: if 0, reputation is not awarded.

6. Guild rewards vendor

• Table guild_system_rewards (entry, standing, racemask, price, achievements).
• standing: ReputationRank (4 Friendly … 7 Exalted).
• achievements: space-separated player achievement IDs (WotLK has no guild achievements).
• Seed is empty — fill with your own WotLK item entries.
• Bind an NPC: set creature_template.ScriptName = 'guild_system_vendor'.

7. Bonus spells

• Configured in guild_system_xp.spell (nullable).
• Applied for levels 1..guildLevel.

---

Installation

1. Clone this repository:

   cd path/to/azerothcore/modules
   git clone https://github.com/levrules/mod-guild-system.git

2. Re-run cmake and build AzerothCore.
3. Copy/merge guild_system.conf.dist into your worldserver config as needed.
4. Restart the server so the DB updater applies module SQL.
5. (Optional) Insert reward rows into guild_system_rewards and assign guild_system_vendor to an NPC.

Warning: the module writes acore_string entries 30098–30106. If those IDs are already used, change them in guild_system.h and acore_string.sql.

---

Support

If you encounter any issues or have feature requests, feel free to open an issue on the GitHub repository.

---

License

This project is licensed under the GNU Affero General Public License (AGPL-3.0). For more details, see the LICENSE file.