Wynncraft Acolyte QOL
Adds quality of life features for the Acolyte archetype in Wynncraft
📖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
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:
FFFF00yellow) - Timer Color - Set the color for the active damage phase (Hex format, default:
FFFFFFwhite)
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:
00FFFFcyan)
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:
FF0000red) - 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 |
