Documentation
Premium vs Free
A complete comparison of the two GuildScript plans, based on the limits the bot actually enforces.
Every account starts on the Free plan. Premium costs USD 5 per month, is billed through Razorpay via the /premium command, and applies to every server you own (servers are owned by the account that ran /initialize in them). Both plans run the same runtime and the same scripting API; Premium only changes the limits.
Plan comparison
| Limit | Free | Premium |
|---|---|---|
| Price | $0 | $5 / month |
| Agents per server | 6 | 24 |
| Servers you can initialize | 10 | 50 |
| Total agents across servers | 60 | 1,200 |
| Agent runs per second (per server) | 3 | 100 |
| Agent runs per minute (per server) | 400 | 1,000 |
| Agent runs per hour (per server) | 650 | 5,000 |
| Agent runs per day (per server) | 800 | 10,000 |
| Agents running in parallel (per server) | 2 | 8 |
| Memory per agent run | 20 MiB | 96 MiB |
| Script file size | 24 KiB | 128 KiB |
| Execution timeout per run | 3.5 s | 10 s |
| LLM call timeout | 5 s | 10 s |
| Execution timeout with an LLM connected | 8 s (5 s + 3 s) | 15 s (10 s + 5 s) |
| Command cooldown (per user) | 10 s | 2.5 s |
| Custom commands | Coming soon | Coming soon |
| Bring your own MongoDB and AI keys | Yes | Yes |
| Documentation and examples | Yes | Yes |
Each agent execution counts as one run against the server's quota in four rolling windows (second, minute, hour, day). When a window is exhausted, agents in that server pause until it refills, and the failure is reported to the agent's error channel as a RateLimitError. You can watch live usage with /profile.
What Premium changes in practice
- More room per server: 24 agents instead of 6 lets one server run moderation, leveling, reaction roles, logging, and AI features side by side.
- Busier servers stay responsive: 100 runs per second absorbs bursts (a popular channel, a raid, a giveaway) that would throttle the Free quota.
- More parallelism: up to 8 agents from your server execute at the same time instead of 2, so a busy event does not make agents wait in line behind each other.
- Heavier scripts: 96 MiB of memory and a 10 second timeout allow larger data processing and longer chains of Discord actions per run.
- Longer AI calls: each
llm.chatrequest gets 10 seconds instead of 5, and LLM runs get a 15 second execution window instead of 8, so slower models stop timing out. - Bigger files: 128 KiB uploads leave room for well-commented, multi-feature agents.
- Snappier management: the shared command cooldown drops from 10 s to 2.5 s.
What happens when Premium ends
Your agents and data are never deleted. The exact behavior when a subscription lapses (status halted after a failed renewal, cancelled after the paid period ends, or simply expired):
- All servers you own are disabled: their agents stop running and the management menus tell you why.
- Run
/initializein a server to reactivate it on the Free plan. You can reactivate up to the Free limit of 10 servers. - In a reactivated server, your first 6 agents (in creation order) run again. Agents beyond the limit are marked disabled: they can be downloaded or deleted but not edited.
- Renewing Premium with
/premiuminstantly unlocks every server and agent again. Nothing needs to be re-uploaded.
Subscription statuses
| Status | Meaning | Premium access |
|---|---|---|
active | Subscription is running and will renew. | Yes |
pending | Payment is processing. | Yes, granted in the meantime |
cancelled | You cancelled; no further renewals. | Yes, until the paid period ends |
halted | Auto-renew failed. | No, renew via /premium |
Check your own status any time with /payment-status, and see renewal dates with /profile. Cancellation and refunds are covered by the Refund & Cancellation Policy.