Chronos Gem

Purchasing Gems

Lodge Shop Access:

• Navigate to Prefect's Lounge (lodge.php)
• Link appears: "Shop" → "Buy a Chronos Gem ([cost] points)"
• Default cost: 25 donation points
• Admin-configurable pricing

Purchase Sequence:

• 1. Click "Buy a Chronos Gem" link
• 2. Percy Weasley reaches up, blows dust off small silver box
• 3. Inside: Tiny rubies outlined with silver
• 4. Percy explains: "These are `^Chronos Gems`\$. When held to the light of the sun, they bring a day anew to the bearer."
• 5. Confirmation: "Do you wish to purchase one?" [Yes] [No]
• 6. If Yes: Percy smiles, drops gem in your hand
• 7. Percy's advice: "'When using the `^Chronos Gem`\$, you get all the benefits of a newday. use it wisely!'"
• 8. Donation points spent, hasgem counter incremented

Insufficient Points:

• "Percy Weasley stares at you for a moment then looks away as you realize that you don't have enough points to purchase this item."
• No purchase occurs
• Return to Lounge

Using the Gem

Activation:

• Must be in village (op=village hook)
• Navigation link appears: "Other" → "Use a Chronos Gem ([count])"
• Example: "Use a Chronos Gem (3)" if you own 3 gems
• Shows current gem inventory

Use Sequence:

• 1. Click "Use a Chronos Gem" link
• 2. Dramatic description: "Lifting the ruby gem into the vast light of the sun, it begins to glow and warm in your hand!"
• 3. "The surrounding area begins to grow brighter and brighter, until you cannot bear it anymore! You drop the gem and raise your hand to cover your eyes."
• 4. "A while later, the light dies down, and you are able to unshield your eyes."
• 5. "Looking around you, you notice the sun above [location] is not in quite the same position as before."
• 6. hasgem count decremented (gem consumed)
• 7. Debug log entry: "Used a Chronos Gem."
• 8. Redirect: newday.php (full newday process)

Newday Benefits:

• All standard newday hooks fire
• Forest fights restored
• Daily quest resets
• Buffs/debuffs advance/expire
• Turn counters reset
• Everything that happens at midnight happens NOW

Gem Inventory System

Stacking:

• hasgem pref: Tracks gem count (int, default 0)
• Can own unlimited gems (no hardcoded cap)
• Each purchase: hasgem++
• Each use: hasgem--
• Simple counter system

Display:

• Navigation shows current count: "Use a Chronos Gem (5)"
• Updates in real-time as gems used/purchased
• Only appears if hasgem >= 1 (no link when count = 0)

Persistence:

• Gems persist across newdays (not consumed automatically)
• Gems persist across VE (not reset on dragon kill)
• Permanent inventory until manually used
• Investment carries forward indefinitely

Admin Configuration

Settings:

• cost: Chronos Gem cost in donation points (int, default 25)
• Adjustable pricing for server economy
• Balance: Low cost = frequent newdays, High cost = rare luxury

User Preferences:

• hasgem: How many gems player owns (int, default 0)
• Auto-managed by module (don't manually edit unless debugging)

Use Cases

Strategic Advantages:

• Emergency Healing: Trigger newday to restore HP when low
• Turn Refresh: Get immediate forest fights for grinding
• Buff Reset: Reapply daily buffs (e.g., drinks)
• Quest Completion: Reset daily quests for rewards
• Event Participation: Access time-gated content early

Whale Strategies:

• Buy gems in bulk (e.g., 10+ at once)
• Use multiple gems per day for accelerated progression
• Example: Normal player gets 1 newday/day, whale gets 5 newdays/day = 5x progression
• Pay-to-win mechanic (donation points = real money)

Convenience Uses:

• Can't wait for midnight? Use gem NOW
• Want second attempt at daily content? Gem it
• Bored at work, want fresh content? Chronos Gem
• Instant gratification for impatient players

Economic Considerations

Value Proposition:

• 25 donation points = ~$2.50 real money (typical conversion)
• Benefit: Full newday whenever you want
• Worth it if: Time-gated content, competitive advantage, impatience
• Not worth it if: F2P player, patient, don't care about optimization

Server Balance Impact:

• Rich players advance faster (pay-to-win)
• Creates donation point sink (good for server economy)
• Incentivizes donations (revenue for server costs)
• Potential fairness concerns (F2P vs whale gap)

Flavor Text Analysis

Percy Weasley Characterization:

• Reaches up for dusty silver box (implying stored on high shelf, rarely used)
• Formal explanatory style: "When held to the light of the sun, they bring a day anew to the bearer"
• Cautionary advice: "use it wisely!" (responsible authority figure)
• If insufficient points: Stares then looks away (polite dismissal)
• Consistent with canon Percy personality (rule-following, serious)

Use Description Drama:

• Gem glows and warms in hand (magic activation)
• Area grows brighter and brighter (building tension)
• "until you cannot bear it anymore!" (climax)
• Drop gem, cover eyes (protective instinct)
• "sun. not in quite the same position" (time has passed)
• Subtle confirmation of temporal manipulation

Comparison to Other Newday Triggers

• Natural Newday: Automatic at server midnight, free
• Chronos Gem: Manual trigger, costs donation points, on-demand
• Admin Force Newday: Manual trigger, superuser only, debugging

Chronos Gem is ONLY player-accessible instant newday method (besides waiting).

Technical Details

Hooks Used:

• lodge: Adds "Buy a Chronos Gem" navigation
• village: Adds "Use a Chronos Gem" if hasgem >= 1
• pointsdesc: Describes gem in donation points explanation

Newday Trigger:

• Simple redirect: addnav("C?Continue","newday.php")
• No special parameters or flags
• Identical to standard newday process
• All hooks fire normally

Debug Logging:

• debuglog("Used a Chronos Gem.") on activation
• Tracks usage for admin oversight
• Can detect abuse or bugs

Limitations

• Donation Points Only: No gold/gem alternative (real money required)
• No Cooldown: Can spam multiple gems instantly (balance issue)
• No Refunds: Accidental use = gem lost permanently
• Pay-to-Win: Creates unfair advantage for rich players
• Village Only: Can't use from forest/other locations