House Christmas Trees

Tree Purchase (Heads of House Only)

Access:

• Must be Head of House (clanrank == CLAN_LEADER)
• Navigation: "Buy a Tree" (appears in Christmas Options if treebuy enabled)
• Meet Sativ (salesman setting, default name)
• Assistant: `\$Sktim`7 (handles delivery)

Tree Options:

• Small, Scraggly Tree: `^5,000 Gold`& + `%5 Gems`&
  • basetree = 10 points
  • "Even the Dwarves of your House are taller than it"
  • `\$Sktim`@ carries it one-handed
• Medium, Pretty Tree: `^10,000 Gold`@ + `%10 Gems`@
  • basetree = 20 points
  • "A decent size"
  • `\$Sktim`@ struggles with awkwardness, makes it through entrance
• Large, Grand Tree: `^25,000 Gold`2 + `%25 Gems`2
  • basetree = 50 points
  • "Topmost branch scraping the ceiling"
  • Too heavy for trolls, requires mages using levitation practice

Purchase Result:

• Gold/gems deducted from Head of House
• havetree clan pref set to 1
• basetree set to 10/20/50
• Tree placed in Common Room near entrance
• "Now the members of your House will have something to decorate - it needs tinsel and baubles to liven it up, as well as goodly time arranging it."

Decoration System

Three Contribution Types:

• Time (Turns): Free, uses forest fights
• Tinsel (Gold): Buy from `7Abigail`^ (Easter grass, expensive)
• Baubles (Gems): Buy from `7Abigail`% (hand-crafted by elves, gem-only)

Spending Turns:

• Navigation: "Work on Tree"
• "You reckon that if you spent a while working on it, rearranging the ornaments, it could look a lot better."
• Form: Enter number of turns to spend (range 0 to current turns)
• Turns deducted immediately
• time clan pref increments by amount
• Message: "`&Though you don't have as much materials, time or space to do as much as you would like to, when you finish you feel a definite improvement has taken place. `@You return to your Common Room, your spirits lifted."

Buying Tinsel (Gold):

• Navigation: "Buy Tinsel"
• "`^Though your tree looks very pretty, you reckon that it could do with some more Easter grass tucked all around it to decorate it."
• "`7Abigail`^ charges through the nose for it due to the difficulty of supply."
• Form: Enter gold amount
• Gold deducted, gold clan pref increments
• Message: "`7Abigail`^ takes the gold you offer and within the hour a nice, albeit smaller than you would like, pile of tinsel has arrived in your Common Room. You hope that someone else has the time to arrange it properly."

Buying Baubles (Gems):

• Navigation: "Buy Baubles"
• "`%Though your tree looks very pretty, you reckon that it could do with some more ornaments livening it up."
• ".startlingly beautiful, being hand-crafted by a remote tribe of elves (or so `7Abigail`% says)."
• Form: Enter gem amount
• Gems deducted, gems clan pref increments
• Message: "`7Abigail`% takes the gems you offer and hands you a couple of beautiful ornaments to hang on your tree. You go back to the clan and hang them up on a few of the branches - maybe someone else will have time to hang them so they look good."

Tree Points Calculation

Formula:

• treepoints = basetree + gems + floor(time/10) + floor(√(gold/1000))
• Recalculated after EVERY contribution
• Stored in treepoints clan pref

Component Breakdown:

• basetree: 10/20/50 (one-time from tree purchase size)
• gems: 1:1 ratio (best ROI!)
• time: 10 turns = 1 point (okay ROI, free resource)
• gold: √(gold/1000) (terrible ROI)
  • 1,000 gold = 1 point
  • 4,000 gold = 2 points
  • 9,000 gold = 3 points
  • Quadratic scaling = exponentially expensive

Example Tree:

• Grand Tree (basetree = 50)
• Members spent: 100 turns (time = 100), 10,000 gold, 25 gems
• treepoints = 50 + 25 + floor(100/10) + floor(√(10000/1000))
• treepoints = 50 + 25 + 10 + floor(√10)
• treepoints = 50 + 25 + 10 + 3 = 88 points
• Still need 12 more points to reach treebonus threshold (100)

