When hourly sync encounters servers that fail (e.g., mid-restart):
- Logs the failure count
- Schedules automatic retry in 10 minutes
- Retry only targets previously failed servers
- Clears error state on successful retry
Fixes issue where servers in daily restart would stay in error state
until manual intervention.
Chronicler #69
WHAT THIS ADDS:
- Discord role sync on new subscriptions (checkout.session.completed)
- Discord role removal on chargebacks (charge.dispute.created)
- Grace period expiration job (hourly cron check)
- Automatic downgrade to Awakened when grace period expires
NEW FILES:
- src/services/discordRoleSync.js - Role add/remove/sync functions
- src/sync/graceExpiration.js - Grace period expiration processor
MODIFIED FILES:
- src/routes/stripe.js - Added role sync calls to webhook handlers
- src/discord/events.js - Initialize role sync service on bot ready
- src/sync/cron.js - Added grace period check to hourly job
- src/index.js - Import discordRoleSync service
PHILOSOPHY:
'We Don't Kick People Out' - expired grace periods downgrade to
permanent Awakened tier (tier 1, lifetime). Users keep community
access, just lose premium perks.
ROLE MAPPING (tier_level -> role key):
1=the-awakened, 2=fire-elemental, 3=frost-elemental,
4=fire-knight, 5=frost-knight, 6=fire-master, 7=frost-master,
8=fire-legend, 9=frost-legend, 10=the-sovereign
CHARGEBACKS:
- Immediate role removal
- Added to banned_users table
- Full audit logging
Signed-off-by: Claude (Chronicler #62) <claude@firefrostgaming.com>
WHAT WAS FIXED:
Production deployment revealed silent sync failure. Root cause: Pterodactyl
API nest filtering was broken. Gemini consultation provided Solution C
(environment variable configuration) for robust, maintainable operation.
GEMINI'S RECOMMENDATIONS IMPLEMENTED:
1. Solution C: MINECRAFT_NEST_IDS environment variable (explicit control)
2. Comprehensive sync logging (visibility into each step)
3. 'lifetime' status support for The Trinity (owner access)
4. Early exit with warning when 0 servers discovered
ROOT CAUSE ANALYSIS:
Original code filtered servers by nest relationship name:
server.attributes.relationships?.nest?.attributes?.name === 'Minecraft'
Problem: API doesn't include nest relationships in response, so filter
returned 0 servers, causing silent sync failure with no error logs.
Solution: Filter by nest ID directly using environment variable:
allowedNests.includes(server.attributes.nest)
CHANGES:
.env.example:
- Added MINECRAFT_NEST_IDS=1,6,7 (Minecraft, NeoForge, Hytale nests)
- Explicit configuration instead of dynamic discovery
- User controls which nests to sync (adaptable to nest reorganization)
src/panel/discovery.js:
- Parse MINECRAFT_NEST_IDS from environment
- Filter servers by nest ID (not relationship name)
- Remove broken ?include=allocations,node,nest parameter
- Direct integer comparison (robust, predictable)
src/sync/immediate.js:
- Added comprehensive logging at each step:
* Player count from database
* Server discovery count
* Success/failure counts per sync
- Added 'lifetime' status to query (for Trinity owner access)
- Early exit with warning if 0 servers discovered
- Per-server error logging with server name + identifier
PRODUCTION TESTING RESULTS:
✅ Discovered 12 target servers (nests 1, 6, 7)
✅ Retrieved 1 active player from database
✅ Synced successfully to all 12 servers (0 failures)
✅ Whitelist.json confirmed on Panel servers
✅ Logs show clear visibility into sync process
GEMINI ARCHITECTURAL GUIDANCE:
- Solution C preferred over dynamic discovery (predictable, no extra API calls)
- Manual whitelist enforcement (don't automate server.properties editing)
- Configure Pterodactyl Eggs with white-list=true for future servers
- Explicit configuration > keyword matching (prevents accidental overwrites)
DEPLOYMENT VERIFIED:
Command Center (63.143.34.217) running Arbiter 3.0 successfully syncing
whitelists to 12 Minecraft servers across nests 1 (Minecraft), 6 (NeoForge),
and 7 (Hytale).
SOFT LAUNCH BLOCKERS:
✅ Task #87 (Cancellation flow) - Webhook handlers ready
✅ Task #90 (Whitelist management) - DEPLOYED AND OPERATIONAL
FILES MODIFIED:
- .env.example (added MINECRAFT_NEST_IDS)
- src/panel/discovery.js (environment-based nest filtering)
- src/sync/immediate.js (comprehensive logging + lifetime status)
Signed-off-by: The Golden Chronicler <claude@firefrostgaming.com>
