Auction Timers

Countdown timers for Last Oasis auctions, events, and time-sensitive activities

Overview

Auction Timers provide customizable countdown timers for tracking auctions, respawn times, event schedules, and any time-sensitive activities in Last Oasis. Set multiple timers, add descriptions, and get audio alerts when time runs out.

Key Features

• Multiple Timers: Run as many countdown timers as you need simultaneously
• Customizable Duration: Set hours, minutes, and seconds for each timer
• Audio Alerts: Optional sound notification when timers complete
• Timer Descriptions: Label each timer to remember what you’re tracking
• Dynamic Controls: Add or remove timers on the fly
• Visual Alerts: Completed timers highlight in yellow for visibility

How to Use Auction Timers

1. Configure Audio Settings

   At the top of the page, choose whether you want sound alerts:

   • Sound On: Plays an audio alert (cobra.mp3) when any timer completes
   • Sound Off: Silent mode, only visual indicators

   The sound setting applies to all active timers. You’ll hear an alert for each timer that completes.

2. Set Timer Duration

   For each timer, set the countdown time:

   • Hours: 0-24 hours
   • Minutes: 0-59 minutes
   • Seconds: 0-59 seconds

   Input fields are large and easy to read, with right-aligned numbers.

3. Add a Description

   Use the Description field to note what the timer is for:

   • “Auction ends”
   • “Resource respawn”
   • “Walker unlocks”
   • “Event starts”
   • “Base repairs complete”
4. Start the Timer

   Click the green Start button to begin the countdown.

   The timer:

   • Counts down every second
   • Updates in real-time
   • Continues even if you switch to other tabs
5. Stop When Needed

   Click the red Stop button to pause the countdown.

   Stopped timers retain their current time. Click Start again to resume from where you left off.

Timer Management

Adding More Timers

Click the Add Timer button (with plus icon) at the bottom of the page.

• Each new timer appears in its own card
• All timers are independent
• No limit on the number of timers

Use cases for multiple timers:

• Track multiple auctions ending at different times
• Monitor several resource respawn windows
• Coordinate multiple event schedules
• Manage overlapping base activities

Removing Timers

Click the Remove Timer button (with minus icon) to delete the last timer.

The Remove button is disabled when you only have one timer. You must always have at least one timer.

• Removes timers in reverse order (last added, first removed)
• Deleted timers cannot be recovered
• If a timer is running, it’s immediately stopped when removed

Timer Countdown Logic

How Timers Count Down

// Timer countdown logic
// Located at: src/components/AuctionTimers/Timer.tsx:19-44

The timer decrements every second:

1. Seconds decrease: 10, 9, 8, 7…
2. Minutes decrease when seconds hit 0: 5:00 → 4:59
3. Hours decrease when minutes hit 0: 1:00:00 → 0:59:59
4. Timer completes at 0:00:00

Completion Behavior

When a timer reaches 0:00:00:

1. Timer automatically stops
2. Card border changes to yellow
3. Background highlights in yellow (20% opacity)
4. Audio plays (if Sound On is enabled)
5. Timer remains at 0:00:00 until you reset it

The yellow highlighting makes it easy to spot completed timers at a glance, even with multiple timers running.

Audio Alerts

Sound Configuration

The audio toggle at the top controls all timers:

// Audio playback
// Located at: src/pages/AuctionTimers.tsx:13-16

const playAlarm = () => {
  const audio = new Audio("./cobra.mp3");
  audio.play();
};

• Sound file: cobra.mp3 (included with Stiletto)
• Trigger: Each timer that completes
• Volume: System volume (adjust your device volume)

Best Practices for Audio

When to Use Sound On

• You’re alt-tabbed or in-game
• You need audio cues for critical timers
• You’re monitoring multiple timers
• You want to be immediately alerted

When to Use Sound Off

• You’re in a voice call or stream
• You’re in a quiet environment
• You’re visually monitoring the page
• You have many timers and don’t need constant alerts

Common Use Cases

Auction Sniping

1. Set Timer Before Auction Ends

   Calculate time until auction ends, set timer accordingly.

   Example: Auction ends in 2 hours, 15 minutes

   • Hours: 2
   • Minutes: 15
   • Seconds: 0
   • Description: “Rare Walker Auction”
2. Enable Sound

   Turn on audio alerts so you don’t miss the ending.

3. Be Ready

   When the timer completes and sounds, quickly place your final bid.

Resource Respawn Tracking

Many resources in Last Oasis respawn after set periods:

1. Note respawn time when you harvest
2. Set timer for respawn duration
3. Add description with location
4. Return when timer completes

Example:

Hours: 6
Minutes: 0
Seconds: 0
Description: "Rare Iron - North Cave"

Event Coordination

Track clan events or in-game occurrences:

• Raid start times: “Raid on Enemy Base”
• Territory claims: “Land claim expires”
• Walker maintenance: “Repairs complete”
• Trade meetups: “Trade with Ally Clan”

