Fox Guild Calendar

Guild Calendar

 
# FoxGuildCal - WoW Classic Guild Calendar Addon

## Overview
FoxGuildCal is a comprehensive calendar addon for World of Warcraft Classic that allows guild members to share and manage events. It features both personal and shared event systems with automatic synchronization between guild members.

## Features

### ๐Ÿ“… Calendar System
- **Monthly Calendar View**: Clean and intuitive monthly calendar interface
- **Dual Event Types**:
- **Shared Events** (Green dots): Synchronized across all guild members
- **Personal Events** (Gold dots): Account-wide personal reminders
- **Visual Indicators**: Different colored dots show event types at a glance
- **Today Highlighting**: Current date highlighted in yellow

### ๐Ÿ”„ Synchronization
- **Automatic Guild Sync**: Events automatically synchronize between guild members
- **Smart Sync System**: Intelligent retry mechanism for reliable data transfer
- **Conflict Resolution**: Newer events automatically override older versions
- **Manual Sync Option**: Force synchronization through options menu

### ๐Ÿ“ Event Management
- **Create Events**: Add events with title, time, and description
- **Event Details**: Click any event to view full details
- **Edit Events**: Modify your own events anytime
- **Delete Events**: Remove events you created
- **Event Types**: Toggle between personal and shared when creating

### ๐ŸŽฏ User Interface
- **Minimap Button**: Quick access to calendar
- **Movable Window**: Drag calendar window anywhere on screen
- **Event List Panel**: Side panel shows all events for selected day
- **Tooltip Support**: Hover over minimap button to see today's events

## Commands

- `/fox` or `/foxcal` - Toggle calendar window
- `/fox sync` - Manually synchronize with guild members
- `/fox help` - Show help information

## Installation

