Guild Contribution System – Daily Quests, Zeny/Emperium Donations & Bonus

Boost your guild progression with a plug-and-play contribution system for rAthena. This mod adds a fully scripted Guild Contribution Manager NPC, guild-level bonus buffs driven by a YAML database, optional map-restricted effects, and quality-of-life admin controls.

Key Features

• Daily Item Quests (no SQL): Up to 3 per character per day (24h cooldown). Each quest can require 1–10 items from 30 templates (you can add more); rewards Guild EXP on submit.

• Donations: Players can donate Zeny or Emperium for instant Guild EXP (rates configurable).

• Guild-Level Buffs : db/gcontrib.yml maps guild levels to script bonuses (example presets included for Lv 10/20/30/40/50: bSpeedRate, bBaseAtk, bMaxSP, bAllStats, bMaxHP, etc.).

• Map-Scoped Effects: New mapflag MF_GCONTRIB lets you apply contribution buffs only on selected maps (e.g., prontera/payon). Toggle with feature.gcontrib_mapflag.

• Natural Guild EXP (optional): Enable or disable the natural guild xp gain when you kill a monster with tax (feature.gcontrib_naturalxp).

• Admin Tools:

  • @reloadgcontribdb to hot-reload gcontrib.yml (players auto-refresh).

  • New script command getguildplayerxp to display a member’s personal contribution in the NPC UI.

• Clean UI: One NPC (Guild Contribution#Manager) with menus for Donate Zeny, Donate Emperium, Daily Quests, Guild Progress, and Help.

• Gepard limitation: Possible to limit the quests by gepard unique id.

What’s Included

• Config: conf/battle/feature.conf entries for feature.gcontrib_mapflag and feature.gcontrib_naturalxp.

• Database: db/gcontrib.yml (guild-level → bonus scripts).

• NPC Scripts: npc/custom/gcontrib.txt (manager NPC) + npc/mapflag/gcontrib.txt (example mapflags).

• Source Hooks (C++): Guild bonus application on status calc, optional natural guild EXP split, DB loader, and @reloadgcontribdb.

Configuration Highlights (NPC GC_Config)

• ExpPerZeny, ExpPerEmperium (EXP rates)

• MaxLevel (default 50)

• DailySlots (default 3) & DailyCooldownHours (default 24)

• 30 ready-made item quest templates (edit or extend as you like)