ChronosRewind

Chronos Rewind

A BepInEx mod for Mage Arena that introduces temporal manipulation mechanics through the "Chronos Rewind" spell. Harness the power of Chronos to rewind your position and health, escaping danger or repositioning strategically!

Features

• Chronos Rewind Spell: Rewind your position and health to a previous state (default: 3 seconds ago)
• Configurable Settings: Adjust cooldown, rewind duration, and kill window timing through the game's settings menu
• Visual & Audio Effects: Distinctive effects that alert nearby players when you cast the spell
• Custom Death Tracking: Special attribution and icons for rewind-related kills
• Network Synchronized: Works seamlessly in multiplayer with server-authoritative position tracking

Installation

Prerequisites

1. BepInEx 5.4.21+ - The mod framework for Unity games
2. ModSync 1.0.6+ - For mod synchronization in multiplayer
3. BlackMagicAPI 2.4.0+ - Core API for Mage Arena spell mods
4. FishUtilities 1.2.4+ - Networking utilities for multiplayer functionality
5. MageConfigurationAPI 1.3.1+ - Configuration system for mod settings

Installation Steps

1. Install BepInEx for Mage Arena if you haven't already
2. Install all required dependencies listed above (available on Thunderstore)
3. Download this mod and extract the contents to your BepInEx/plugins/ChronosRewind/ folder
4. Verify installation by checking that the following files are present:

• BepInEx/plugins/ChronosRewind/ChronosRewind.dll
• BepInEx/plugins/ChronosRewind/chronomancer.bundle
• BepInEx/plugins/ChronosRewind/manifest.json

1. Launch the game - the mod will initialize automatically

Multiplayer Requirements

⚠️ IMPORTANT: ALL PLAYERS must have this mod installed for multiplayer compatibility.

• Server Host: Must have the mod installed
• All Clients: Must have the mod installed with the same version
• Reason: The mod adds new spell types, network synchronization, and custom assets that all players need to see and interact with
• ModSync Dependency: Helps ensure all players have compatible mod versions
• Consequences of Mismatch: Players without the mod may experience crashes, missing spells, or desync issues

Troubleshooting Installation

• Spell not appearing: Ensure all dependencies are installed and up to date
• Missing effects: Verify that chronomancer.bundle is in the mod directory
• Configuration issues: Check BepInEx console for error messages
• Multiplayer sync issues: Ensure all players have the same mod version

Configuration

Access these settings through the game's configuration menu:

Chronos Rewind Settings

• Rewind Cooldown (10-120 seconds, default: 45s)
• Time between spell casts
• Lower values make the spell more frequent but potentially overpowered
• Higher values emphasize strategic timing

• Rewind Duration (1-10 seconds, default: 3s)
• How far back in time to rewind your position and health
• Longer durations provide more escape potential but use more memory
• Shorter durations require more precise timing

• Kill Window (1-10 seconds, default: 3s)
• Time window after casting recall for kills to count as "recall-related"
• Affects death attribution and statistics tracking
• Used for custom death messages and icons

• Can Spawn In Chests (default: false)
• Controls whether Chronos Rewind spell can spawn naturally in team chests
• Disabled by default to prevent the spell from being too common
• Enable this if you want the spell to appear alongside other spells in chests

Debug Settings

• Enable Debug Mode (default: false)
• Enables detailed logging for troubleshooting
• Only enable if experiencing issues or for development

Usage

Finding the Spell

• By default, the Chronos Rewind spell does NOT spawn in team chests
• Enable "Can Spawn In Chests" in the configuration if you want it to appear naturally in team chests
• When enabled, look for the distinctive cyan-blue glow when the spell appears in your inventory
• The spell follows standard Mage Arena spell mechanics for equipping and casting
• Alternative: Server admins can spawn the spell manually or through other mods

Casting the Spell

1. Equip the Chronos Rewind spell in your spell slot
2. Cast the spell by saying "Chronos Rewind"
3. Observe the spell page, once it light up again you can recast
4. Listen for the distinctive audio cue that plays when casting

Strategic Usage

• Escape Tool: Cast when low on health to return to a safer position with restored health
• Repositioning: Use to return to advantageous positions after aggressive plays
• Baiting: Advanced players can use recall to bait enemies into unfavorable positions
• Team Fights: Recall can help you re-engage fights from better angles

Counterplay

• Audio Cues: Listen for the distinctive recall sound to know when enemies use the spell
• Timing: The spell has a significant cooldown - track when enemies use it
• Positioning: Be aware that recalled players return to their previous positions
• Kill Window: You have a brief window after someone rewinds to get "rewind-related" kills

Technical Details

Performance

• Memory Usage: Approximately 1-2MB per player for position history tracking
• CPU Impact: <1% additional CPU usage during normal gameplay
• Network Traffic: Minimal additional network overhead for synchronization

Compatibility

• Mod Compatibility: Designed to work alongside other BlackMagicAPI spell mods
• Game Version: Compatible with current Mage Arena versions
• Multiplayer: Full multiplayer support with server-authoritative state management
• Installation Requirement: ALL PLAYERS must have the