From ff2a1bf7876d73bfbbefaeeaf7d778d327a7dd07 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 22 Feb 2026 20:40:20 +0000 Subject: [PATCH] feat: add Task #34 - Simple Voice Chat setup for Mayview Created complete task package for proximity voice chat on Mayview server. **New Task:** #34 - Simple Voice Chat Setup for Mayview - Tier: 3 (Documentation & Optimization) - Time: 1-2 hours - Status: READY **Task Package Includes:** - README.md: Complete task overview with configuration options - deployment-plan.md: Step-by-step installation and testing procedures **Key Features:** - Proximity-based voice chat (48 block default range) - Whisper mode (crouch for quieter, shorter range) - Group chat system - Client and server installation guides - Firewall configuration (UDP port 24454) - Player rollout communication templates - Testing plan (single + multi-client) - 30-day adoption review criteria **Technical Details:** - Mod: Simple Voice Chat by henkelmax - Platform: NeoForge 1.21.1 - Server: Mayview (NC1 Charlotte) - Requirements: Server + client installation, firewall rule - Codec: OPUS recommended (quality over VOIP performance) **Deployment Phases:** 1. Preparation (verify version, backup) 2. Server installation (mod + config + firewall) 3. Client testing (single player + multi-player proximity) 4. Player rollout (guide, announcement, monitoring) **Rollback Plan:** 5 minutes (remove mod, close port, restart) **Success Criteria:** - Server starts with no errors - Proximity detection works (volume changes with distance) - >50% player adoption (30-day review) - Positive feedback, stable performance Player experience enhancement - optional feature, doesn't replace Discord. Updated tasks.md: Total tasks now 34 (was 32) Signed-off-by: Chronicler #22 --- docs/core/tasks.md | 56 +- .../tasks/simple-voice-chat-mayview/README.md | 382 +++++++++ .../deployment-plan.md | 768 ++++++++++++++++++ 3 files changed, 1205 insertions(+), 1 deletion(-) create mode 100644 docs/tasks/simple-voice-chat-mayview/README.md create mode 100644 docs/tasks/simple-voice-chat-mayview/deployment-plan.md diff --git a/docs/core/tasks.md b/docs/core/tasks.md index 6d71757..999b3e6 100644 --- a/docs/core/tasks.md +++ b/docs/core/tasks.md @@ -765,7 +765,7 @@ Add custom "Modpack Version" field to Pterodactyl panel for version tracking vis ## 📊 QUICK STATS -**Total Tasks:** 32 (including Firefrost Codex) +**Total Tasks:** 34 (including Firefrost Codex + Simple Voice Chat) **Completed:** 3 (NC1 cleanup, Command Center cleanup, Whitelist Manager) **In Progress:** 2 (Vaultwarden, Terraria Arc) **Ready to Build:** 19+ (including Firefrost Codex!) @@ -846,3 +846,57 @@ Small improvements to Whitelist Manager: **Impact:** Cosmetic only - does not affect functionality --- + +### 34. Simple Voice Chat Setup for Mayview +**Time:** 1-2 hours +**Status:** READY +**Priority:** Tier 3 - Documentation & Optimization +**Server:** Mayview (NC1 Charlotte) +**Documentation:** `docs/tasks/simple-voice-chat-mayview/` + +Install Simple Voice Chat mod on Mayview to enable proximity-based in-game voice communication. + +**Features:** +- Proximity voice chat (hear players based on distance) +- Group chat system +- Whisper mode (crouch for quieter voice, shorter range) +- Adjustable distance and volume controls +- No external server required + +**Requirements:** +- Server-side: Install mod on Mayview +- Client-side: All players must install mod +- Firewall: Open UDP port 24454 on NC1 +- Configuration: Set voice distance, codec, settings + +**Benefits:** +- Enhanced immersion (spatial audio) +- Better role-playing experience +- Optional (players can still use Discord) +- Low performance overhead + +**Deployment:** +1. Research compatible version for NeoForge 1.21.1 +2. Install mod on server +3. Configure settings (voice distance 48 blocks, OPUS codec) +4. Open firewall port 24454/UDP +5. Test with small group (2-3 players) +6. Create player installation guide +7. Announce to Mayview players +8. Monitor feedback and adoption + +**Testing Plan:** +- Phase 1: Server installation and startup verification +- Phase 2: Single client test (connection, audio) +- Phase 3: Multi-client test (proximity, whisper, performance) +- Phase 4: Player rollout and monitoring + +**Rollback:** Remove mod, close firewall port, restart server (5 minutes) + +**Decision Point (30 days):** +- Keep if >50% adoption + positive feedback +- Remove if <30% adoption or major issues + +**See task directory for:** Complete deployment plan, configuration options, troubleshooting guide, player communication templates + +--- diff --git a/docs/tasks/simple-voice-chat-mayview/README.md b/docs/tasks/simple-voice-chat-mayview/README.md new file mode 100644 index 0000000..735bb3c --- /dev/null +++ b/docs/tasks/simple-voice-chat-mayview/README.md @@ -0,0 +1,382 @@ +# Task: Simple Voice Chat Setup for Mayview + +**Task ID:** #34 +**Tier:** 3 (Documentation & Optimization) +**Status:** READY +**Priority:** Low (Player experience enhancement) +**Estimated Time:** 1-2 hours +**Server:** Mayview (NC1 Charlotte) +**Created:** February 22, 2026 + +--- + +## OVERVIEW + +Install Simple Voice Chat mod on Mayview server to enable proximity-based in-game voice communication for players. + +**What it provides:** +- Proximity voice chat (hear players based on distance) +- Group chat system +- Adjustable voice distance and volume +- Whisper mode (lower volume, shorter range) +- No external server required (runs through Minecraft server) + +--- + +## CURRENT STATE + +**Mayview Server:** +- **Platform:** NeoForge +- **Version:** 1.21.1 +- **Location:** NC1 Charlotte +- **Modpack:** Custom (Cobblemon-focused) +- **Active Players:** [To be confirmed] + +**Current voice solution:** Players use Discord (assumed) + +--- + +## WHY THIS TASK + +**Benefits:** +- Enhanced immersion (proximity-based, not global Discord) +- Better role-playing experience +- Spatial awareness (know where voices come from) +- Optional for players (Discord still available) +- Low overhead performance + +**Use cases:** +- Cooperative Cobblemon hunts +- Trading negotiations +- In-game socializing +- Events and gatherings + +--- + +## PREREQUISITES + +### Technical Requirements +- [ ] Verify Mayview is 1.21.1 NeoForge +- [ ] Confirm Simple Voice Chat has 1.21.1 NeoForge version +- [ ] NC1 firewall access (open UDP port) +- [ ] Pterodactyl panel access for Mayview + +### Player Requirements +- [ ] All players must install client-side mod +- [ ] Players need microphones +- [ ] Players need to configure voice settings + +### Decision Requirements +- [ ] Confirm with players they want in-game voice +- [ ] Determine if Discord will still be used (hybrid approach) +- [ ] Choose voice chat settings (distance, volume limits) + +--- + +## DEPLOYMENT PLAN + +See `deployment-plan.md` for step-by-step installation instructions. + +--- + +## CONFIGURATION OPTIONS + +### Server Settings (config/voicechat/voicechat-server.toml) + +**Key settings to configure:** +- `port` - UDP port (default 24454, configurable) +- `voice_distance` - Max distance to hear voices (default 48 blocks) +- `crouch_distance_multiplier` - Whisper distance when crouching (default 0.5) +- `codec` - Audio codec (VOIP or OPUS, recommend OPUS for quality) +- `max_voice_distance` - Hard limit on voice distance +- `allow_recording` - Allow players to record voice (default false) + +**Example config:** +```toml +[voice] +port = 24454 +voice_distance = 48.0 +crouch_distance_multiplier = 0.5 +max_voice_distance = 120.0 +codec = "OPUS" +mtu_size = 1024 +keep_alive = 1000 +allow_recording = false +``` + +### Client Settings (Players configure in-game) + +Players can adjust: +- Input device (microphone) +- Output device (speakers/headphones) +- Voice activation threshold +- Push-to-talk keybind (default V) +- Output volume +- Microphone amplification + +--- + +## FIREWALL REQUIREMENTS + +**NC1 Charlotte firewall:** +- **Port:** 24454 (UDP, configurable) +- **Direction:** Inbound +- **Source:** Any (players connecting) +- **Destination:** NC1 IP + +**UFW command:** +```bash +sudo ufw allow 24454/udp comment 'Simple Voice Chat - Mayview' +``` + +**Verification:** +```bash +sudo ufw status | grep 24454 +``` + +--- + +## ROLLBACK PLAN + +**If issues occur:** + +1. **Stop the server** (Pterodactyl panel) +2. **Remove mod files:** + ```bash + rm /path/to/server/mods/voicechat-*.jar + rm -rf /path/to/server/config/voicechat/ + ``` +3. **Close firewall port:** + ```bash + sudo ufw delete allow 24454/udp + ``` +4. **Restart server** + +**Time to rollback:** 5 minutes + +**Data loss:** None (voice chat is realtime, no persistent data) + +--- + +## TESTING PLAN + +### Phase 1: Server Installation (15 minutes) +1. Install mod on server +2. Configure settings +3. Open firewall port +4. Start server +5. Verify no errors in logs + +### Phase 2: Single Client Test (15 minutes) +1. Install mod on test client +2. Connect to Mayview +3. Verify voice settings menu appears +4. Test microphone detection +5. Verify no connection errors + +### Phase 3: Multi-Client Test (30 minutes) +1. Get 2-3 players with mod installed +2. Test proximity chat (walking toward/away) +3. Test whisper mode (crouching) +4. Test group chat system +5. Test volume controls +6. Verify performance (lag check) + +### Success Criteria +- ✅ Server starts with no errors +- ✅ Players can connect normally +- ✅ Voice chat menu accessible in-game +- ✅ Proximity detection works (volume changes with distance) +- ✅ Audio quality acceptable +- ✅ No performance degradation +- ✅ Push-to-talk works reliably + +--- + +## PLAYER COMMUNICATION + +### Pre-Installation Notice + +**Discord announcement template:** + +``` +📢 New Feature Coming to Mayview: In-Game Voice Chat! + +We're adding Simple Voice Chat to enhance your Cobblemon experience. + +**What is it?** +Proximity-based voice chat - you'll hear players based on distance in-game! + +**Why add it?** +- More immersive than Discord +- Know WHERE voices come from +- Whisper mode for sneaky trades +- Optional - Discord still available + +**What you need:** +- Download the mod (link below) +- Install in your mods folder +- Restart Minecraft +- Configure your mic in-game (Settings → Voice Chat) + +**Installation Guide:** [Link to guide] +**Mod Download:** [CurseForge/Modrinth link] + +**Testing Date:** [TBD] +Questions? Ask in #support! +``` + +### Post-Installation Guide + +**Create player guide covering:** +- Where to download the mod +- How to install (copy to mods folder) +- How to configure microphone +- Keybinds (V for push-to-talk) +- Volume adjustment +- Troubleshooting common issues + +--- + +## KNOWN ISSUES & SOLUTIONS + +### Issue: "Voice chat not connected" +**Cause:** Firewall blocking UDP port +**Solution:** Verify port 24454 open, check player's router/firewall + +### Issue: "No audio heard from other players" +**Cause:** Output device not selected +**Solution:** Check Settings → Voice Chat → Audio Output + +### Issue: "Can't transmit voice" +**Cause:** Microphone permissions or input device +**Solution:** Check Settings → Voice Chat → Audio Input, verify mic permissions + +### Issue: "Choppy/laggy audio" +**Cause:** High latency or packet loss +**Solution:** Reduce voice distance, check player's connection, consider codec change + +### Issue: "Mod won't load" +**Cause:** Version mismatch (Forge vs NeoForge) +**Solution:** Download correct NeoForge version, verify compatibility + +--- + +## MAINTENANCE + +**Ongoing:** +- Monitor server logs for voice chat errors +- Update mod when new versions release +- Gather player feedback on audio quality +- Adjust settings based on player count/feedback + +**Monthly:** +- Check for Simple Voice Chat updates +- Verify firewall rule still active +- Review player feedback + +**Quarterly:** +- Evaluate usage (are players using it?) +- Consider removing if unused +- Update player guide if needed + +--- + +## SUCCESS METRICS + +**Adoption:** +- What % of active players install the mod? +- How many players use it regularly? + +**Experience:** +- Player feedback (survey or Discord poll) +- Audio quality acceptable? +- Performance impact noticed? + +**Technical:** +- Server stability maintained? +- Logs show errors? +- Firewall rule working? + +**Decision point (1 month after install):** +- If <30% adoption → Consider removing +- If >50% adoption and positive feedback → Keep and promote +- If technical issues → Troubleshoot or rollback + +--- + +## ALTERNATIVE OPTIONS + +**If Simple Voice Chat doesn't work:** + +### Option 1: Plasmo Voice +- Similar features +- Less popular but comparable +- Try if Simple Voice Chat has issues + +### Option 2: Discord + Voice Channels +- No mod required +- Proximity plugin available (bot-based) +- Less immersive but zero setup for players + +### Option 3: No in-game voice +- Keep Discord as primary +- Players already familiar +- No additional setup + +--- + +## COST + +**Financial:** $0 (free mod) +**Time:** 1-2 hours setup + testing +**Player time:** 10 minutes per player (mod install) + +--- + +## DEPENDENCIES + +**Blocks:** None +**Blocked by:** None +**Related tasks:** Mayview mod compatibility analysis (completed) + +--- + +## NOTES + +- Test with small group first (2-3 players) +- Get feedback before announcing to all players +- Consider making optional (don't force installation) +- Keep Discord available as fallback +- Monitor first week closely for issues + +**Player comfort matters:** Some players prefer Discord, don't force the change. + +--- + +## REFERENCES + +**Mod pages:** +- CurseForge: [Search "Simple Voice Chat NeoForge 1.21.1"] +- Modrinth: [Search "Simple Voice Chat NeoForge 1.21.1"] +- GitHub: henkelmax/simple-voice-chat + +**Documentation:** +- Official wiki: [Check mod page for docs link] +- Configuration guide: [In mod files after download] + +--- + +## STATUS LOG + +**2026-02-22:** Task created, research phase complete + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ + +--- + +**Created:** February 22, 2026 +**By:** Chronicler #22 +**Status:** Ready for deployment when approved diff --git a/docs/tasks/simple-voice-chat-mayview/deployment-plan.md b/docs/tasks/simple-voice-chat-mayview/deployment-plan.md new file mode 100644 index 0000000..167c079 --- /dev/null +++ b/docs/tasks/simple-voice-chat-mayview/deployment-plan.md @@ -0,0 +1,768 @@ +# Simple Voice Chat - Deployment Plan + +**Task:** #34 - Simple Voice Chat Setup for Mayview +**Server:** Mayview (NC1 Charlotte) +**Estimated Time:** 1-2 hours +**Created:** February 22, 2026 + +--- + +## PHASE 0: PREPARATION (15 minutes) + +### Step 1: Verify Mayview Details + +**SSH to NC1:** +```bash +ssh root@216.239.104.130 +``` + +**Verify Mayview is running and get details:** +```bash +# Use Pterodactyl panel to check: +# - Minecraft version +# - NeoForge version +# - Current mod count +# - Server performance +``` + +**Confirm:** +- [ ] Mayview is 1.21.1 +- [ ] NeoForge version confirmed +- [ ] Server is stable +- [ ] No recent crashes + +--- + +### Step 2: Research Compatible Version + +**Find Simple Voice Chat version for NeoForge 1.21.1:** + +**CurseForge search:** +1. Go to https://www.curseforge.com/minecraft/mc-mods/simple-voice-chat +2. Click "Files" tab +3. Filter: Game Version = 1.21.1, Mod Loader = NeoForge +4. Download latest stable version + +**Modrinth search (alternative):** +1. Go to https://modrinth.com/plugin/simple-voice-chat +2. Click "Versions" tab +3. Filter: Game Version = 1.21.1, Mod Loader = NeoForge +4. Download latest version + +**Verify dependencies:** +- Check mod page for required dependencies +- Most likely: None (standalone mod) + +**Record version details:** +``` +Mod: Simple Voice Chat +Version: [X.X.X] +Minecraft: 1.21.1 +Loader: NeoForge [version] +File: voicechat-neoforge-[version].jar +``` + +--- + +### Step 3: Backup Mayview + +**Create backup before making changes:** + +**Via Pterodactyl panel:** +1. Navigate to Mayview server +2. Go to "Backups" tab +3. Click "Create Backup" +4. Name: `pre-voicechat-[date]` +5. Wait for completion + +**Verify backup:** +- [ ] Backup created successfully +- [ ] Backup size reasonable (check against previous backups) +- [ ] Backup downloadable (test download if paranoid) + +--- + +## PHASE 1: SERVER INSTALLATION (20 minutes) + +### Step 4: Upload Mod to Server + +**Method 1: Via Pterodactyl File Manager** +1. Navigate to Mayview server in Pterodactyl +2. Go to "Files" tab +3. Navigate to `/mods/` directory +4. Click "Upload" button +5. Select downloaded voicechat-neoforge-[version].jar +6. Wait for upload to complete + +**Method 2: Via SFTP (if Pterodactyl upload fails)** +```bash +# Use FileZilla or similar SFTP client +# Host: 216.239.104.130 +# Port: 2022 (or Pterodactyl SFTP port) +# Upload to: /mods/ +``` + +**Verify upload:** +```bash +# Via Pterodactyl file manager, verify file exists: +# /mods/voicechat-neoforge-[version].jar +``` + +- [ ] Mod file uploaded +- [ ] File size matches download (verify not corrupted) + +--- + +### Step 5: Configure Voice Chat Settings + +**Access server files via Pterodactyl:** +1. Go to "Files" tab +2. Navigate to `/config/voicechat/` + - If directory doesn't exist: It will be created on first server start + - Proceed to Step 6, then return here after first start + +**If config exists, edit voicechat-server.toml:** + +**Via Pterodactyl editor:** +```toml +[voice] +# UDP port for voice chat (must be opened in firewall) +port = 24454 + +# Maximum voice distance in blocks +voice_distance = 48.0 + +# Distance multiplier when crouching (whisper mode) +crouch_distance_multiplier = 0.5 + +# Maximum allowed voice distance (prevents abuse) +max_voice_distance = 120.0 + +# Audio codec (OPUS recommended for quality, VOIP for performance) +codec = "OPUS" + +# MTU size (usually don't change) +mtu_size = 1024 + +# Keep alive interval in ms +keep_alive = 1000 + +# Allow players to record voice (privacy concern - recommend false) +allow_recording = false + +# Voice chat enabled (true to enable) +enabled = true +``` + +**Save the file.** + +**Recommended settings for Mayview:** +- Port: 24454 (default, unless conflicts exist) +- Voice distance: 48 blocks (good balance) +- Codec: OPUS (better quality) +- Recording: false (privacy protection) + +- [ ] Configuration file edited +- [ ] Settings match recommendations (or custom choices documented) + +--- + +### Step 6: Open Firewall Port on NC1 + +**SSH to NC1:** +```bash +ssh root@216.239.104.130 +``` + +**Add UFW rule for voice chat:** +```bash +sudo ufw allow 24454/udp comment 'Simple Voice Chat - Mayview' +``` + +**Verify rule added:** +```bash +sudo ufw status | grep 24454 +``` + +**Expected output:** +``` +24454/udp ALLOW Anywhere # Simple Voice Chat - Mayview +``` + +**Test port is open (from external machine):** +```bash +# From your local machine (not NC1): +nc -zvu 216.239.104.130 24454 +# Should show connection attempt (may timeout, but proves port reachable) +``` + +- [ ] UFW rule added +- [ ] Rule appears in ufw status +- [ ] Port externally reachable (optional test) + +--- + +### Step 7: Start Mayview Server + +**Via Pterodactyl panel:** +1. Navigate to Mayview server +2. Click "Console" tab +3. Click "Start" button +4. Watch console for errors + +**Monitor startup:** +``` +Watch for: +✅ "Simple Voice Chat" initialization messages +✅ "Voice chat server started on port 24454" +✅ Server reaches "Done" state +❌ Any error messages containing "voicechat" +❌ Crashes or failures to start +``` + +**Check logs specifically for voice chat:** +``` +# In Pterodactyl console, search for: +"voicechat" +"Simple Voice Chat" +"Voice chat server" +``` + +**If server fails to start:** +1. Check console for specific error +2. Verify mod file not corrupted (re-download if needed) +3. Check for dependency errors +4. See troubleshooting section + +- [ ] Server started successfully +- [ ] Voice chat initialized +- [ ] No errors in console +- [ ] Server fully loaded + +--- + +### Step 8: Verify Configuration Generated + +**After first start, config should be created:** + +**Via Pterodactyl file manager:** +1. Navigate to `/config/voicechat/` +2. Verify files exist: + - `voicechat-server.toml` (server config) + - Other config files may be present + +**If config wasn't manually edited in Step 5:** +- Edit now using recommended settings +- Restart server after editing + +- [ ] Config directory exists +- [ ] Config files generated +- [ ] Settings verified/updated + +--- + +## PHASE 2: CLIENT TESTING (30 minutes) + +### Step 9: Install Client Mod (Test Client) + +**On your test Minecraft client:** + +1. **Download same version as server:** + - Use same file: voicechat-neoforge-[version].jar + - Or download from CurseForge/Modrinth (client version) + +2. **Install mod:** + ``` + # Copy jar file to: + %appdata%\.minecraft\mods\ (Windows) + ~/Library/Application Support/minecraft/mods/ (Mac) + ~/.minecraft/mods/ (Linux) + ``` + +3. **Start Minecraft:** + - Launch Minecraft with NeoForge 1.21.1 profile + - Verify mod loads (check Mods menu) + +4. **Verify mod appears:** + - Main menu → Mods + - Search for "Simple Voice Chat" + - Should appear in list + +- [ ] Client mod installed +- [ ] Minecraft starts successfully +- [ ] Mod appears in mod list + +--- + +### Step 10: Configure Client Settings + +**Connect to Mayview:** +``` +Server: 216.239.104.130 (or Mayview's address) +``` + +**Access voice chat settings:** +- Press ESC (in-game) +- Click "Options" +- Click "Voice Chat Settings" (new button) + +**Configure audio:** + +**Input (Microphone):** +- Select your microphone +- Adjust activation threshold (test by speaking) +- Choose push-to-talk or voice activation +- Set push-to-talk key (default: V) + +**Output (Speakers/Headphones):** +- Select output device +- Adjust voice chat volume +- Test with another player if available + +**Other settings:** +- Enable voice chat: ON +- Noise suppression: Recommended +- Microphone amplification: Adjust as needed + +- [ ] Voice chat settings accessible +- [ ] Microphone detected +- [ ] Output device selected +- [ ] Push-to-talk key set + +--- + +### Step 11: Single Player Test + +**Test alone first:** + +**Verify connection:** +- Join Mayview server +- Press TAB to see player list +- Look for voice chat icon next to your name +- Should show microphone status + +**Test microphone:** +- Hold push-to-talk key (V) +- Speak into microphone +- Should see voice indicator (visual feedback) + +**Test in-game menu:** +- Access voice chat menu (check mod docs for keybind) +- Verify settings save +- Adjust volume if needed + +**Check console for errors:** +``` +# In Minecraft console (F3+D to open) +# Look for voice chat connection messages +# Should show "Connected to voice chat server" +``` + +- [ ] Connected to voice chat server +- [ ] Microphone activates on push-to-talk +- [ ] Visual feedback visible +- [ ] No connection errors + +--- + +### Step 12: Multi-Player Proximity Test + +**Get 2-3 test players:** +- Other staff members +- Willing players from Discord +- Alt accounts if available + +**Test proximity mechanics:** + +**Test 1: Distance detection** +1. Start near each other (within 10 blocks) +2. One player speaks (push-to-talk) +3. Others verify they hear clearly +4. Walk away slowly while speaking +5. Verify volume decreases with distance +6. At 48 blocks, voice should be very quiet/silent + +**Test 2: Whisper mode (crouch)** +1. Stand 20 blocks apart +2. Speaker crouches and speaks +3. Verify whisper is quieter than normal +4. Test that whisper distance is reduced + +**Test 3: Multiple speakers** +1. Have 2+ people speak simultaneously +2. Verify audio doesn't clip/distort +3. Check that multiple voices are audible + +**Test 4: Volume controls** +1. Each player adjusts output volume +2. Verify independent control works +3. Test mute function + +**Test 5: Performance check** +1. Monitor FPS while voice chatting +2. Check for lag or stuttering +3. Verify server TPS remains stable (check Pterodactyl) + +- [ ] Proximity detection works (volume changes with distance) +- [ ] Whisper mode functions correctly +- [ ] Multiple simultaneous voices work +- [ ] Volume controls effective +- [ ] No performance degradation + +--- + +## PHASE 3: PLAYER ROLLOUT (Ongoing) + +### Step 13: Create Player Installation Guide + +**Write guide covering:** + +```markdown +# How to Install Simple Voice Chat for Mayview + +## Download the Mod + +1. Download from: [CurseForge link] + OR + Download from: [Modrinth link] + +2. Make sure you download the **NeoForge 1.21.1** version! + +## Install the Mod + +1. Locate your Minecraft mods folder: + - Windows: Press Win+R, type %appdata%\.minecraft\mods + - Mac: ~/Library/Application Support/minecraft/mods + - Linux: ~/.minecraft/mods + +2. Copy the downloaded .jar file into the mods folder + +3. Restart Minecraft + +## Configure Voice Chat + +1. Launch Minecraft with your Mayview profile +2. Connect to Mayview server +3. Press ESC → Options → Voice Chat Settings +4. Select your microphone (Input Device) +5. Select your speakers/headphones (Output Device) +6. Set Push-to-Talk key (default: V) +7. Test your microphone by speaking + +## Using Voice Chat + +- **Talk:** Hold V (or your chosen key) +- **Whisper:** Crouch while talking (quieter, shorter range) +- **Mute:** [Check in-game menu for mute keybind] +- **Adjust Volume:** Voice Chat Settings → Output Volume + +## Troubleshooting + +**"Voice chat not connected"** +- Check that Simple Voice Chat mod is installed +- Verify you're on Mayview server +- Try restarting Minecraft + +**"Can't hear anyone"** +- Check Output Device in settings +- Increase Output Volume +- Ask others to speak (push-to-talk) + +**"Others can't hear me"** +- Check Input Device (microphone) selected +- Hold push-to-talk key while speaking +- Adjust microphone amplification + +**Need help?** Ask in Discord #support! +``` + +**Save guide to:** +- Discord (pinned message in #mayview channel) +- Firefrost wiki (if available) +- Pastebin/Google Doc (shareable link) + +- [ ] Player guide written +- [ ] Guide reviewed for clarity +- [ ] Guide posted in accessible location + +--- + +### Step 14: Announce to Players + +**Discord announcement:** + +See README.md for announcement template. + +**Post in:** +- #announcements +- #mayview +- @Mayview role mention + +**Include:** +- What it is +- Why it's cool +- How to install (link to guide) +- Testing date/time +- Optional (don't force) + +- [ ] Announcement posted +- [ ] Installation guide linked +- [ ] Questions answered + +--- + +### Step 15: Scheduled Testing Session + +**Plan group testing event:** + +**Announce:** +``` +🎙️ Voice Chat Testing Event! + +Date: [TBD] +Time: [TBD] +Location: Mayview server + +Come test the new proximity voice chat! +- Cobblemon hunts with voice coordination +- Hide and seek with whisper mode +- Just hang out and chat naturally + +Bring your microphone! +Install guide: [link] +``` + +**During testing:** +- Be online to troubleshoot +- Gather feedback +- Note any issues +- Adjust settings if needed + +- [ ] Testing event scheduled +- [ ] Event announced +- [ ] Participated in testing +- [ ] Feedback collected + +--- + +## PHASE 4: MONITORING & OPTIMIZATION (Ongoing) + +### Step 16: Monitor First Week + +**Check daily:** +- Server logs for voice chat errors +- Player feedback in Discord +- Server performance (TPS) +- Any crashes related to voice chat + +**Gather feedback:** +- Ask players about audio quality +- Check if they're using it +- Note any complaints or issues + +**Common adjustments:** +- Voice distance (too far/too short?) +- Codec (quality vs performance) +- Volume limits (too loud/quiet?) + +- [ ] Daily log checks complete +- [ ] Player feedback positive +- [ ] No major issues +- [ ] Settings optimized + +--- + +### Step 17: One-Month Review + +**After 30 days, evaluate:** + +**Adoption rate:** +- How many players installed? +- How many actively use it? +- Do players prefer it over Discord? + +**Technical performance:** +- Any crashes or errors? +- Server performance impact? +- Audio quality acceptable? + +**Player sentiment:** +- Positive feedback? +- Complaints or requests? +- Worth keeping? + +**Decision:** +- **Keep:** >50% adoption, positive feedback, no issues +- **Modify:** Issues but fixable (adjust settings) +- **Remove:** <30% adoption or major problems + +- [ ] Metrics gathered +- [ ] Feedback reviewed +- [ ] Decision made +- [ ] Action taken (keep/modify/remove) + +--- + +## ROLLBACK PROCEDURE + +**If you need to remove Simple Voice Chat:** + +### Step 1: Stop Mayview +``` +# Via Pterodactyl panel: Stop server +``` + +### Step 2: Remove Mod Files +``` +# Via Pterodactyl file manager: +# Delete: /mods/voicechat-neoforge-[version].jar +# Delete: /config/voicechat/ (entire directory) +``` + +### Step 3: Close Firewall Port +```bash +ssh root@216.239.104.130 +sudo ufw delete allow 24454/udp +sudo ufw status # Verify removed +``` + +### Step 4: Restart Server +``` +# Via Pterodactyl panel: Start server +``` + +### Step 5: Notify Players +``` +Discord announcement: +"We've removed Simple Voice Chat from Mayview due to [reason]. +Players can remove the mod from their mods folder. +We're sticking with Discord for voice communication." +``` + +**Rollback time:** 10 minutes +**Data loss:** None (voice chat is realtime only) + +--- + +## TROUBLESHOOTING + +### Server won't start after mod install + +**Check:** +- Mod version matches server version (1.21.1 NeoForge) +- File not corrupted (re-download) +- No conflicting mods (check crash log) + +**Solution:** +``` +1. Remove mod temporarily +2. Start server (verify works without mod) +3. Re-download mod from official source +4. Install again +5. Check console for specific error +``` + +--- + +### "Voice chat server failed to start" + +**Check:** +- Port 24454 not already in use +- Firewall allows UDP 24454 +- Config file syntax correct + +**Solution:** +```bash +# Check if port in use: +sudo netstat -tulpn | grep 24454 + +# Try different port in config: +port = 24455 # In voicechat-server.toml + +# Update firewall: +sudo ufw allow 24455/udp +``` + +--- + +### Players can't connect to voice chat + +**Check:** +- Client mod installed and same version as server +- Firewall not blocking on player's end +- Voice chat enabled in client settings + +**Solution:** +``` +1. Verify client mod version matches server +2. Check client firewall/antivirus +3. Have player restart Minecraft +4. Test with different player (isolate issue) +``` + +--- + +### Audio quality poor/choppy + +**Check:** +- Player's internet connection +- Server TPS (performance issue?) +- Codec setting (try VOIP instead of OPUS) + +**Solution:** +```toml +# In voicechat-server.toml: +codec = "VOIP" # Lower quality, better performance + +# Or reduce voice distance: +voice_distance = 32.0 # Reduce from 48 +``` + +--- + +## SUCCESS CRITERIA + +**Phase 1 (Server Installation):** +- ✅ Server starts with voice chat mod +- ✅ No errors in console +- ✅ Firewall port open +- ✅ Config generated/verified + +**Phase 2 (Client Testing):** +- ✅ Client mod installs successfully +- ✅ Connection to voice server works +- ✅ Proximity detection functions +- ✅ Audio quality acceptable +- ✅ No performance impact + +**Phase 3 (Player Rollout):** +- ✅ Installation guide clear +- ✅ Players can install without help +- ✅ >3 players test successfully +- ✅ Positive feedback + +**Phase 4 (Long-term):** +- ✅ >50% adoption rate +- ✅ Stable performance +- ✅ Players prefer it or use alongside Discord +- ✅ No major issues + +--- + +## DOCUMENTATION UPDATES + +**After completion, update:** +- [ ] tasks.md (mark task complete) +- [ ] infrastructure-manifest.md (if voice chat is significant addition) +- [ ] Mayview server documentation +- [ ] Player handbook/wiki + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ + +--- + +**Created:** February 22, 2026 +**By:** Chronicler #22 +**Status:** Ready for execution when approved