Additional Dwelling Keys

Requirements

• Dwellings module: Core housing system
• Must own a dwelling that supports extra keys

How It Works

Accessing the Keymaker:

• Go to your dwelling Management page
• Click "Keymaker" link (appears if dwelling type allows extra keys)
• Dwarf keymaker appears at desk

Purchase Flow:

• Dwarf tells you the cost (gold + gems + donation points)
• Default costs per key (configurable by admin):
  • Gold: varies by dwelling type
  • Gems: varies by dwelling type
  • Donation points: 50 (default keydonationcost)
• Click "Yes" to confirm purchase
• Resources deducted, addkeys pref incremented
• Dwelling's maxkeys increases by 1

Dwarf Dialogue:

• Enter smithy: "Soso, you would like to buy more keys?"
• Success: "Think about it carefully, whom you like to give it."
• Failure: "Did I not just tell you what it costs to get an extra key? So why do you waste my precious time?!"

Costs & Validation

Resource Requirements:

• Must have enough gold (keygoldcost)
• Must have enough gems (keygemcost)
• Must have enough unspent donation points (keydonationcost)

If You Can't Afford:

• Dwarf yells at you for wasting his time
• Leave embarrassed without key
• No resources deducted

Admin Configuration

Per Dwelling Type Settings:

• keys: Does this dwelling type sell extra keys? (bool, default: 0)
• keygemcost: Gem cost per key (int, default: 0)
• keygoldcost: Gold cost per key (int, default: 0)
• keydonationcost: Donation points per key (int, default: 50)

Example Configuration:

• Cottage: 0 keys allowed (can't buy extra keys)
• Mansion: Keys enabled, cost 10,000 gold + 5 gems + 50 points
• Castle: Keys enabled, cost 50,000 gold + 20 gems + 100 points

How Keys Affect Roommates

Maxkeys Calculation:

• Base maxkeys = dwelling type's default roommate capacity
• Extra keys = addkeys pref for your dwelling
• Total maxkeys = base + addkeys

Example:

• Mansion base maxkeys = 3 roommates
• Buy 2 extra keys → addkeys = 2
• New maxkeys = 5 roommates

Strategy

When to Buy Extra Keys:

• You have a large active clan with many potential roommates
• You want to run a "boarding house" for new players
• You have excess donation points to spend
• Your dwelling type's base maxkeys is too low

When to Skip:

• You live alone or with just 1-2 roommates
• Donation points better spent on other lodge items
• Your dwelling already has enough room

Cost-Benefit Analysis:

• Each key = permanent +1 roommate capacity
• 50 donation points = ~$5 USD (default donation ratio)
• Worth it if you actively use roommate system
• Not worth it if you rarely interact with roommates

Limitations

• No Refunds: Once purchased, keys are permanent (can't sell back)
• Dwelling-Specific: Keys bound to specific dwelling, not transferable
• Admin Control: Admin can disable extra keys for specific dwelling types
• No Limit: No hard cap on number of extra keys you can buy (theoretically unlimited roommates)

Compatibility

• Requires Dwellings module 20051118 or later
• Compatible with other dwelling addons (Dwelling Upgrades, etc.)
• Works with any dwelling type that enables "keys" setting