Skip to main content

Player Engagement

Features designed to increase player engagement with random orders.

Overview​

Engagement features reward players for fulfilling random orders and create special events to keep gameplay interesting.

Completion Bonuses​

Reward players with extra money for fulfilling random orders:

engagement:
  completion-bonus: true
  bonus-multiplier: 1.1  # 10% bonus

When enabled, players receive a bonus on top of the order price.

Special Events​

Create scheduled events with bonus multipliers:

engagement:
  special-events: true
  event-schedule:
    - name: "Double Rewards Hour"
      start-time: "20:00"
      end-time: "21:00"
      days: [friday, saturday]
      bonus-multiplier: 2.0

Events can run on specific days and times.

Urgent Orders​

Random orders can be marked as urgent for higher rewards:

engagement:
  default-priority: 0  # 0 = normal, 1 = urgent
  urgent-chance: 0.1  # 10% chance

Urgent orders are highlighted in the GUI.

Event Announcements​

Announce special random orders to players:

engagement:
  announce-special: true

Players are notified when special orders are created.

Event Task​

The addon runs an event check every 5 minutes to:

  • Check for scheduled events
  • Create special orders during events
  • Apply event bonuses

Fulfillment Listener​

Tracks order fulfillment and:

  • Applies completion bonuses
  • Logs fulfillment statistics
  • Triggers event rewards

Examples​

Basic Engagement​

engagement:
  completion-bonus: true
  bonus-multiplier: 1.1
  urgent-chance: 0.1

Full Engagement Setup​

engagement:
  completion-bonus: true
  bonus-multiplier: 1.2
  special-events: true
  announce-special: true
  urgent-chance: 0.15
  event-schedule:
    - name: "Weekend Bonus"
      start-time: "18:00"
      end-time: "22:00"
      days: [saturday, sunday]
      bonus-multiplier: 1.5

Next Steps​