Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xmistt/rebootpy/llms.txt
Use this file to discover all available pages before exploring further.
All command-related exceptions inherit from CommandError, which itself inherits from rebootpy.FortniteException. These exceptions are handled in a special way as they are caught and passed into the event_command_error event.
Base Exceptions
CommandError
class CommandError(FortniteException)
Bot, event_command_error.
class UserInputError(CommandError)
CommandNotFound
class CommandNotFound(CommandError)
MissingRequiredArgument
class MissingRequiredArgument(UserInputError)
param (inspect.Parameter): The argument that is missing.
TooManyArguments
class TooManyArguments(UserInputError)
Command.ignore_extra attribute was not set to True.
BadArgument
class BadArgument(UserInputError)
@bot.event
async def event_command_error(ctx, error):
if isinstance(error, commands.BadArgument):
await ctx.send(f'Invalid argument: {error}')
BadUnionArgument
class BadUnionArgument(UserInputError)
typing.Union converter fails for all its associated types.
Attributes:
param (inspect.Parameter): The parameter that failed being converted.converters (Tuple[Type, …]): A tuple of converters attempted in conversion, in order of failure.errors (List[CommandError]): A list of errors that were caught from failing the conversion.
Check Failures
CheckFailure
class CheckFailure(UserInputError)
Command.checks have failed.
CheckAnyFailure
class CheckAnyFailure(CheckFailure)
check_any() fail.
Attributes:
errors (List[CheckFailure]): A list of errors that were caught during execution.checks (List[Callable[[Context], bool]]): A list of check predicates that failed.
PrivateMessageOnly
class PrivateMessageOnly(CheckFailure)
@dm_only() decorator.
PartyMessageOnly
class PartyMessageOnly(CheckFailure)
@party_only() decorator.
NotOwner
class NotOwner(CheckFailure)
@is_owner() decorator.
Command Execution Errors
DisabledCommand
class DisabledCommand(CommandError)
CommandInvokeError
class CommandInvokeError(CommandError)
original (Exception): The original exception that was raised. You can also get this via the __cause__ attribute.
Example:
@bot.event
async def event_command_error(ctx, error):
if isinstance(error, commands.CommandInvokeError):
await ctx.send(f'Command failed: {error.original}')
CommandOnCooldown
class CommandOnCooldown(CommandError)
cooldown (Cooldown): A class with attributes rate, per, and type similar to the @cooldown decorator.retry_after (float): The amount of seconds to wait before you can retry again.
Example:
@bot.event
async def event_command_error(ctx, error):
if isinstance(error, commands.CommandOnCooldown):
await ctx.send(f'Command on cooldown. Retry in {error.retry_after:.2f}s')
MaxConcurrencyReached
class MaxConcurrencyReached(CommandError)
number (int): The maximum number of concurrent invokers allowed.per (BucketType): The bucket type passed to the @max_concurrency decorator.
Conversion Errors
ConversionError
class ConversionError(CommandError)
converter (rebootpy.ext.commands.Converter): The converter that failed.original (Exception): The original exception that was raised. You can also get this via the __cause__ attribute.
Argument Parsing Errors
ArgumentParsingError
class ArgumentParsingError(UserInputError)
UnexpectedQuoteError
class UnexpectedQuoteError(ArgumentParsingError)
quote (str): The quote mark that was found inside the non-quoted string.
InvalidEndOfQuotedStringError
class InvalidEndOfQuotedStringError(ArgumentParsingError)
char (str): The character found instead of the expected string.
ExpectedClosingQuoteError
class ExpectedClosingQuoteError(ArgumentParsingError)
close_quote (str): The quote character expected.
Extension Errors
ExtensionError
class ExtensionError(FortniteException)
name (str): The extension that had an error.
ExtensionAlreadyLoaded
class ExtensionAlreadyLoaded(ExtensionError)
ExtensionNotLoaded
class ExtensionNotLoaded(ExtensionError)
ExtensionMissingEntryPoint
class ExtensionMissingEntryPoint(ExtensionError)
extension_setup entry point function.
ExtensionFailed
class ExtensionFailed(ExtensionError)
extension_setup entry point.
Attributes:
name (str): The extension that had the error.original (Exception): The original exception that was raised. You can also get this via the __cause__ attribute.
ExtensionNotFound
class ExtensionNotFound(ExtensionError)
name (str): The extension that had the error.
Error Handling Example
@bot.event
async def event_command_error(ctx, error):
"""Global error handler for all commands"""
# Ignore commands with local error handlers
if hasattr(ctx.command, 'error_handler'):
return
# Get the original exception if it's wrapped
error = getattr(error, 'original', error)
# Handle specific errors
if isinstance(error, commands.CommandNotFound):
return # Silently ignore
elif isinstance(error, commands.MissingRequiredArgument):
await ctx.send(f'Missing required argument: {error.param.name}')
elif isinstance(error, commands.BadArgument):
await ctx.send(f'Bad argument: {error}')
elif isinstance(error, commands.CheckFailure):
await ctx.send('You do not have permission to use this command.')
elif isinstance(error, commands.CommandOnCooldown):
await ctx.send(f'This command is on cooldown. Try again in {error.retry_after:.1f}s')
elif isinstance(error, commands.DisabledCommand):
await ctx.send('This command is disabled.')
else:
# Log unexpected errors
print(f'Unexpected error: {error}')
await ctx.send('An error occurred while executing the command.')
# Command-specific error handler
@bot.command()
async def divide(ctx, a: int, b: int):
"""Divides two numbers"""
result = a / b
await ctx.send(f'{a} / {b} = {result}')
@divide.error
async def divide_error(ctx, error):
if isinstance(error, commands.BadArgument):
await ctx.send('Please provide valid integers.')
elif isinstance(error, commands.CommandInvokeError):
if isinstance(error.original, ZeroDivisionError):
await ctx.send('Cannot divide by zero!')