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 12 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 | $12 / 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.