1. Download the FoxGuildCal addon
2. Extract to `World of Warcraft\_classic_\Interface\AddOns\`
3. Ensure folder is named `FoxGuildCal`
4. Restart WoW or type `/reload` in game

## Usage

### Creating an Event
1. Click the minimap button or use `/fox` command
2. Select a date on the calendar
3. Click "Add Event" button
4. Fill in event details:
- Title (required)
- Time (optional)
- Description (optional)
- Check/uncheck "Guild Shared Event" for event type
5. Click Save

### Viewing Events
- **Calendar View**: Colored dots indicate events on each day
- Green dot = Shared guild event
- Gold dot = Personal event
- Both dots = Both event types on same day
- **Day View**: Click any date to see all events in the side panel
- **Event Details**: Click any event in the list for full information

### Managing Events
- Only event creators can edit or delete their events
- Personal events are visible across all your characters
- Shared events sync automatically with guild members

## Event Types

### Shared Events (Guild)
- Visible to all guild members with the addon
- Automatically synchronized
- Perfect for raids, meetings, and guild activities
- Shown with green indicators

### Personal Events
- Private to your account only
- Visible across all your characters
- Great for personal reminders and notes
- Shown with gold indicators

## Troubleshooting

### Events Not Syncing
- Ensure you're in a guild
- Check if other guild members have the addon
- Try manual sync with `/fox sync`
- Wait a few seconds after logging in for initial sync

### Calendar Not Opening
- Check if addon is enabled in character selection
- Try `/reload` command
- Ensure no Lua errors with `/console scriptErrors 1`

### Wrong Date Issues
- Fixed in latest version
- Dates now properly save to selected day
- Month navigation resets to day 1

## Technical Details

- **SavedVariables**: `FoxGuildCalDB`
- **Addon Communication**: Uses addon message system for guild sync
- **Storage**: Events stored per guild and account-wide for personal
- **Sync Protocol**: Custom protocol with conflict resolution

---

# FoxGuildCal - WoW ํด๋ž˜์‹ ๊ธธ๋“œ ์บ˜๋ฆฐ๋” ์• ๋“œ์˜จ

## ๊ฐœ์š”
FoxGuildCal์€ ์›”๋“œ ์˜ค๋ธŒ ์›Œํฌ๋ž˜ํ”„ํŠธ ํด๋ž˜์‹์šฉ ์ข…ํ•ฉ ์บ˜๋ฆฐ๋” ์• ๋“œ์˜จ์œผ๋กœ, ๊ธธ๋“œ์›๋“ค์ด ์ผ์ •์„ ๊ณต์œ ํ•˜๊ณ  ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐœ์ธ ์ผ์ •๊ณผ ๊ณต์œ  ์ผ์ • ์‹œ์Šคํ…œ์„ ๋ชจ๋‘ ์ง€์›ํ•˜๋ฉฐ ๊ธธ๋“œ์› ๊ฐ„ ์ž๋™ ๋™๊ธฐํ™” ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

## ์ฃผ์š” ๊ธฐ๋Šฅ

### ๐Ÿ“… ์บ˜๋ฆฐ๋” ์‹œ์Šคํ…œ
- **์›”๊ฐ„ ์บ˜๋ฆฐ๋” ๋ทฐ**: ๊น”๋”ํ•˜๊ณ  ์ง๊ด€์ ์ธ ์›”๊ฐ„ ์บ˜๋ฆฐ๋” ์ธํ„ฐํŽ˜์ด์Šค
- **์ด์ค‘ ์ผ์ • ์œ ํ˜•**:
- **๊ณต์œ  ์ผ์ •** (๋…น์ƒ‰ ์ ): ๋ชจ๋“  ๊ธธ๋“œ์›๊ณผ ๋™๊ธฐํ™”
- **๊ฐœ์ธ ์ผ์ •** (ํ™ฉ๊ธˆ์ƒ‰ ์ ): ๊ณ„์ • ์ „์ฒด ๊ฐœ์ธ ๋ฉ”๋ชจ
- **์‹œ๊ฐ์  ํ‘œ์‹œ**: ๋‹ค๋ฅธ ์ƒ‰์ƒ์˜ ์ ์œผ๋กœ ์ผ์ • ์œ ํ˜•์„ ํ•œ๋ˆˆ์— ๊ตฌ๋ถ„
- **์˜ค๋Š˜ ๋‚ ์งœ ๊ฐ•์กฐ**: ํ˜„์žฌ ๋‚ ์งœ๋Š” ๋…ธ๋ž€์ƒ‰์œผ๋กœ ํ‘œ์‹œ

### ๐Ÿ”„ ๋™๊ธฐํ™”
- **์ž๋™ ๊ธธ๋“œ ๋™๊ธฐํ™”**: ๊ธธ๋“œ์› ๊ฐ„ ์ผ์ • ์ž๋™ ๋™๊ธฐํ™”
- **์Šค๋งˆํŠธ ๋™๊ธฐํ™” ์‹œ์Šคํ…œ**: ์•ˆ์ •์ ์ธ ๋ฐ์ดํ„ฐ ์ „์†ก์„ ์œ„ํ•œ ์ง€๋Šฅํ˜• ์žฌ์‹œ๋„ ๋ฉ”์ปค๋‹ˆ์ฆ˜
- **์ถฉ๋Œ ํ•ด๊ฒฐ**: ์ตœ์‹  ์ผ์ •์ด ์ž๋™์œผ๋กœ ์ด์ „ ๋ฒ„์ „์„ ๋ฎ์–ด์”€
- **์ˆ˜๋™ ๋™๊ธฐํ™” ์˜ต์…˜**: ์˜ต์…˜ ๋ฉ”๋‰ด๋ฅผ ํ†ตํ•œ ๊ฐ•์ œ ๋™๊ธฐํ™”

### ๐Ÿ“ ์ผ์ • ๊ด€๋ฆฌ
- **์ผ์ • ์ƒ์„ฑ**: ์ œ๋ชฉ, ์‹œ๊ฐ„, ์„ค๋ช…์„ ํฌํ•จํ•œ ์ผ์ • ์ถ”๊ฐ€
- **์ผ์ • ์ƒ์„ธ์ •๋ณด**: ๋ชจ๋“  ์ผ์ •์„ ํด๋ฆญํ•˜์—ฌ ์ „์ฒด ๋‚ด์šฉ ํ™•์ธ
- **์ผ์ • ์ˆ˜์ •**: ๋ณธ์ธ์ด ์ž‘์„ฑํ•œ ์ผ์ •์€ ์–ธ์ œ๋“  ์ˆ˜์ • ๊ฐ€๋Šฅ
- **์ผ์ • ์‚ญ์ œ**: ๋ณธ์ธ์ด ์ƒ์„ฑํ•œ ์ผ์ • ์‚ญ์ œ
- **์ผ์ • ์œ ํ˜•**: ์ƒ์„ฑ ์‹œ ๊ฐœ์ธ/๊ณต์œ  ์„ ํƒ ๊ฐ€๋Šฅ

### ๐ŸŽฏ ์‚ฌ์šฉ์ž ์ธํ„ฐํŽ˜์ด์Šค
- **๋ฏธ๋‹ˆ๋งต ๋ฒ„ํŠผ**: ์บ˜๋ฆฐ๋”์— ๋น ๋ฅด๊ฒŒ ์ ‘๊ทผ
- **์ด๋™ ๊ฐ€๋Šฅํ•œ ์ฐฝ**: ์บ˜๋ฆฐ๋” ์ฐฝ์„ ํ™”๋ฉด ์–ด๋””๋“  ๋“œ๋ž˜๊ทธ ๊ฐ€๋Šฅ
- **์ผ์ • ๋ชฉ๋ก ํŒจ๋„**: ์„ ํƒํ•œ ๋‚ ์งœ์˜ ๋ชจ๋“  ์ผ์ •์„ ์‚ฌ์ด๋“œ ํŒจ๋„์— ํ‘œ์‹œ
- **ํˆดํŒ ์ง€์›**: ๋ฏธ๋‹ˆ๋งต ๋ฒ„ํŠผ์— ๋งˆ์šฐ์Šค๋ฅผ ์˜ฌ๋ ค ์˜ค๋Š˜์˜ ์ผ์ • ํ™•์ธ

## ๋ช…๋ น์–ด

- `/fox` ๋˜๋Š” `/foxcal` - ์บ˜๋ฆฐ๋” ์ฐฝ ์—ด๊ธฐ/๋‹ซ๊ธฐ
- `/fox sync` - ๊ธธ๋“œ์›๊ณผ ์ˆ˜๋™ ๋™๊ธฐํ™”
- `/fox help` - ๋„์›€๋ง ์ •๋ณด ํ‘œ์‹œ

## ์„ค์น˜ ๋ฐฉ๋ฒ•

1. FoxGuildCal ์• ๋“œ์˜จ ๋‹ค์šด๋กœ๋“œ
2. `World of Warcraft\_classic_\Interface\AddOns\` ํด๋”์— ์••์ถ• ํ•ด์ œ
3. ํด๋” ์ด๋ฆ„์ด `FoxGuildCal`์ธ์ง€ ํ™•์ธ
4. WoW ์žฌ์‹œ์ž‘ ๋˜๋Š” ๊ฒŒ์ž„ ๋‚ด์—์„œ `/reload` ์ž…๋ ฅ

## ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

### ์ผ์ • ์ƒ์„ฑํ•˜๊ธฐ
1. ๋ฏธ๋‹ˆ๋งต ๋ฒ„ํŠผ ํด๋ฆญ ๋˜๋Š” `/fox` ๋ช…๋ น์–ด ์‚ฌ์šฉ
2. ์บ˜๋ฆฐ๋”์—์„œ ๋‚ ์งœ ์„ ํƒ
3. "์ผ์ • ์ถ”๊ฐ€" ๋ฒ„ํŠผ ํด๋ฆญ
4. ์ผ์ • ์„ธ๋ถ€์‚ฌํ•ญ ์ž…๋ ฅ:
- ์ œ๋ชฉ (ํ•„์ˆ˜)
- ์‹œ๊ฐ„ (์„ ํƒ)
- ์„ค๋ช… (์„ ํƒ)
- ์ผ์ • ์œ ํ˜•์„ ์œ„ํ•ด "๊ธธ๋“œ ๊ณต์œ  ์ผ์ •" ์ฒดํฌ/ํ•ด์ œ
5. ์ €์žฅ ํด๋ฆญ

### ์ผ์ • ๋ณด๊ธฐ
- **์บ˜๋ฆฐ๋” ๋ทฐ**: ์ƒ‰์ƒ ์ ์œผ๋กœ ๊ฐ ๋‚ ์งœ์˜ ์ผ์ • ํ‘œ์‹œ
- ๋…น์ƒ‰ ์  = ๊ณต์œ  ๊ธธ๋“œ ์ผ์ •
- ํ™ฉ๊ธˆ์ƒ‰ ์  = ๊ฐœ์ธ ์ผ์ •
- ๋‘ ์  ๋ชจ๋‘ = ๊ฐ™์€ ๋‚ ์— ๋‘ ์œ ํ˜•์˜ ์ผ์ • ์กด์žฌ
- **์ผ๊ฐ„ ๋ทฐ**: ๋‚ ์งœ๋ฅผ ํด๋ฆญํ•˜์—ฌ ์‚ฌ์ด๋“œ ํŒจ๋„์—์„œ ๋ชจ๋“  ์ผ์ • ํ™•์ธ
- **์ผ์ • ์ƒ์„ธ์ •๋ณด**: ๋ชฉ๋ก์˜ ์ผ์ •์„ ํด๋ฆญํ•˜์—ฌ ์ „์ฒด ์ •๋ณด ํ™•์ธ

### ์ผ์ • ๊ด€๋ฆฌ
- ์ผ์ • ์ž‘์„ฑ์ž๋งŒ ํ•ด๋‹น ์ผ์ •์„ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜ ์‚ญ์ œ ๊ฐ€๋Šฅ
- ๊ฐœ์ธ ์ผ์ •์€ ๋ชจ๋“  ์บ๋ฆญํ„ฐ์—์„œ ํ‘œ์‹œ๋จ
- ๊ณต์œ  ์ผ์ •์€ ๊ธธ๋“œ์›๊ณผ ์ž๋™ ๋™๊ธฐํ™”

## ์ผ์ • ์œ ํ˜•

### ๊ณต์œ  ์ผ์ • (๊ธธ๋“œ)
- ์• ๋“œ์˜จ์„ ์‚ฌ์šฉํ•˜๋Š” ๋ชจ๋“  ๊ธธ๋“œ์›์—๊ฒŒ ํ‘œ์‹œ
- ์ž๋™์œผ๋กœ ๋™๊ธฐํ™”๋จ
- ๋ ˆ์ด๋“œ, ๋ชจ์ž„, ๊ธธ๋“œ ํ™œ๋™์— ์ ํ•ฉ
- ๋…น์ƒ‰ ํ‘œ์‹œ๋กœ ๊ตฌ๋ถ„

### ๊ฐœ์ธ ์ผ์ •
- ๋ณธ์ธ ๊ณ„์ •์—๋งŒ ๋น„๊ณต๊ฐœ
- ๋ชจ๋“  ์บ๋ฆญํ„ฐ์—์„œ ํ‘œ์‹œ
- ๊ฐœ์ธ ๋ฉ”๋ชจ์™€ ์•Œ๋ฆผ์— ์ ํ•ฉ
- ํ™ฉ๊ธˆ์ƒ‰ ํ‘œ์‹œ๋กœ ๊ตฌ๋ถ„

## ๋ฌธ์ œ ํ•ด๊ฒฐ

### ์ผ์ •์ด ๋™๊ธฐํ™”๋˜์ง€ ์•Š์„ ๋•Œ
- ๊ธธ๋“œ์— ๊ฐ€์ž…๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธ
- ๋‹ค๋ฅธ ๊ธธ๋“œ์›์ด ์• ๋“œ์˜จ์„ ์‚ฌ์šฉํ•˜๋Š”์ง€ ํ™•์ธ
- `/fox sync`๋กœ ์ˆ˜๋™ ๋™๊ธฐํ™” ์‹œ๋„
- ๋กœ๊ทธ์ธ ํ›„ ์ดˆ๊ธฐ ๋™๊ธฐํ™”๋ฅผ ์œ„ํ•ด ๋ช‡ ์ดˆ ๋Œ€๊ธฐ

### ์บ˜๋ฆฐ๋”๊ฐ€ ์—ด๋ฆฌ์ง€ ์•Š์„ ๋•Œ
- ์บ๋ฆญํ„ฐ ์„ ํƒ ํ™”๋ฉด์—์„œ ์• ๋“œ์˜จ์ด ํ™œ์„ฑํ™”๋˜์—ˆ๋Š”์ง€ ํ™•์ธ
- `/reload` ๋ช…๋ น์–ด ์‹œ๋„
- `/console scriptErrors 1`๋กœ Lua ์˜ค๋ฅ˜ ํ™•์ธ

### ๋‚ ์งœ ์˜ค๋ฅ˜ ๋ฌธ์ œ
- ์ตœ์‹  ๋ฒ„์ „์—์„œ ์ˆ˜์ •๋จ
- ์ด์ œ ์„ ํƒํ•œ ๋‚ ์งœ์— ์ •ํ™•ํžˆ ์ €์žฅ๋จ
- ์›” ์ด๋™ ์‹œ 1์ผ๋กœ ์ดˆ๊ธฐํ™”

## ๊ธฐ์ˆ  ์„ธ๋ถ€์‚ฌํ•ญ

- **์ €์žฅ ๋ณ€์ˆ˜**: `FoxGuildCalDB`
- **์• ๋“œ์˜จ ํ†ต์‹ **: ๊ธธ๋“œ ๋™๊ธฐํ™”๋ฅผ ์œ„ํ•œ ์• ๋“œ์˜จ ๋ฉ”์‹œ์ง€ ์‹œ์Šคํ…œ ์‚ฌ์šฉ
- **์ €์žฅ์†Œ**: ๊ธธ๋“œ๋ณ„ ์ผ์ • ๋ฐ ๊ณ„์ • ์ „์ฒด ๊ฐœ์ธ ์ผ์ • ์ €์žฅ
- **๋™๊ธฐํ™” ํ”„๋กœํ† ์ฝœ**: ์ถฉ๋Œ ํ•ด๊ฒฐ ๊ธฐ๋Šฅ์ด ์žˆ๋Š” ์ปค์Šคํ…€ ํ”„๋กœํ† ์ฝœ

## ๋ฒ„์ „ ๊ธฐ๋ก

### v1.0.0
- ์ดˆ๊ธฐ ๋ฆด๋ฆฌ์ฆˆ
- ๊ธฐ๋ณธ ์บ˜๋ฆฐ๋” ๊ธฐ๋Šฅ
- ๊ธธ๋“œ ์ผ์ • ๋™๊ธฐํ™”

### v1.1.0
- ๊ฐœ์ธ ์ผ์ • ์‹œ์Šคํ…œ ์ถ”๊ฐ€
- ๊ณ„์ • ์ „์ฒด ๊ฐœ์ธ ์ผ์ • ์ง€์›
- ์‹œ๊ฐ์  ๊ตฌ๋ถ„ (๋…น์ƒ‰/ํ™ฉ๊ธˆ์ƒ‰ ์ )
- ํ•œ๊ธ€ ์ž…๋ ฅ ๋ฌธ์ œ ์ˆ˜์ •
- ๋‚ ์งœ ๋ฒ„๊ทธ ์ˆ˜์ •

## ํฌ๋ ˆ๋”ง

๊ฐœ๋ฐœ์ž: ์šฐ๋ฅด์‚ฌ [ ์™€์šฐ 20์ฃผ๋…„ ํด๋ž˜์‹ ๊ธฐ๋…์„œ๋ฒ„ ํ•˜๋“œ์ฝ”์–ด - ์–ผ๋ผ์ด์–ธ์Šค - Fox and Wolf ๊ธธ๋“œ][
WoW Classic ์ „์šฉ ์• ๋“œ์˜จ

## ๋ผ์ด์„ ์Šค

์ด ์• ๋“œ์˜จ์€ WoW ์• ๋“œ์˜จ ์ •์ฑ…์— ๋”ฐ๋ผ ๋ฌด๋ฃŒ๋กœ ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.

## ์ง€์›

๋ฒ„๊ทธ ๋ฆฌํฌํŠธ๋‚˜ ์ œ์•ˆ์‚ฌํ•ญ์ด ์žˆ์œผ์‹œ๋ฉด ์• ๋“œ์˜จ ํŽ˜์ด์ง€์— ๋Œ“๊ธ€์„ ๋‚จ๊ฒจ์ฃผ์„ธ์š”.

The Fox Guild Calendar Team

profile avatar
Owner
  • 6
    Projects
  • 8.0K
    Downloads

More from urstoryView all