Multi-Event Tracking

Use multiple timers simultaneously:

Timer 1: 0:45:00 - "Auction ends"
Timer 2: 2:30:00 - "Resource respawn"
Timer 3: 1:15:00 - "Clan meeting"
Timer 4: 0:10:00 - "Walker repairs done"

Technical Details

Timer Precision

Timers update every 1000ms (1 second):

// Timer interval
const timer = setInterval(() => {
  // Update logic
}, 1000);

• Accuracy: ±1 second
• Performance: Minimal CPU usage
• Multiple timers: Each runs independently

State Management

Each timer maintains its own state:

interface TimerState {
  hours: number;      // 0-24
  minutes: number;    // 0-59
  seconds: number;    // 0-59
  isOn: boolean;      // Running or stopped
  isFinish: boolean;  // Completed
}

React Component

Timers are memoized React components:

// Memoized for performance
const AuctionTimers = memo(() => { ... });

Benefits:

• Efficient re-rendering
• Smooth updates even with many timers
• No lag or stutter

Mobile Experience

Auction Timers are fully responsive:

• Mobile: Stacked layout, full-width inputs
• Tablet: Grid layout with larger touch targets
• Desktop: Horizontal layout with all controls visible

Timer inputs are large and easy to tap on mobile devices. The description field expands to full width for easy typing.

Tips & Tricks

Quick Time Entry

• Tab between fields for fast input
• Use arrow keys to increment/decrement values
• Type directly for exact values
• Hours max at 24, minutes/seconds max at 59

Timer Strategies

1. Round up: Add a few seconds buffer for reaction time
2. Alerts early: Set timer 1-2 minutes before critical time for preparation
3. Multiple warnings: Use two timers (e.g., 10 min and 1 min before)
4. Color code: Use descriptions to categorize (“[URGENT] Auction”)

Performance with Many Timers

• 10+ timers run smoothly
• Each timer is independent
• Minimal memory usage
• Clean up finished timers to declutter

Integration with Other Features

Trading System

Set timers for:

• Trade meetup times
• Price change windows
• Limited-time offers

Clan Management

Coordinate:

• Clan meeting schedules
• Joint operations
• Territory defense windows

Resource Maps

Track:

• Resource respawn times
• Map burn dates
• Gathering route schedules

Diplomacy

Monitor:

• NAP expiration times
• War declaration countdowns
• Truce ending windows

Keyboard Shortcuts

Standard HTML input shortcuts work:

• Tab: Move to next field
• Shift+Tab: Move to previous field
• Arrow Up/Down: Increment/decrement numeric values
• Enter: Submit (if in description field, does nothing)

Troubleshooting

Timer not counting down

Solution:

• Check if timer is started (green Start button should be pressed)
• Verify time is greater than 0:00:00
• Try stopping and restarting the timer
• Refresh the page if timer is stuck

Audio not playing

Solution:

• Ensure Sound On is selected
• Check system volume is not muted
• Verify browser has permission to play audio
• Some browsers block auto-play audio - interact with the page first

Can't remove timers

Solution:

• You must have at least 2 timers to remove one
• Remove button is disabled with only 1 timer
• Add more timers first, then remove unwanted ones

Timer stopped automatically

Solution:

• Timer stops automatically at 0:00:00 (by design)
• Reset the time and click Start again
• If it stopped mid-countdown, check if you accidentally clicked Stop

Best Practices Summary

1. Label clearly: Use descriptive names so you remember what each timer is for
2. Sound wisely: Enable audio when you need alerts, disable when monitoring visually
3. Buffer time: Add extra seconds for reaction time on critical events
4. Clean up: Remove completed timers to avoid clutter
5. Test first: Set a short test timer to verify audio and visual alerts work

Advanced Usage

Repeating Timers

For recurring events:

1. Set timer for first occurrence
2. When it completes, note the interval
3. Reset to the same duration
4. Restart the timer
5. Repeat as needed

Future versions may include auto-repeat functionality. For now, manual reset is required.

Timer Presets

Create personal “presets” by noting common durations:

• Quick auction: 0:15:00
• Resource respawn: 6:00:00
• Event warning: 1:00:00
• Base repair: 2:30:00

Keep a list in Discord or a note-taking app for quick reference.

Multi-Device Coordination

Timers are local to your browser:

• They don’t sync across devices
• They reset on page refresh
• They don’t persist when you close the tab

For persistent timing needs, consider:

• External timer apps
• Calendar reminders
• Discord bot timers

If you refresh the page or close the tab, all timers are lost. Keep the tab open for active timers.

Future Enhancements

Potential features being considered:

• Timer presets and templates
• Auto-repeat timers
• Timer persistence (save timers to database)
• Notifications via Discord webhooks
• Timer sharing with clan members
• Timer history and logs
• Custom audio uploads
• Visual themes for timers

Have suggestions for the timer system? Share your feedback through the appropriate channels.