Usage limits
CraftGPT counts usage in tokens, as reported by your AI provider. (A token is a small chunk of text; a short chat reply is typically a few dozen to a few hundred.)
Limits
| Limit |
Default |
Applies to |
default-usage-limit |
25000 |
Each player without a tier permission |
usage-limit.low.max |
10000 |
Players with craftgpt.usage-limit.low |
usage-limit.medium.max |
25000 |
Players with craftgpt.usage-limit.medium |
usage-limit.high.max |
50000 |
Players with craftgpt.usage-limit.high |
global-usage-limit |
3000000 |
The whole server |
- Operators have no per-player limit, but the server-wide
global-usage-limit still stops their chats.
- A player with several tier permissions gets the highest.
- Add your own tier by adding
usage-limit.<name>.max; it creates the permission craftgpt.usage-limit.<name>.
- A chat is blocked once usage is over the limit. Because a reply is counted after it arrives, usage can go past the limit by one reply.
What counts where
| Activity |
Counts toward |
| A player chatting |
That player and the server total |
| Event reactions |
The server total only |
| Other plugins using the API |
The server total, plus the player or plugin it’s attributed to |
Automatic reset
| Key |
Default |
What it does |
usage-reset.enabled |
true |
Reset usage automatically |
usage-reset.reset-global |
true |
Also reset the server total |
usage-reset.daily |
true |
true = every day at local midnight; false = monthly |
usage-reset.day-of-month |
01 |
Day of the monthly reset (1–31; a short month uses its last day) |
Commands
/cg usage: your own meter (everyone)./cg usage plugins [page]: usage by other plugins (console or craftgpt.admin)./cg clearUsageFile: wipes all recorded usage, for every player and the server.
Placeholders
With PlaceholderAPI installed:
| Placeholder |
Shows |
%craftgpt_usage% |
Your usage |
%craftgpt_usage_limit% |
Your limit |
%craftgpt_usage_progress% |
Your progress toward it |
%craftgpt_global_total_usage% |
Server usage |
%craftgpt_global_usage_limit% |
Server limit |
%craftgpt_global_usage_progress% |
Server progress |