diff --git a/docs/tasks/task-098-discord-channel-automation/forum-content-spec.md b/docs/tasks/task-098-discord-channel-automation/forum-content-spec.md index 16033b6..b6c0875 100644 --- a/docs/tasks/task-098-discord-channel-automation/forum-content-spec.md +++ b/docs/tasks/task-098-discord-channel-automation/forum-content-spec.md @@ -1,8 +1,49 @@ -# Discord Forum Content Specification +# Discord Server Setup — Implementation Spec **Created:** April 8, 2026 **Chronicler:** #70 -**Status:** Draft for Review +**Status:** APPROVED — Ready for Implementation +**Executor:** Chronicler #71 + +--- + +## 📊 TOTAL CHANGES SUMMARY + +| Type | Count | +|------|-------| +| New categories | 10 | +| New text channels | 20 (chat + in-game × 10) | +| New forum channels | 15 (5 existing + 10 new) | +| New voice channels | 10 | +| Archive category | 1 | +| Welcome posts | 15 | +| Permission sets applied | 15 categories | +| **TOTAL NEW CHANNELS** | **46** | + +--- + +## 🔧 IMPLEMENTATION ORDER + +1. **Grant bot permissions** — The Arbiter needs `Manage Channels` + `Manage Roles` in Discord server settings +2. **Add forum channels to existing 5 servers** (Stoneblock 4, SSV, ATM10, All the Mons, Mythcraft 5) +3. **Create categories + all channels for 10 new servers** +4. **Apply permission template to all 15 server categories** +5. **Add 🎮 emoji prefix to all server category names** +6. **Create 📦 Archive category at bottom** +7. **Post welcome messages in all 15 forums** +8. **Add forum tags to all 15 forums** + +--- + +## 📛 NAMING CONVENTION + +Use **server-name prefix** pattern (matches existing): + +| Server | Category | Chat | In-Game | Voice | +|--------|----------|------|---------|-------| +| Beyond Depth | 🎮 Beyond Depth | `beyond-depth-chat` | `beyond-depth-in-game` | `Beyond Depth` | +| Cottage Witch | 🎮 Cottage Witch | `cottage-witch-chat` | `cottage-witch-in-game` | `Cottage Witch` | +| etc. | ... | ... | ... | ... | --- @@ -371,34 +412,176 @@ Each server forum gets a pinned welcome post with: --- -## Moderation Discussion +## Moderation — APPROVED -### Options for Forum Moderation +**Decision:** Start with **Open** posting + light auto-mod -| Option | Description | Pros | Cons | -|--------|-------------|------|------| -| **Open** | Anyone with server role can post freely | Low friction, more engagement | Potential spam/low-quality posts | -| **Approval** | Posts require staff approval | Quality control | Bottleneck, delays, staff burden | -| **Auto-mod** | Bot filters spam/keywords | Automated protection | May catch false positives | -| **Hybrid** | First post needs approval, then open | Quality check on new users | Moderate complexity | +**Rationale:** +1. Server role requirement already gates access (must be Awakened + picked the server) +2. These are paying subscribers — they're invested +3. Low friction = more engagement = more community -**Recommendation:** Start with **Open** posting since the server role requirement already gates access to subscribers. Add auto-mod rules for common spam patterns. If problems arise, escalate to Hybrid. - -### Suggested Auto-mod Rules +**Auto-mod Rules:** - Block external links from accounts < 7 days old - Flag posts with excessive caps/emoji -- Alert staff on reports (2+ reports auto-hides post) +- 2 reports = auto-hide (staff reviews) --- -## Implementation Checklist +## 🔐 Permission Template (Per Server Category) -- [ ] Create forum channels for all 15 servers -- [ ] Add forum tags (same 6 tags for all) -- [ ] Post welcome messages (pinned) -- [ ] Configure auto-mod -- [ ] Test permission flow (Wanderer can see, Awakened+ServerRole can post) -- [ ] Update Task #98 with forum template in `!createserver` command +Apply to ALL 15 server categories: + +| Role | View Channel | Send Messages | Connect (Voice) | +|------|--------------|---------------|-----------------| +| @everyone | ❌ Deny | ❌ Deny | ❌ Deny | +| Wanderer | ✅ Allow | ❌ Deny | ❌ Deny | +| [Server Role] (e.g., "Stoneblock 4") | ✅ Allow | ✅ Allow | ✅ Allow | +| The Awakened | — (inherit) | — (inherit) | — (inherit) | +| Staff | ✅ Allow | ✅ Allow | ✅ Allow | +| 🛡️ Moderator | ✅ Allow | ✅ Allow | ✅ Allow | +| 👑 The Wizard | ✅ Allow | ✅ Allow | ✅ Allow | +| 💎 The Emissary | ✅ Allow | ✅ Allow | ✅ Allow | +| ✨ The Catalyst | ✅ Allow | ✅ Allow | ✅ Allow | + +**Key insight:** Awakened unlocks the ability to PICK server roles. The server role itself grants interaction. Wanderer = window shopping only. + +--- + +## 📁 SERVERS TO UPDATE + +### Existing 5 — ADD FORUM ONLY + +| Server | Role Exists | Category Exists | Channels | Add | +|--------|-------------|-----------------|----------|-----| +| Stoneblock 4 | ✅ | ✅ | chat, in-game, voice | + forum | +| Society: Sunlit Valley | ✅ | ✅ | chat, in-game, voice | + forum | +| All the Mods 10: To the Sky | ✅ | ✅ | chat, in-game, voice | + forum | +| All the Mons | ✅ | ✅ | chat, in-game, voice | + forum | +| Mythcraft 5 | ✅ | ✅ | chat, in-game, voice | + forum | + +### New 10 — CREATE EVERYTHING + +| Server | Role Exists | Create Category | Create Channels | +|--------|-------------|-----------------|-----------------| +| Beyond Depth | ✅ | 🎮 Beyond Depth | chat, in-game, forum, voice | +| Beyond Ascension | ✅ | 🎮 Beyond Ascension | chat, in-game, forum, voice | +| Wold's Vaults | ✅ | 🎮 Wold's Vaults | chat, in-game, forum, voice | +| Otherworld [D&D] | ✅ | 🎮 Otherworld [D&D] | chat, in-game, forum, voice | +| DeceasedCraft | ✅ | 🎮 DeceasedCraft | chat, in-game, forum, voice | +| Submerged 2 | ✅ | 🎮 Submerged 2 | chat, in-game, forum, voice | +| Sneak's Pirate Pack | ✅ | 🎮 Sneak's Pirate Pack | chat, in-game, forum, voice | +| Cottage Witch | ✅ | 🎮 Cottage Witch | chat, in-game, forum, voice | +| Farm Crossing 5 | ✅ | 🎮 Farm Crossing 5 | chat, in-game, forum, voice | +| Homestead | ✅ | 🎮 Homestead | chat, in-game, forum, voice | + +### Archive Category — CREATE + +| Category | Purpose | +|----------|---------| +| 📦 Archive | Hidden category for retired servers (visible to staff only) | + +--- + +## 🎨 VISUAL ORGANIZATION + +### Category Emoji Prefixes + +| Category Type | Emoji | Example | +|---------------|-------|---------| +| Server categories | 🎮 | 🎮 Stoneblock 4 | +| Archive | 📦 | 📦 Archive | + +### Category Positioning + +All server categories should be grouped together, after subscriber areas: + +``` +📢 Welcome & Info +💬 Community Hub +⭐ Subscriber Lounge +🔥 Fire Path +❄️ Frost Path +─────────────────── +🎮 Stoneblock 4 +🎮 Society: Sunlit Valley +🎮 All the Mods 10: To the Sky +🎮 All the Mons +🎮 Mythcraft 5 +🎮 Beyond Depth +🎮 Beyond Ascension +🎮 Wold's Vaults +🎮 Otherworld [D&D] +🎮 DeceasedCraft +🎮 Submerged 2 +🎮 Sneak's Pirate Pack +🎮 Cottage Witch +🎮 Farm Crossing 5 +🎮 Homestead +─────────────────── +⚙️ Staff Area +🔊 Voice Channels +📞 Support +📦 Archive +``` + +--- + +## ✅ Implementation Checklist + +### Phase 1: Bot Permissions +- [ ] Grant The Arbiter `Manage Channels` permission +- [ ] Grant The Arbiter `Manage Roles` permission +- [ ] Verify bot can create channels (test in Archive category?) + +### Phase 2: Existing 5 Servers — Add Forums +- [ ] Stoneblock 4: Create #forum, post welcome, add tags +- [ ] Society: Sunlit Valley: Create #forum, post welcome, add tags +- [ ] All the Mods 10: To the Sky: Create #forum, post welcome, add tags +- [ ] All the Mons: Create #forum, post welcome, add tags +- [ ] Mythcraft 5: Create #forum, post welcome, add tags + +### Phase 3: New 10 Servers — Create Everything +- [ ] Beyond Depth: Category + 4 channels + welcome + tags + permissions +- [ ] Beyond Ascension: Category + 4 channels + welcome + tags + permissions +- [ ] Wold's Vaults: Category + 4 channels + welcome + tags + permissions +- [ ] Otherworld [D&D]: Category + 4 channels + welcome + tags + permissions +- [ ] DeceasedCraft: Category + 4 channels + welcome + tags + permissions +- [ ] Submerged 2: Category + 4 channels + welcome + tags + permissions +- [ ] Sneak's Pirate Pack: Category + 4 channels + welcome + tags + permissions +- [ ] Cottage Witch: Category + 4 channels + welcome + tags + permissions +- [ ] Farm Crossing 5: Category + 4 channels + welcome + tags + permissions +- [ ] Homestead: Category + 4 channels + welcome + tags + permissions + +### Phase 4: Apply Permissions +- [ ] Apply permission template to all 15 server categories +- [ ] Verify Wanderer can see but not interact +- [ ] Verify Awakened + Server Role can interact +- [ ] Verify Staff/Trinity can access all + +### Phase 5: Visual Organization +- [ ] Add 🎮 emoji to existing 5 server category names +- [ ] Create 📦 Archive category (staff-only visibility) +- [ ] Position all server categories together + +### Phase 6: Future — `!createserver` Command +- [ ] Document exact command syntax +- [ ] Discuss forum starter content template +- [ ] Discuss Carl-bot reaction role integration +- [ ] Implement in Arbiter (Task #98 continuation) + +--- + +## 🔮 FUTURE: `!createserver` Command Discussion + +**Not implemented yet — needs discussion with Michael before building.** + +Questions to resolve: +1. **Command syntax:** `!createserver "Server Name" 🎮` or `!createserver "Server Name"` (auto-emoji)? +2. **Forum starter content:** Use templates from this doc? Customizable? +3. **Carl-bot integration:** Auto-add reaction role? Or manual step? +4. **Position:** Auto-position after last server category? +5. **Confirmation:** Require `!createserver confirm "Server Name"`? ---