Skip to content

Conversation

@druid-infra
Copy link
Contributor

Summary

Comprehensive documentation for Druid's ColdStarter wake-on-demand system.

Content

  • What is ColdStarter: Overview of wake-on-demand technology
  • Cost Savings: 70-90% reduction examples and breakdowns
  • Architecture: How the listener proxy + packet handlers work
  • Game Support: 95 scrolls with optimized handlers
  • Configuration: scroll.yaml examples and tuning
  • Custom Handlers: Lua API for unsupported games
  • Performance: Resource usage and wake time metrics
  • Troubleshooting: Common issues and solutions

Key Features Documented

✅ Seamless server browser integration (appears online while sleeping)
✅ Per-second billing with idle shutdown
✅ Lua packet handler system for game protocols
✅ Snapshot support for faster wake times
✅ Queue management during wake process

Target Audience

  • New users learning about Druid's killer feature
  • Power users optimizing costs
  • Developers creating custom packet handlers

Position: docs/general/ (general platform documentation)

- Explain wake-on-demand architecture
- Detail cost savings (70-90% reduction)
- Document Lua packet handler system
- Provide configuration examples
- Include performance metrics and troubleshooting
- Cover all 95 supported games/scrolls
@druid-infra
Copy link
Contributor Author

Error: This repo is not allowlisted for Atlantis.

@cloudflare-workers-and-pages
Copy link
Contributor

cloudflare-workers-and-pages bot commented Feb 10, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
docs 8a5f29c Commit Preview URL

Branch Preview URL
Feb 10 2026, 03:08 PM

Lugh (Druid Bot) added 4 commits February 10, 2026 14:08
- Replace < with &lt;
- Replace > with &gt;
- Fixes MDX compilation errors
- Replace packet handler code example with link to actual GitHub file
- Remove 'Cost Optimization Tips' section
- Remove 'Performance' section
- Remove 'Troubleshooting' section
- Remove FAQ question about sleeping cost
- Simplifies docs to focus on core concepts
- Moved from docs/general/coldstarter.md to docs/cli/coldstarter.md
- Updated sidebar_position to 2 (after intro)
- ColdStarter is a core CLI feature, belongs with CLI docs
@druid-infra druid-infra merged commit 6d4c871 into master Feb 10, 2026
2 checks passed
@druid-infra druid-infra deleted the feat/coldstarter-docs branch February 10, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant