Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- wiki:pookyeventinstall [2026/07/28 14:05] – angelegt wikiadmin
+++ wiki:pookyeventinstall [2026/07/28 15:56] (aktuell) – [2. Register Yourself] wikiadmin
@@ Zeile 1: / Zeile 1: @@
-====== Getting started ======
+====== Getting Started - PookyEvent ======
+**Last Updated:** July 28, 2026
+Welcome to **PookyEvent**! This guide walks you through the initial setup of the Discord bot on your server — from inviting the bot to preparing a channel for event creation.
+Once you have completed these steps, you can create and manage events via the Web UI (documented separately).
+----
+===== 1. Invite the Bot =====
+Click the invite link to add PookyEvent to your Discord server:
+[[https://discord.com/oauth2/authorize?client_id=1394314029757108264|📥 Install PookyEvent]]
+You need the **Manage Server** permission on the target server to invite the bot.
+After the bot joins, wait a moment for it to come online. You can verify it is ready by typing ''/pookywiki'' in any channel — the bot should reply with the documentation link.
+> **Tip:** All PookyEvent slash commands start with ''/pooky''. After typing ''/'' in a channel, the available commands will appear in Discord's autocomplete list.
+----
+===== 2. Register Yourself =====
+Before you can manage events, your Discord user must be registered in the PookyEvent database.
+Run the following command in any channel:
+<code>
+/pookyme
+</code>
+{{ :wiki:pec_pookyme.png?400 |}}
+The bot will reply with:
+  * ''pooky added'' if you are a new user
+  * ''pooky updated'' if you were already registered
+  * If you have **Administrator** permissions on the server, you will automatically become **Event Master** (shown as "pooky added as Event Master.")
+This command also creates or updates the server (guild) record in the database.
+----
+===== 3. Register the Guild (Optional) =====
+If ''/pookyme'' did not register your server, or if you need to repair the guild record, run:
+<code>
+/pookyguild
+</code>
+{{ :wiki:pec_pookyguild.png?400 |}}
+This command:
+  * Creates or updates the server in the database
+  * Registers you as a user (same as ''/pookyme'')
+  * Promotes you to Event Master if you have Administrator permissions
+  * Syncs the bot's slash commands for the server
+----
+===== 4. Check a Channel =====
+Before adding a channel, you can run a dry-run check to see if everything is ready:
+<code>
+/pookychannelcheck
+</code>
+{{ :wiki:pec_check.png?400 |}}
+The bot will report:
+  * ✅ Whether you are registered
+  * ✅ Whether you are Event Master of this server
+  * ✅ Whether the guild is registered in the database
+  * ✅ Whether the channel is already registered
+  * ✅ Whether the bot has the required permissions (View Channel, Send Messages, Embed Links)
+Use this command in the channel you intend to use for events. It is safe — it does not make any changes.
+----
+===== 5. Add a Channel =====
+Once you have verified the channel is ready, register it so PookyEvent can post events there:
+<code>
+/pookychannel
+</code>
+Run this command **in the channel** you want to use for events.
+{{ :wiki:pec_pookych.png?400 |}}
+Requirements:
+  * You must be registered (''/pookyme'')
+  * You must be Event Master of the server
+  * The guild must be registered (''/pookyguild'')
+  * The bot must have **View Channel**, **Send Messages**, and **Embed Links** permissions in that channel
+If permissions are missing, the bot will warn you. Grant the missing permissions via your Discord server settings and run ''/pookychannel'' again.
+> **Tip:** Create a dedicated channel (e.g. ''#pooky-events'') for event management to keep things organised.
+----
+===== 6. Remove a Channel =====
+To unregister a channel, run this command **in the channel** you want to remove:
+<code>
+/unpookychannel
+</code>
+{{ :wiki:pec_unpooky.png?400 |}}
+----
+===== 7. Create Events =====
+Now that a channel is set up, you have two ways to create events:
+==== 7.1 Using the Web UI (Recommended) ====
+Open the Web UI in your browser:
+<code>
+/pookyweb
+</code>
+The link takes you to the PookyEvent admin dashboard where you can create, edit, and manage events visually.
+> The Web UI has its own documentation — see the [[https://wiki.claudiapps.de/wiki:pookyevent|PookyEvent Wiki]] for details.
+==== 7.2 Quick Repeat from Discord ====
+If you already have an existing event in the channel and want to repeat it with a new date, use:
+<code>
+/pookyeventrepeat [next: week|day|today]
+</code>
+Parameters:
+  * ''week'' (default) — Adds 7 days to the original event date
+  * ''day'' — Adds 1 day to the original event date
+  * ''today'' — Uses today's date with the original event time
+This command copies the last event posted in the current channel, preserving all roles and settings.
+----
+===== 8. Useful Commands Overview =====
+^ Command ^ Description ^
+| ''/pookyme'' | Register or update your Discord user in PookyEvent |
+| ''/pookyguild'' | Register or repair the guild/server record |
+| ''/pookychannelcheck'' | Dry-run check if a channel is ready for events |
+| ''/pookychannel'' | Register the current channel for event posting |
+| ''/unpookychannel'' | Remove the current channel from event posting |
+| ''/pookyeventrepeat'' | Duplicate the last event with a new date |
+| ''/pookyinfo [user]'' | Show event registration info about a user |
+| ''/pookyweb'' | Get the Web UI URL |
+| ''/pookywiki'' | Get the documentation URL |
+----
+===== Next Steps =====
+  * Visit the Web UI via ''/pookyweb'' to create your first event
+  * Configure custom roles for your server in the Admin panel
+  * Invite players to sign up for events using the interactive embed buttons
+For detailed information about all features, visit the [[https://wiki.claudiapps.de/wiki:pookyevent|PookyEvent Wiki]].
-Invite the PookyEvent: [[https://discord.com/oauth2/authorize?client_id=1394314029757108264|Install Link]]