Generation Errors

Common errors during item generation and how to resolve them.

1. Free Tier Limit Reached

Error: FREE_TIER_LIMIT or “You’ve run out of free tokens”

Cause: You’ve reached the daily generation limit for free accounts (12 generations per day).

Solution:

• Wait until the next day (limits reset at midnight UTC)
• Upgrade to Pro for unlimited generations

2. Daily Item Limit Reached

Error: DAILY_ITEM_LIMIT_REACHED

Cause: You’ve used all your daily tokens for generation or conversion.

Solution:

• Generation and conversion have separate pools (12 each for Free tier)
• Check which pool you’ve exhausted
• Wait until tomorrow or upgrade your plan

3. Missing Required Fields

Error: “Please complete all required fields before submitting”

Cause: One or more required form fields are empty.

Solution:

• Check that you have filled in: Project Name, Namespace, and selected at least one plugin
• For specific item types, ensure required files are uploaded:
  • Sprites: At least one PNG texture
  • 3D Items: A model JSON file + textures
  • Armor: Texture files for each armor part selected
• Look for red-highlighted fields in the form

4. Batch Not Available

Error: BATCH_NOT_AVAILABLE

Cause: Batch generation (generating multiple items at once) is a Pro-only feature.

Solution:

• Generate items one at a time using the Individual mode, or
• Upgrade to Pro for batch generation access

5. File Too Large

Error: “The file is too large. Maximum size is 10MB”

Cause: An uploaded file exceeds the 10MB size limit.

Solution:

• Reduce the file size by lowering texture resolution
• For models, simplify geometry to reduce the JSON file size
• Maximum recommended texture size: 128x128 pixels

6. Unsupported File Type

Error: “Unsupported file type”

Cause: You uploaded a file format that is not accepted.

Solution:

• Textures: Must be .png files only (not .jpg, .gif, .webp)
• Models: Must be .json files
• Converter input: Must be .yml or .yaml files

7. Rate Limited

Error: RATE_LIMITED or “Too many requests”

Cause: You’re sending requests too quickly.

Solution:

• Wait a few seconds before trying again
• Avoid rapid-clicking the generate button

8. Server Error (500)

Error: “Server error. Please try again later.”

Cause: An unexpected error occurred on the backend.

Solution:

1. Wait a moment and try again
2. If the error persists, try with simpler configuration (fewer plugins, fewer items)
3. Check your input files for corruption
4. Report the issue on Discord  with details about what you were generating