Changelog

All notable changes to MC Timer Mod will be documented in this file.

[1.0.3] - 2025-11-10

Fixed

• Y-Offset now works correctly for all alignment positions (TOP, CENTER, BOTTOM)
• Y-Offset is now applied consistently as a relative offset value

Changed

• Renamed "Pause Menu Effect" to "Pause Animation" for clarity
• Replaced pause menu effects (BLUR, DARKEN, GLOW) with animation effects (✨, PULSE)
• Pause menu now uses the same animation system as normal timer display
• Default Y-Offset changed from 59 to -59 to maintain backward compatibility

Technical

• Refactored calculateY() method to properly handle offsets for all alignments
• Added getPauseEffectColor() method for pause menu animation colors

---

[1.0.2] - 2025-11-10

Added

• Configurable Timer Position via Mod Menu
  • Horizontal Alignment: LEFT, CENTER, RIGHT
  • Vertical Alignment: TOP, CENTER, BOTTOM
  • X/Y Offset fields for precise positioning
• Pause Menu Effects (later changed to animations in 1.0.3)
  • BLUR: Semi-transparent black background
  • DARKEN: Darker overlay behind timer
  • GLOW: Pulsing glow effect around timer
• New configuration options in mctimer.json:
  • horizontalAlignment
  • verticalAlignment
  • offsetX
  • offsetY
  • pauseMenuEffect

Changed

• Completely rewrote configuration screen with new position controls
• Updated timer rendering to use configurable positions instead of hardcoded values
• Improved config screen layout with better organization

Technical

• Added HorizontalAlignment enum (LEFT, CENTER, RIGHT)
• Added VerticalAlignment enum (TOP, CENTER, BOTTOM)
• Added PauseMenuEffect enum (NONE, BLUR, DARKEN, GLOW - later changed)
• Added calculateX() and calculateY() static methods in TimerConfig
• Fixed all obfuscated class names to use proper Yarn mappings
• Set up Gradle build system for easier compilation

---

[1.0.1] - Previous Version

Features

• In-game timer with /timer commands
  • /timer start - Start or resume timer
  • /timer pause - Pause the timer
  • /timer reset - Reset timer to 0:00
• HUD display with customizable colors
• Per-world timer persistence
• Animation types: NONE, ✨, PULSE
• Configurable colors for normal and paused states
• Auto-pause on world disconnect
• Mod Menu integration for configuration

---

Installation

1. Download the latest .jar file from build/libs/
2. Place it in your Minecraft mods folder
3. Requires Fabric Loader >= 0.16.9 and Minecraft 1.21.4

Requirements

• Minecraft: 1.21.4
• Fabric Loader: >= 0.16.9
• Fabric API: Required
• Mod Menu: Optional (but recommended for configuration GUI)
• Java: >= 21