Holiday Hotel (Christmas Inn)

Overview

What Is Holiday Hotel?:

• Seasonal replacement for standard capital inn
• Active during December holiday period (default: Dec 15-25)
• Replaces inn description, drinks, and bartender behavior
• 2 Christmas-themed drinks with combat buffs
• Random bartender costume system (13+ holiday outfits)
• Returns to normal inn after December 25

Location Requirements:

• Capital inn only (villagename check)
• Must be during active holiday period (Dec 15-25 default)
• Automatically replaces standard inn when active
• No player action needed (seamless transition)

Activation Period

Default Schedule:

• Start Date: December 15 (real-world calendar)
• End Date: December 25 (Christmas Day)
• Duration: 10 days total
• Server Configurable: Admins can adjust dates
• Automatic: No installation/activation needed

Out of Season:

• Outside Dec 15-25: Standard inn displays normally
• No holiday drinks available
• Regular bartender (no costumes)
• Module hooks inactive until next December

Holiday Hotel Description

Inn Atmosphere:

• Festive Christmas decorations throughout
• Holiday music playing in background
• Seasonal food and drink menu
• Cheerful (or chaotic) holiday ambiance
• Replaces standard inn description text completely

Narrative Flavor:

• Describes decorations: garlands, lights, ornaments
• Mentions holiday cheer (or forced merriment)
• References seasonal festivities
• Sets Christmas mood before drink selection

Christmas Drinks

Two Special Holiday Beverages:

1. Gingerbread Latte

• Description: Warm, spiced coffee drink with gingerbread flavor
• Effect: Defense buff
• Buff Name: "`%Gingerbread Warmth" (purple color)
• Buff Stats:
  • defmod: 1.05 (+5% defense)
  • Rounds: 25
  • Roundmsg: "The gingerbread warmth makes you more defensive!"
  • Wearoff: "The gingerbread warmth fades."
  • Schema: module-holidayhotel
• Best For: Defensive players, tanking difficult fights
• Duration: 25 forest fights (long-lasting buff)

2. Candy Cane Cocktail

• Description: Peppermint-flavored alcoholic beverage
• Effect: Attack buff
• Buff Name: "`^Peppermint Rush" (cyan color)
• Buff Stats:
  • atkmod: 1.03 (+3% attack)
  • Rounds: 15
  • Roundmsg: "The peppermint rush helps you attack harder!"
  • Wearoff: "The peppermint rush wears off."
  • Schema: module-holidayhotel
• Best For: Offensive players, dragon kills, PvP
• Duration: 15 forest fights (moderate buff)

Drink Strategy

Which Drink to Choose?:

• Gingerbread Latte:
  • Better for: Surviving difficult fights (dragons, tough forest creatures)
  • Longer duration (25 rounds vs 15)
  • Higher buff percentage (+5% vs +3%)
  • Generally superior choice for most situations
• Candy Cane Cocktail:
  • Better for: Speed kills, maximizing damage output
  • Shorter duration (finishes fights faster)
  • Weaker buff (+3% attack)
  • Use if you prefer offense over defense

Expected Value Analysis:

• Gingerbread Latte: +5% defense × 25 rounds = 125% total defensive value
• Candy Cane Cocktail: +3% attack × 15 rounds = 45% total offensive value
• Mathematical Winner: Gingerbread Latte (2.78× better value)
• Defense buffs generally more valuable (reduce damage taken = live longer)
• Recommendation: Default to Gingerbread Latte unless you specifically need attack

Bartender Costume System

Random Holiday Transformations:

• Bartender randomly dresses as different holiday characters
• 13+ different costume possibilities (configurable)
• Changes randomly each visit (or periodically)
• Purely cosmetic (no mechanical effect)
• Adds variety and humor to holiday inn experience

Costume Options Include:

• `4Santa Claus`7: Classic red suit, white beard
• `2Elf`7: Green outfit, pointed ears, jingles
• `1Grinch`7: Green fur, mean expression
• `!Rudolph`7: Red nose, antlers, reindeer costume
• `^Frosty the Snowman`7: White outfit, carrot nose
• `%Mrs. Claus`7: Holiday dress, matronly appearance
• Nutcracker: Soldier costume, stiff movements
• Candy Cane: Red and white striped outfit
• Christmas Tree: Decorated tree costume
• Ornament: Shiny ball costume
• Wrapped Present: Gift box costume
• Wise Man/Three Kings: Biblical robes
• Angel: White robes, wings, halo
• .and potentially more! (13+ total)

Flavor Text:

• Describes bartender's current costume when you arrive
• May include dialogue in character
• Humorous descriptions of costume absurdity
• Example: "`tAberforth`7 is dressed as an elf today, bells jingling with every movement."

Comparison to Standard Inn

Standard Inn (Non-Holiday):

• Standard drinks: Ale, Pint, Swill, etc.
• Normal bartender behavior (no costumes)
• Regular inn description text
• Various drink effects (mostly drunkenness/charm)

Holiday Hotel (Dec 15-25):

• Christmas drinks: Gingerbread Latte, Candy Cane Cocktail
• Costumed bartender (13+ random outfits)
• Festive inn description
• Combat buff focus (defmod/atkmod instead of drunkenness)

Trade-offs:

• Lose: Standard drink variety, normal inn atmosphere
• Gain: Combat buffs, holiday theme, bartender comedy
• Temporary: Only 10 days, then back to normal
• No Choice: Module automatically replaces inn (can't opt out)

Integration with Other Modules

Compatibility:

• Works alongside Christmas Holiday text filter (holiday_xmas)
• Coordinates with Yule Ball event (holiday_yuleball)
• Part of broader December holiday theme
• May reference Christmas Trees clan module
• Coordinates with other seasonal events

Hook Priority:

• Uses "inn" hook to replace standard inn description
• High priority to ensure holiday theme displays
• Overrides default inn text completely during active period

Strategy Guide

Maximizing Holiday Hotel:

• Visit Daily: Get your buff before forest fights
• Choose Gingerbread Latte: Better stats, longer duration
• Time Your Buffs: Drink before dragon attempts or difficult fights
• Stack with Other Buffs: Combine with potions, blessings, etc.
• Enjoy the Costumes: Read bartender descriptions for humor

Min-Maxing:

• Gingerbread Latte (25 rounds, +5% def) is objectively superior to Candy Cane Cocktail
• Use during December for free combat buffs
• Take advantage of limited-time event
• After Dec 25: Back to standard inn drinks (no holiday buffs)

Roleplay Considerations:

• Christmas-aligned characters: Embrace the holiday theme
• Grinchy characters: Complain about forced merriment in commentary
• Pragmatic characters: Just take the free buff and move on

Limitations

• Seasonal Only: Dec 15-25 default (10 days per year)
• Capital Inn Only: Doesn't affect other cities
• Replaces Standard Inn: Lose access to normal drinks during holiday
• No Opt-Out: Can't disable if you prefer standard inn
• Random Costumes: Can't choose which bartender costume appears
• Modest Buffs: +3-5% not game-changing (but still helpful)