GuildRadioFM Purplexity Lore Vol. 1

https://www.patreon.com/cw/GuildRadioFM

Requires:
GuildRadioFM CORE v2.1.1 or newer

Description:
Purplexity Lore Vol. 1 is an optional GuildRadioFM song-pack addon. It adds a full playlist of Purplexity Lore tracks to GuildRadioFM without editing the core addon and without requiring users to copy songs manually.

When installed beside GuildRadioFM, this pack automatically:
- Adds all included songs to the GuildRadioFM ALL library
- Creates the playlists "Purplexity Lore Vol. 1" and "Purplexity Lore Vol. 2"
- Adds every included song to its matching playlist
- Includes duration metadata for progress timers and auto-next
- Leaves user playlists and saved variables alone

Included Tracks:
- 99 Ways to Die
- Blame Chopper
- Brick By Brick
- C'est La Key
- Dont Let It Happen Again
- Forgot About Kicks
- Funyun Popeye
- I Only Look At The D
- Imma Have to Troke A Bish
- MANY MOBS
- Mr Clean Key
- Nez Is a Key Ripper
- Nez Is High Again
- OOM Again Not My Fault
- PI Me Not Him
- PICKLES WRATH
- Rank One Spin Cycle Done
- William D Chopper
- They See Me Pullin
- Crio Did It For The Loot
- Press The Button Nez
- Rippin Brickin Timin
- Tube Sock and a Brick
- Magisters Terrace Blues
- Get In Loser Were Timing Keys
- He Released
- Healer Juice
- BUCKEE DIDNT DO IT
- Higher Than the Timer
- Diss Dat Dym Blacksmith
- Titard In The Key Tonight
- Crio Dont Stand There
- Midnight Cake Heist
- SixSeven Broke
- Chopper Change Your Talents
- Stormwind Blue
- Sixteen on Stream Thirteen in Flames
- Mad Key
- Demonetized
- Pearly Keys
- Three Wipes
- THIRTY OVER
- 461 MS
- That One Guy In Every Key
- The Last Key
- Dungeon Stories

Install:
1. Install or update GuildRadioFM CORE to v2.1.1 or newer.
2. Install this song pack.
3. Make sure both folders are inside:
World of Warcraft/_retail_/Interface/AddOns/
4. Your AddOns folder should contain:
GuildRadioFM/
GuildRadioFM Purplexity Lore Vol 1/
5. Start WoW or type /reload.

After loading, GuildRadioFM will print:
GuildRadioFM: Purplexity Lore Vol. 1 loaded.
GuildRadioFM: Purplexity Lore Vol. 2 loaded.

Open GuildRadioFM, go to Playlists, and select "Purplexity Lore Vol. 1" or "Purplexity Lore Vol. 2".

Notes:
- This is an optional song pack, not a replacement for GuildRadioFM CORE.
- Do not put these songs into the core Songs folder.
- Do not edit SongList.lua.
- Disabling this song pack removes its songs from GuildRadioFM after reload.
- Playback uses WoW's Dialog sound channel through GuildRadioFM.

How to Make a GuildRadioFM Song Pack

GuildRadioFM supports optional song-pack addons. A song pack can add its own songs to the main GuildRadioFM ALL library and automatically create a playlist, without editing the core addon.

Example:
GuildRadioFM Tavern Nights Vol 1 is a separate addon folder that registers its songs with GuildRadioFM Core.

Requirements:
- GuildRadioFM Core v2.1.1 or newer
- MP3 files packaged inside your song-pack addon folder
- A .toc file
- A Lua file that calls GuildRadioFM.RegisterSongPack(...)

Folder Structure

Your song pack should look like this:

GuildRadioFM My Playlist Name/
GuildRadioFM My Playlist Name.toc
My Playlist Name.lua
Songs/
Song One.mp3
Song Two.mp3
Song Three.mp3

The folder must go here:

World of Warcraft/_retail_/Interface/AddOns/

So the final install looks like:

Interface/AddOns/
GuildRadioFM/
GuildRadioFM My Playlist Name/

