Permissions and Rate Limits

Permissions and Rate Limits

Permission nodes

Permission	Default	Description
aicraft.use	true	In-game commands: /newchat, /ai, /endchat, /reopenchat
aicraft.web	true	/ailink for web UI account linking
aicraft.chats.unlimited	op	No daily cap on new chats
aicraft.chats.<n>	—	e.g. aicraft.chats.50 = 50 new chats per 24h

How rate limits work

• Limits apply to new chats created in a rolling 24-hour window — not individual messages.
• /newchat and creating a chat on the web both count.
• Reopening an existing chat with /reopenchat does not count as a new chat.

Priority

1. aicraft.chats.unlimited → no cap
2. Highest matching aicraft.chats.<n> permission
3. Fallback: rate-limits.default-chats-per-day in web.yml

LuckPerms examples

/lp group default permission set aicraft.chats.10 true
/lp group vip permission set aicraft.chats.100 true
/lp group staff permission set aicraft.chats.unlimited true

Players creating chats from the web while offline use LuckPerms cached permissions when LuckPerms is installed.