docs(Task #98): Finalize Discord implementation spec — APPROVED
TOTAL CHANGES: - 10 new categories - 46 new channels (20 text, 15 forum, 10 voice, 1 archive) - 15 welcome posts with server-specific content - Permission template for all 15 servers IMPLEMENTATION ORDER: 1. Grant bot permissions (Manage Channels + Manage Roles) 2. Add forums to existing 5 servers 3. Create categories + channels for 10 new servers 4. Apply permission template (Wanderer=view, ServerRole=interact) 5. Add 🎮 emoji prefix to all server categories 6. Create 📦 Archive category 7. Post welcome messages 8. Add forum tags Status: APPROVED by Michael — Ready for Chronicler #71 Chronicler: #70
This commit is contained in:
Claude Chronicler-70
committed by
Claude
Claude
parent
a39af73f69
commit
abad8e465d
@@ -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"`?
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user