Files
meshcore-bot/modules/commands/advert_command.py
agessaman cc3fffeb54 feat: Add command enable/disable configuration for various commands
- Implemented a configuration option for enabling or disabling commands across multiple command classes.
- Each command now checks its enabled state before execution, improving control over command availability.
- Updated the configuration loading mechanism to retrieve the enabled state from the config file for commands like Advert, AQI, Catfact, and others.
2026-01-10 09:33:15 -08:00

116 lines
4.2 KiB
Python

#!/usr/bin/env python3
"""
Advert command for the MeshCore Bot
Handles the 'advert' command for sending flood adverts
"""
import time
from typing import Any
from .base_command import BaseCommand
from ..models import MeshMessage
class AdvertCommand(BaseCommand):
"""Handles the advert command.
This command allows users to manually trigger a flood advertisement
to help propagate their node information across the mesh network.
It enforces a strict cooldown to prevent network congestion.
"""
# Plugin metadata
name = "advert"
keywords = ['advert']
description = "Sends flood advert (DM only, 1hr cooldown)"
requires_dm = True
cooldown_seconds = 3600 # 1 hour
category = "special"
def __init__(self, bot: Any):
"""Initialize the advert command.
Args:
bot: The bot instance.
"""
super().__init__(bot)
self.advert_enabled = self.get_config_value('Advert_Command', 'enabled', fallback=True, value_type='bool')
def get_help_text(self) -> str:
"""Get help text for the advert command.
Returns:
str: The help text for this command.
"""
return self.translate('commands.advert.description')
def can_execute(self, message: MeshMessage) -> bool:
"""Check if advert command can be executed.
Verifies both the standard command cooldowns and checks against the
bot's global last advertisement time.
Args:
message: The message triggering the command.
Returns:
bool: True if the command can be executed, False otherwise.
"""
# Check if advert command is enabled
if not self.advert_enabled:
return False
# Use the base class cooldown check
if not super().can_execute(message):
return False
# Additional check for bot's last advert time (legacy support)
if hasattr(self.bot, 'last_advert_time') and self.bot.last_advert_time:
current_time = time.time()
if (current_time - self.bot.last_advert_time) < 3600: # 1 hour
return False
return True
async def execute(self, message: MeshMessage) -> bool:
"""Execute the advert command.
Sends a flood advertisement if the cooldown has passed. If on cooldown,
informs the user of the remaining time.
Args:
message: The message triggering the command.
Returns:
bool: True if executed successfully (including cooldown notice), False otherwise.
"""
try:
# Check if enough time has passed since last advert (1 hour)
current_time = time.time()
if hasattr(self.bot, 'last_advert_time') and self.bot.last_advert_time and (current_time - self.bot.last_advert_time) < 3600:
remaining_time = 3600 - (current_time - self.bot.last_advert_time)
remaining_minutes = int(remaining_time // 60)
response = self.translate('commands.advert.cooldown_active', minutes=remaining_minutes)
await self.send_response(message, response)
return True
self.logger.info(f"User {message.sender_id} requested flood advert")
# Send flood advert using meshcore.commands
await self.bot.meshcore.commands.send_advert(flood=True)
# Update last advert time
if hasattr(self.bot, 'last_advert_time'):
self.bot.last_advert_time = current_time
response = self.translate('commands.advert.success')
self.logger.info("Flood advert sent successfully via DM command")
await self.send_response(message, response)
return True
except Exception as e:
error_msg = self.translate('commands.advert.error', error=str(e))
self.logger.error(f"Error sending flood advert: {e}")
await self.send_response(message, error_msg)
return False