Error Handling

Set Variable operations involving buckets can sometimes fail; this page will guide on how to handle it.

Status Variable

In Set Variable actions that deal with loading/unloading buckets, you can supply a variable to hold the result of the operation (success, or some error code).

By checking this variable, you can create error handling logic. You generally do not need to handle each error type individually; often you’ll just want to handle success vs failure. The codes exist to help you debug, and to allow for automatic retries on certain errors.

Error Codes

Error	Actions	Description	Recommended Handling
active_lock	Load	Another plot has the lock for this bucket.	If you expect the other plot to release the lock shortly, you can retry. If not, check the other plot to be sure you’re unloading the bucket properly. If only one plot can access the namespace, this error will never occur.
bucket_key_too_long	Load	Attempted to create a new bucket with a name that is too long.	Use a shorter bucket name.
bucket_not_loaded	Save	Attempted to save a bucket that isn’t currently loaded.	Verify that you have the correct bucket name.
bucket_too_much_data	Save	The combined size of the vars in the bucket exceeds the limit.	Consider using multiple buckets.
namespace_bucket_limit_reached	Load	Your namespace has the maximum number of buckets.	Purge your buckets using the /namespace sub-commands or request a limit increase here
namespace_too_much_data	Save	The combined size of the vars in the namespace exceeds the limit.	Delete unused data or request a limit increase.
unknown_namespace	Load, Get Values	There’s no namespace with that alias on the plot.	Verify that you’ve entered the correct namespace alias.
no_access	Load, Get Values	Your plot is not whitelisted for this namespace.	Add the plot to the namespace’s whitelist with /namespace whitelist add [plot]
loaded_buckets_limit_reached	Load	Your plot has the maximum number of buckets loaded.	Ensure you’re properly unloading buckets when you no longer need to access them.
selected_more_than_one_player	Load, Save, Unload, Get Values	Multi-selections are not supported with bucket variables.	Use Select Object to ensure you only have one player selected.
internal	Load, Save, Unload, Get Values	Internal server error.	Retry the action after a delay. If you see this persistently, report the issue to DF staff.
throttled	Load, Save, Unload, Get Values	Too many requests.	Retry the action after a delay. If you see this persistently, consider structuring your code to do less frequent bucket loads/saves.