Wynncraft Acolyte QOL
ModLicenseRef-All-Rights-Reserved

Wynncraft Acolyte QOL

Adds quality of life features for the Acolyte archetype in Wynncraft

181
Downloads
0
Followers
5 months ago
Updated
📦
2
Versions

📖About Wynncraft Acolyte QOL

Blood Sorrow & Eldritch Call Timer

This mod adds on-screen countdown timers for the Acolyte's Blood Sorrow and Eldritch Call spells in Wynncraft. The timers automatically detect when you cast these spells and display the remaining duration with customizable appearance, position, and alarm settings.

The mod works with both manual spell casting and the Wynncraft Spellcaster mod, and includes optional Wynntils integration for enhanced Eldritch Call tracking.


Installation and Use

To install, simply download the latest version and put it in your mods folder.

This mod runs on Minecraft Fabric 1.21.4.

Required Dependencies

Optional Dependencies

  • Wynntils (for enhanced Eldritch Call tracking)

Video Showcase

Watch the video


Configuration

The configuration menu can be opened through a keybind (default: K) or by navigating through Mod Menu. The menu is organized into two tabs: Blood Sorrow and Eldritch Call.

Blood Sorrow Settings

Main Settings

  • Timer Enabled - Toggle the Blood Sorrow timer display
  • Using Resonance - Toggle Using Resonance, which reduces timer duration to 25% of normal
  • Aspect Tier - Select your current Acolyte Aspect tier to adjust timer duration (+1s for T1, +2s for T3)
    • None
    • Tier 1
    • Tier 3
  • Drag Position - Opens an interactive screen where you can drag the timer to any position with snap-to-grid alignment
  • Text Settings - Opens the appearance customization menu

Text Settings

  • Text Scale - Adjust the size of the timer text (0.5x - 2.0x)
  • Text Prefix - Add custom text before the timer (e.g., "BS: ")
  • Startup Color - Set the color for the 1-second startup phase (Hex format, default: FFFF00 yellow)
  • Timer Color - Set the color for the active damage phase (Hex format, default: FFFFFF white)

Eldritch Call Settings

Main Settings

  • Use Wynntils Tracking - Use Wynntils API for accurate totem tracking when available (appears only if Wynntils is detected)
  • Timer Enabled - Toggle the Eldritch Call timer display
  • Drag Position - Opens an interactive screen where you can drag the timer to any position with snap-to-grid alignment
  • Text Settings - Opens the appearance customization menu
  • Alarm Settings - Opens the alarm configuration menu

Text Settings

  • Text Scale - Adjust the size of the timer text (0.5x - 2.0x)
  • Text Prefix - Add custom text before the timer (default: EC: )
  • Timer Color - Set the color for the timer text (Hex format, default: 00FFFF cyan)

Alarm Settings

  • Alarm Enabled - Toggle the expiration alarm
  • Alarm at - Set when the alarm triggers based on remaining time (0.5s - 10.0s)
  • Volume - Adjust alarm sound volume (0.0x - 5.0x)
  • Sound - Choose alarm sound
    • Explosion
    • Wither Spawn
    • Anvil Land
    • Thunder
    • Totem of Undying
  • Show Alarm Text - Toggle the on-screen text popup when alarm triggers
  • Text - Customize the alarm text message (default: TOTEM EXPIRING!)
  • Scale - Adjust alarm text size (1.0x - 5.0x)
  • Duration - How long the alarm text stays on screen (0.5s - 5.0s)
  • Text Color - Set the alarm text color (Hex format, default: FF0000 red)
  • Drag Alarm Position - Position the alarm text independently from the timer

Timer Durations

Blood Sorrow

The mod automatically calculates the correct duration based on your settings. During the startup phase (first 1 second), the timer displays the maximum uptime value in the startup color, then counts down in the timer color.

Configuration Total Duration Display Behavior
Base 6.00s (1s startup + 5s damage) Shows 5.00s for 1s, then counts down
Tier 1 Aspect 7.00s (1s startup + 6s damage) Shows 6.00s for 1s, then counts down
Tier 3 Aspect 8.00s (1s startup + 7s damage) Shows 7.00s for 1s, then counts down
Base + Resonance 2.25s (1s startup + 1.25s damage) Shows 1.25s for 1s, then counts down
Tier 1 + Resonance 2.50s (1s startup + 1.5s damage) Shows 1.50s for 1s, then counts down
Tier 3 + Resonance 2.75s (1s startup + 1.75s damage) Shows 1.75s for 1s, then counts down

Eldritch Call

Fixed 10-second duration after a 0.5-second startup delay. When Wynntils integration is enabled, the timer syncs with Wynntils' totem tracking for maximum accuracy.


Wynntils Integration

When Wynntils is detected, the mod can use its totem tracking API for enhanced Eldritch Call accuracy:

  • Automatically detects totem placement and expiration
  • Syncs timer with actual game state
  • Falls back to manual tracking if Wynntils data is unavailable
  • Can be toggled on/off in the Eldritch Call settings

Features

  • Automatic Spell Detection - Detects RRL (Blood Sorrow) and RLR (Eldritch Call) patterns
  • Spellcaster Support - Full compatibility with Wynncraft Spellcaster keybinds
  • Dual Tracking System - Manual click tracking with optional Wynntils API integration
  • Customizable Alarms - Sound and visual alerts for Eldritch Call expiration
  • Independent Positioning - Drag each timer and alarm text to custom positions
  • Color Customization - Full hex color support for all text elements
  • Snap-to-Grid - Easy alignment with visual grid guides

Keybinds

Keybind Action Default
Open Config Opens the configuration menu K