Buff System

Activation Threshold:

• treebonus setting (default: 100 points)
• When treepoints >= treebonus: Buff activates for all House members
• Message: "Your tree is very pretty, and as you look at it your spirit lifts.`n`n"
• Applies buff: '`@Christmas Spirit" (name hardcoded)

Buff Properties:

• Name: "`@Christmas Spirit"
• Rounds: treereward setting (default: 15)
• Effect: defmod 1.15 (+15% defense)
• Wearoff: "The cold around saps your joy."
• Roundmsg: "You feel the blessing of the season!"
• Schema: module-clantrees
• Once per day (gotbuff pref, resets at newday)

Best Tree Bonus (if competitive mode):

• If your House has highest treepoints: Buff duration × 2
• Example: treereward = 15 → best tree gets 30 rounds
• Village announcement: "The biggest, sparkliest, twinkliest tree belongs to the `@[HouseName]`& House!"
• House notification: "`@Your tree is the best tree in the Common Rooms!`n"

Competitive Mode

Setting: competitive (bool, default: 0):

• If enabled: Houses compete for "best tree" status
• Best tree determined by highest treepoints across all Houses
• besttree setting stores winning clanid
• Village desc shows: "The biggest, sparkliest, twinkliest tree belongs to the [HouseName] House! Many of the other Common Rooms also sport beautifully decorated trees in their windows."

If disabled (non-competitive):

• Village desc: "Many of the Common Room windows sport beautifully decorated trees!"
• All Houses receive standard buff (no 2x bonus)
• No "best tree" tracking

Claiming Best Tree:

• After contribution, treepoints recalculated
• If points > get_module_objpref("clans", besttree, "treepoints"): You become new best tree
• besttree setting updated to your clanid
• Message: "`@Your contribution has made your tree so much better it is now the best one in the Halls! The twinkliness is nearly blinding!"

Sativ the Salesman

Village Presence:

• When treebuy enabled: "`&You see %s `0 carrying Holiday Trees to the Common Rooms.`n"
• Salesman name configurable (default: "Sativ")
• Has brutish troll guarding Grand Trees
• Assistant `\$Sktim`7 handles deliveries

Grand Tree Delivery Scene:

• `\$Sktim`@ takes one look at leviathan tree, gets backup
• Trolls give up (too heavy)
• Mage wanders by lecturing apprentices on levitation basics
• `\$Sktim`@ quickly takes advantage, wizards help move tree "for levitation practice"
• Collaborative community effort (wholesome!)

Strategy Guide

Resource Efficiency:

• Best ROI: Gems (1:1 ratio)
• Good ROI: Turns (10:1 ratio, free resource)
• Terrible ROI: Gold (quadratic scaling, avoid unless rich)
• To reach 100 points from Small Tree (10 base): Need 90 gems OR 900 turns OR ~8.1 million gold (don't do this)

Tree Size Choice:

• Grand Tree (50 base) = halfway to buff threshold (100)
• Only need 50 more points = 50 gems or 500 turns
• Small Tree (10 base) = need 90 points (180% more effort)
• If House can afford: Always buy Grand

Competitive Strategy:

• If competitive mode: Focus all House resources on tree (2x buff worth it)
• Monitor other Houses' trees (village announcement shows current best)
• Last-minute gem dumps can steal best tree status
• If non-competitive: Only spend until threshold reached (no point beyond 100)

Limitations

• Head of House Only Purchase: Members can't buy tree (must wait for Head of House)
• No Refunds: Tree purchase permanent (can't remove/downgrade)
• Gold ROI Terrible: 1000 gold = 1 point (extremely expensive for little gain)
• Seasonal Module: Admin controls treebuy toggle (not always available)
• Once/Day Buff: Can only receive Christmas Spirit buff once per day (gotbuff pref)
• No Visualization: Can't see tree appearance (just points counter)
• Competitive Stress: Other Houses can steal "best tree" status at any time