Fairy Dust

Purchasing Bottles

Location:

• Prefect's Lounge (lodge.php)
• Navigation: "Shop" → "Fairy Dust ([cost] points+1 gem)"
• Default cost: 200 donation points + 1 gem

Purchase Sequence:

• 1. Click "Fairy Dust" link
• 2. Percy: "`&A bottle of Fairy Dust costs %s points, and a gem for our suppliers,`7\" he says. \"`&Will this suit you?`7\""
• 3. Confirmation: [Yes] or [No]
• 4. If Yes + sufficient funds: "Percy Weasley reaches behind a painting and hands you a tiny vial of shimmering fairy dust. In return you grudgingly give him one of your precious gems."
• 5. Deduct 200 points + 1 gem, increment bottle count

Insufficient Funds Messages:

• Missing points + gem: "I'm sorry, but you do not have the %s points, nor the gem, required."
• Missing only points: "I'm sorry, but you do not have the %s points required."
• Missing only gem: "I'm sorry, but you do not have the gem required."
• Percy "looks down his nose at you" (condescending)

Using Bottles

Activation:

• Forest navigation (hook)
• Link appears: "U?Use a Bottle of Fairy Dust" (only if bottles ≥ 1)
• Click to use one bottle

Use Sequence:

• 1. "`%You cautiously unstopper the tiny vial of dust and, holding your breath, tip the contents over your head with your eyes shut."
• 2. "A shimmering rain of dust cascades over you!`n`n`^"
• 3. Bottle count decremented (bottles--)
• 4. Buff applied (if setting enabled)
• 5. Random reward rolled (e_rand 1-7)
• 6. "You now have %s bottles of Fairy dust left!"
• 7. "Moments later, you open your eyes, blinking away remnants of glittering dust."
• 8. Debug log: "used Fairy Dust"

Fairy Dust Buff

Buff Details:

• Name: "`\$Fairy Dust"
• Rounds: 10 combat rounds
• Effect: +10% defense (defmod 1.1)
• Round msg: "The dust shimmers around you, making you harder to hit!"
• Wearoff: "You have shaken all the dust off."
• Schema: "module-fairydust"

Buff Settings:

• Admin can disable buff (setting "buff" = 0)
• If disabled: Only random reward, no defensive bonus
• Default: Enabled (buff = 1)
• Message if enabled: "The dust conceals you from the eyes of enemies!`n`n"

Random Rewards

7 Outcomes (e_rand 1-7):

Case 1: Extra Forest Fights (14.3%):

• Reward: +forest fights (configurable, default 1)
• Message (if 1 fight): "You receive an extra forest fight!"
• Message (if >1): "You receive %s extra forest fights!"
• Setting: "fftoaward" (range 1-5, default 1)

Case 2-3: Find Gems (28.6% combined):

• Reward: +2 gems
• Message: "You feel perceptive and notice `%TWO gems`^ nearby!"
• Debug log: "found 2 gem from fairy dust"
• 2 cases = 28.6% probability (2/7)

Case 4-5: Max HP Gain (28.6% combined):

• Reward: +max HP (configurable, default 1)
• Message: "Your maximum hitpoints are `b%s`b increased by %d!"
• Permanent OR temporary (depends on "carrydk" setting)
• If carrydk=1: "permanently" (carries across VE)
• If carrydk=0: "temporarily" (resets on VE)
• Also increases current HP by same amount
• Tracked in "extrahps" pref
• Setting: "hptoaward" (range 1-5, default 1)
• 2 cases = 28.6% probability (2/7)

Case 6-7: Specialty Point (28.6% combined):

• Reward: +1 specialty point
• Message: (increment_specialty function, displays specialty-specific message)
• Adds to current specialty progress
• 2 cases = 28.6% probability (2/7)

Probability Table

Outcome	Cases	Probability	Reward
Forest Fights	1	14.3%	+1 fight (default)
Gems	2-3	28.6%	+2 gems
Max HP	4-5	28.6%	+1 max HP (default, perm/temp)
Specialty	6-7	28.6%	+1 specialty point

HP Carry Settings

Permanent HP (carrydk = 1, default):

• Max HP increase persists across VE (dragonkills)
• Tracked in "extrahps" pref
• Recalculated at hprecalc hook
• Permanent character progression
• Can accumulate unlimited HP via multiple bottles

Temporary HP (carrydk = 0):

• Max HP increase resets on VE
• Cleared at hprecalc if VE occurred
• Only lasts current DK cycle
• Prevents HP stacking exploits

Global HP Module Interaction:

• If globalhp module active: Checks globalhp's carrydk setting too
• Both must be enabled for permanent HP
• If either disabled: Temporary HP

Inventory System

Stacking:

• Pref: "fairydustbottles" (int, default 0)
• Can own unlimited bottles
• Each purchase: bottles++
• Each use: bottles--
• Display: "You now have %s bottles of Fairy dust left!"

Navigation:

• Forest link only appears if bottles ≥ 1
• No link when bottles = 0
• Can buy in bulk (multiple purchases)
• Can use multiple per forest trip

Cost Analysis

Price Breakdown:

• 200 donation points (default)
• +1 gem (always required)
• Points ≈ $20 real money (if purchasing)
• Or earned via donations/rewards
• Gem = in-game currency (moderate value)

Value Proposition:

• +10% def for 10 rounds (minor buff)
• +Random reward (28.6% chance for each of 4 outcomes)
• Most rewards minor (1-2 resources)
• HP gain potentially valuable long-term
• Overall: Expensive for mediocre returns

Best Case Scenario:

• +10% def buff (10 rounds)
• +1 permanent max HP (if HP outcome + carrydk=1)
• Accumulate HP over many bottles
• Worth it IF you buy many bottles

Worst Case Scenario:

• +10% def buff (10 rounds)
• +1 forest fight (14.3% outcome)
• Spent 200 points + 1 gem for minimal gain
• Not worth the cost

Strategy Guide

When to Buy:

• Have excess donation points (not spending on better items)
• Want permanent HP gain (if carrydk=1)
• Planning to buy many bottles (accumulate HP)
• Need minor def buff for upcoming fights

When to Skip:

• Limited donation points (save for better lodge items)
• Temporary HP only (carrydk=0, not worth it)
• F2P player (can't afford 200 points)
• Gem-poor (need gems for other uses)

Optimal Use:

• Buy in bulk if going for HP stacking strategy
• Use before difficult forest encounters (buff active)
• Hope for HP outcomes (28.6% × many bottles = accumulate)
• Track extrahps pref to see total HP gained

Admin Configuration

Settings:

• cost: Points cost per bottle (int, default 200)
• buff: Enable defense buff? (bool, default 1)
• carrydk: HP gain permanent across VE? (bool, default 1)
• hptoaward: HP amount given (range 1-5, default 1)
• fftoaward: Forest fights given (range 1-5, default 1)

Balancing:

• High cost (400+): Luxury item, rare use
• Low cost (50-100): More accessible, common use
• Disable buff: Nerf (only random reward)
• Temporary HP: Prevents stacking exploits
• Higher HP/FF awards: More generous

Limitations

• Expensive: 200 points + 1 gem (high cost for minor rewards)
• RNG Rewards: Can't control outcome (lottery system)
• Minor Buff: +10% def for 10 rounds (not game-changing)
• Gem Tax: Always costs gem (can't buy with just points)
• Forest Only: Can't use outside forest (limited utility)
• Pay-to-Win: 200 points ≈ real money (favors donors)