TOC File Example

Create:

GuildRadioFM My Playlist Name.toc

Paste:

## Interface: 120005
## Title: GuildRadioFM My Playlist Name
## Notes: Optional GuildRadioFM song pack
## Author: YourName
## Version: 1.0.0
## Dependencies: GuildRadioFM

My Playlist Name.lua

Lua File Example

Create:

My Playlist Name.lua

Paste and edit:

local pack = {
packId = "My Playlist Name",
packName = "My Playlist Name",
playlistName = "My Playlist Name",
songs = {
{
id = "My Playlist Name:Song One",
title = "Song One",
artist = "YourName",
style = "Custom",
file = "Interface\\AddOns\\GuildRadioFM My Playlist Name\\Songs\\Song One.mp3",
duration = 180,
},
{
id = "My Playlist Name:Song Two",
title = "Song Two",
artist = "YourName",
style = "Custom",
file = "Interface\\AddOns\\GuildRadioFM My Playlist Name\\Songs\\Song Two.mp3",
duration = 210,
},
},
}

local function RegisterPack()
if GuildRadioFM and GuildRadioFM.RegisterSongPack then
GuildRadioFM.RegisterSongPack(pack)
return true
end
return false
end

if not RegisterPack() then
local frame = CreateFrame("Frame")
frame:RegisterEvent("ADDON_LOADED")
frame:SetScript("OnEvent", function(self, _, addonName)
if addonName == "GuildRadioFM" and RegisterPack() then
self:UnregisterEvent("ADDON_LOADED")
end
end)
end

Song Rules

Each song needs:
- id
- title
- file
- duration

Recommended ID format:

Playlist Name:Song Title

Example:

id = "Tavern Nights Vol 1:Winter in Dun Morogh"

The file path must point to the MP3 inside your addon folder:

file = "Interface\\AddOns\\GuildRadioFM My Playlist Name\\Songs\\Song One.mp3"

Do not use:
- C:\ paths
- D:\ paths
- Downloads folders
- Spotify links
- YouTube links
- internet URLs

WoW addons can only play files packaged inside addon folders.

Durations

Duration is in seconds.

Examples:
- 2 minutes = 120
- 3 minutes 30 seconds = 210
- 4 minutes 15 seconds = 255

Duration matters because GuildRadioFM uses it for:
- progress timers
- auto-next
- repeat behavior

What Happens In Game

When your song pack loads:
- Songs appear in GuildRadioFM's ALL library
- A playlist appears using playlistName
- Songs are added to that playlist
- Existing user playlists are not overwritten
- No saved variables need to be edited
- Disabling the song-pack addon removes its songs after reload

Testing Checklist

Before uploading your song pack:

1. Install GuildRadioFM Core v2.1.1 or newer.
2. Install your song-pack folder beside it.
3. Start WoW or type /reload.
4. Confirm chat says your pack loaded.
5. Open GuildRadioFM.
6. Open Library and confirm your songs appear in ALL.
7. Open Playlists and confirm your playlist appears.
8. Play the first song.
9. Confirm the progress timer moves.
10. Confirm auto-next moves to the next song.
11. Reload UI and confirm no duplicate songs appear.
12. Disable your song-pack addon and confirm GuildRadioFM still works.

CurseForge Upload Notes

If you upload a GuildRadioFM song pack to CurseForge:
- Make it clear that it requires GuildRadioFM Core v2.1.1 or newer.
- Do not include the GuildRadioFM core folder inside your song-pack zip.
- Only include your song-pack folder.
- Make sure your MP3 files are inside your song-pack Songs folder.
- Make sure your .toc file declares GuildRadioFM as a dependency.

Example description:

Requires GuildRadioFM Core v2.1.1 or newer.

This is an optional GuildRadioFM song pack. It automatically adds its songs to the GuildRadioFM ALL library and creates its own playlist in the GuildRadioFM playlist window.

Install:
1. Install GuildRadioFM Core.
2. Install this song pack.
3. Place both folders in Interface/AddOns.
4. Reload WoW.