====== Web UI Admin & Guild Master Guide - PookyEvent ====== **Last Updated:** July 28, 2026 This guide describes the PookyEvent Web UI from an **Event Master / Guild Master** perspective. It covers everything you can do beyond what a regular player can: creating and editing events, managing guilds, and administering users. > **Note:** If you are a **Super Admin**, you also have access to additional admin controls (impersonation, setting admins, syncing guilds). Those are covered at the end of this guide. > **Prerequisite:** Before using the Web UI, make sure you have completed the setup steps in the [[pookyeventinstall|Getting Started Guide]] — invite the bot, register with ''/pookyme'', and add a channel with ''/pookychannel''. ---- ===== 1. Additional Navigation ===== As an Event Master (you own at least one guild), the left drawer shows extra pages compared to a regular user: ^ Icon ^ Page ^ Description ^ | 🏠 | Welcome | Dashboard with active upcoming events | | 📅 | Events | Full event list — now with create/edit/delete actions | | 🏰 | Guilds | Guild overview — now with edit/delete/add actions | | đŸ‘Ĩ | Users | User management — view and remove users from your guilds | | 🐞 | Rant | Report bugs or suggest improvements | | đŸšĒ | Logout | Sign out of the Web UI | If you are also a **Super Admin**, you will additionally see **⚙ī¸ Admin** in the drawer. ---- ===== 2. Managing Events ===== ==== 2.1 Event List for Guild Masters ==== On the **Events** page, events belonging to guilds you own now show additional action buttons next to each event: ^ Icon ^ Action ^ Description ^ | 🔍 | Show details | View event with signup options | | 🗑ī¸ | Delete | Permanently delete the event (with confirmation dialog) | | đŸ“ĸ | Repost | Re-post the event embed to the Discord channel | | 🔄 | Update embed | Refresh the existing Discord embed with latest data | | ✏ī¸ | Edit | Open the event edit form | | 📋 | Copy as new | Duplicate the event as a template for a new event | Multi-select checkboxes let you select several events and perform bulk actions. ==== 2.2 Creating an Event (➕ Create) ==== The **Create** tab opens a 3-step wizard: **Step 1 — Select Guild & Channel** {{:wiki:pe_ce1.png?200|}} * Choose the Discord server * Choose the text channel where the event will be posted * Set the **maximum number of custom roles** (4–12) **Step 2 — Choose Template** {{:wiki:pe_ce2.png?200|}} * Select an existing event to copy its roles and settings, or * Choose **"Create Empty Event"** to start from scratch **Step 3 — Fill Event Details** {{:wiki:pe_ce3.png?200|}} * **Title** — A descriptive name for the event * **Description** — Additional information for players * **Builds Link** — Optional URL to a build guide * **Date & Time** — Pick the date and time (automatically converted to your browser's timezone) * **Minimum signups** — The minimum number of players needed for the event to go ahead * **Roles** — Define each role: * **Name** — The role display name (e.g. "Freija", "Raid Leader") * **Type** — Role category: Healer, DD, Tank, Speed, Lead, Bomber, or Support * **Mandatory** — Check this box if the role is required for the event to start * A **preview** shows the emoji-prefixed role name as it will appear in Discord Click **✅ Create Event** to submit. The event will be saved and posted to the selected Discord channel automatically. ==== 2.3 Editing an Event (✏ī¸ Edit) ==== The **Edit** tab lets you modify any existing event. Select the guild and event from the dropdowns, then edit: {{ :wiki:pe_ee.png?400 |}} * **Event Details Card**: * Title, Description, Builds Link * **Finalized** checkbox — Lock the event (prevents further signups) * **Min signups** — Change the required player count * **Date & Time Card**: * Change the event date and time (local timezone) * **Roles Card**: * Edit role names, types, and mandatory flags * Assign **preferred signups** per role via the dropdown * System roles (Bench, Whatever, etc.) are shown read-only When you change role names or types, existing signups are **automatically migrated** — players keep their signup positions. You will see a warning if role changes are detected. After saving, the Discord embed is updated automatically. > **Tip:** To close an event and assign waiting players, check the **Finalized** box and save. ==== 2.4 Deleting Events ==== Click the 🗑ī¸ icon next to an event in the list. A confirmation dialog will appear — confirm to permanently delete the event. This also removes the Discord embed if it was posted. ==== 2.5 Reposting & Updating Embeds ==== * **đŸ“ĸ Repost** — Deletes the old Discord embed and posts a fresh one in the channel * **🔄 Update embed** — Refreshes the existing embed with current data (signups, finalization status) without deleting it Use **Update embed** after manually adjusting signups or finalizing an event to sync the Discord message. ---- ===== 3. Managing Guilds ===== The **Guilds** page for an Event Master shows additional action buttons for your own guilds: ^ Icon ^ Action ^ Description ^ | ✏ī¸ | Edit guild | Modify guild name and registered channels | | 🗑ī¸ | Delete guild | Remove the guild from PookyEvent entirely | There is also a **➕ Add Guild** button to register a new Discord server. ==== 3.1 Editing a Guild ==== Click the ✏ī¸ icon to open the edit form: * **Name** — Change the guild display name * **Channels** — Edit the registered channels in ''channel_name,channel_id'' format (one per line) Click **💾 Update** to save. ==== 3.2 Adding a Guild ==== Click **➕ Add Guild**. Choose from available Discord servers detected by the bot, or enter a guild ID manually (if you are a Super Admin). You can also set a custom name and define channels. ==== 3.3 Deleting a Guild ==== Click the 🗑ī¸ icon and confirm the deletion dialog. This permanently removes the guild and all its events from PookyEvent. ---- ===== 4. Managing Users ===== The **Users** page is available to Event Masters. It shows all users from the PookyEvent database, filtered by your own guilds. ==== 4.1 Viewing Users ==== * Use the **Filter by Guild** dropdown to see users in a specific guild * Users are displayed with their **username** and **Discord ID** * Pagination controls appear if there are more than 20 users ==== 4.2 Removing Users from a Guild ==== When filtered to a specific guild: * Click the **⛓ī¸â€đŸ’Ĩ** icon to remove a user from the guild * If the user belongs to only this guild, they will be **permanently deleted** from the database (a confirmation dialog warns you) * If the user belongs to multiple guilds, they are simply removed from the current guild You can also **multi-select** users with checkboxes and use the bulk action button: * **⛓ī¸â€đŸ’Ĩ Remove from guild (N)** — Removes all selected users from the guild (or deletes those with no other guilds) ==== 4.3 Editing User Permissions ==== The **✏ī¸ Edit** sub-tab is available to **Super Admins only**. It lets you: * Toggle **Is Admin** status * Toggle **Is Guild Master** status ---- ===== 5. Super Admin Controls ===== If you are a **Super Admin**, you will see the **⚙ī¸ Admin** page in the navigation drawer. This page provides: ==== 5.1 Sync Guild Icons ==== Click **🔄 Sync Guild Icons** to pull the current guild icons and metadata from Discord. This updates all guild records with fresh Discord data. ==== 5.2 Impersonate Users ==== The **🎭 Login as User** feature lets you view the Web UI as any other user: 1. Select a user from the dropdown 2. Click **🎭 Login as User** 3. The UI switches to that user's view — you see exactly what they see 4. An orange banner at the top shows you are impersonating 5. Click **↩ī¸ Revert to Admin** to return to your own session This is useful for testing and debugging what your players see. ==== 5.3 Set Admin ==== Enter a user's **Discord ID** and click **Set as Admin** to grant super admin privileges. The user will immediately have access to all admin features. ==== 5.4 Set Guild Master ==== Enter a user's **Discord ID**, select a guild, and click **Set as Guild Master** to grant guild ownership. The user will be able to manage events and users for that guild. ---- ===== Quick Command Reference ===== ^ Action ^ Where ^ | Create event | Events → ➕ Create tab (3-step wizard) | | Edit event | Events → ✏ī¸ Edit tab (select guild & event) | | Delete event | Events list → 🗑ī¸ icon | | Repost Discord embed | Events list → đŸ“ĸ icon | | Update Discord embed | Events list → 🔄 icon | | Edit guild | Guilds list → ✏ī¸ icon | | Add guild | Guilds list → ➕ Add Guild button | | Delete guild | Guilds list → 🗑ī¸ icon | | View & manage users | đŸ‘Ĩ Users page | | Remove user from guild | Users → filter by guild → ⛓ī¸â€đŸ’Ĩ icon | | Bulk remove users | Users → select checkboxes → bulk button | | Sync guild icons | ⚙ī¸ Admin → Sync Guild Icons (admin only) | | Impersonate user | ⚙ī¸ Admin → Login as User (admin only) | | Set admin / guild master | ⚙ī¸ Admin (admin only) | ---- For the regular user interface (logging in, viewing events, signing up), see the [[pookyeventui|Web UI User Guide]].