mc5-api-client 1.0.20__py3-none-any.whl → 1.0.22__py3-none-any.whl

mc5_api_client/__init__.py

@@ -15,7 +15,7 @@ messaging, and more.
 
 from typing import Optional, Dict, Any
 
-__version__ = "1.0.20"
+__version__ = "1.0.22"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"
@@ -88,6 +88,37 @@ from .auth import TokenGenerator
 from .exceptions import MC5APIError, AuthenticationError, RateLimitError
 from .help import help, examples, quick_reference
 
+# Automatic Squad Management (NEW!)
+from .client import MC5Client
+
+# Add automatic squad management methods as standalone functions
+def get_my_squad_id(client=None, **kwargs):
+    """Get user's squad ID automatically."""
+    if client is None:
+        client = MC5Client(**kwargs)
+    return client.get_my_squad_id()
+
+def get_my_squad_info(client=None, **kwargs):
+    """Get user's squad information automatically."""
+    if client is None:
+        client = MC5Client(**kwargs)
+    return client.get_my_squad_info()
+
+def update_my_squad_info(client=None, **squad_kwargs):
+    """Update user's squad information automatically."""
+    client_kwargs = {k: v for k, v in squad_kwargs.items() if k in ['username', 'password', 'client_id']}
+    update_kwargs = {k: v for k, v in squad_kwargs.items() if k not in ['username', 'password', 'client_id']}
+    
+    if client is None:
+        client = MC5Client(**client_kwargs)
+    return client.update_my_squad_info(**update_kwargs)
+
+def get_my_squad_members(client=None, **kwargs):
+    """Get user's squad members automatically."""
+    if client is None:
+        client = MC5Client(**kwargs)
+    return client.get_my_squad_members()
+
 # Add MC5ApiClient as an alias for backward compatibility
 MC5ApiClient = MC5Client
 from .admin_client import (
@@ -399,9 +430,18 @@ __all__ = [
     "MC5Easy",
     "quick_connect",
     "check_my_daily_tasks",
-    "get_my_mc5_profile",
-    "find_mc5_player",
-    "get_global_id",
+    "get_server_status",
+    "get_online_players", 
+    "get_server_info",
+    "get_my_squad_id",
+    "get_my_squad_info",
+    "update_my_squad_info",
+    "get_my_squad_members",
+    "calculate_xp_for_level",
+    "get_color_value",
+    "customize_squad_theme",
+    "set_squad_level",
+    "customize_squad_complete",
     "generate_device_id",
     "create_federation_session",
     "locate_service",

mc5_api_client/client.py

@@ -1652,6 +1652,392 @@ class MC5Client(SquadBattleMixin, FederationMixin, AlertsMixin, AccountMixin, Tr
                 "timestamp": time.time()
             }
     
+    # Automatic Squad Management (NEW!)
+    
+    def get_my_squad_id(self) -> Optional[str]:
+        """
+        Automatically fetch the user's squad ID from their profile.
+        
+        This method eliminates the need to manually specify squad ID for squad operations.
+        It fetches the user's profile and extracts the squad/group ID from their groups.
+        
+        Returns:
+            Squad ID if found, None otherwise
+        """
+        try:
+            # Get user profile which contains groups information
+            profile = self.get_profile()
+            
+            if not profile:
+                return None
+                
+            # Check if user has groups
+            groups = profile.get('groups', [])
+            if not groups:
+                return None
+            
+            # Extract squad ID from groups (usually the first group is the squad)
+            # Groups can be in different formats, handle multiple cases
+            for group in groups:
+                if isinstance(group, str):
+                    # Simple string ID
+                    return group
+                elif isinstance(group, dict):
+                    # Dictionary with ID field
+                    if 'id' in group:
+                        return group['id']
+                    elif '_id' in group:
+                        return group['_id']
+                    elif 'group_id' in group:
+                        return group['group_id']
+            
+            # If no group found in the expected format, try to extract from the groups string
+            if groups and isinstance(groups[0], str):
+                return groups[0]
+                
+            return None
+            
+        except Exception as e:
+            print(f"🔴 Error fetching squad ID: {e}")
+            return None
+    
+    def get_my_squad_info(self) -> Dict[str, Any]:
+        """
+        Get complete squad information using automatically fetched squad ID.
+        
+        Returns:
+            Dictionary with squad information or error details
+        """
+        try:
+            squad_id = self.get_my_squad_id()
+            if not squad_id:
+                return {
+                    "error": "No squad found for this user",
+                    "message": "User is not in any squad",
+                    "timestamp": time.time()
+                }
+            
+            # Get squad information using the fetched ID
+            squad_info = self.get_clan_settings(squad_id)
+            
+            if squad_info:
+                squad_info['auto_fetched_squad_id'] = squad_id
+                squad_info['fetch_method'] = 'automatic'
+                return squad_info
+            else:
+                return {
+                    "error": "Failed to fetch squad details",
+                    "squad_id": squad_id,
+                    "message": "Squad ID found but could not fetch details",
+                    "timestamp": time.time()
+                }
+                
+        except Exception as e:
+            return {
+                "error": str(e),
+                "message": "Failed to get squad information",
+                "timestamp": time.time()
+            }
+    
+    def update_my_squad_info(self, **kwargs) -> Dict[str, Any]:
+        """
+        Update squad information using automatically fetched squad ID.
+        
+        This is a convenience method that combines get_my_squad_id() and update_clan_settings().
+        Users don't need to specify squad ID - it's automatically fetched from their profile.
+        
+        Args:
+            **kwargs: Squad settings to update (same as update_clan_settings)
+                - name: Squad name
+                - description: Squad description  
+                - rating: Squad rating
+                - min_join_value: Minimum join value
+                - logo: Squad logo ID
+                - logo_clr_prim: Primary logo color
+                - logo_clr_sec: Secondary logo color
+        
+        Returns:
+            Dictionary with update result or error details
+        """
+        try:
+            squad_id = self.get_my_squad_id()
+            if not squad_id:
+                return {
+                    "error": "No squad found for this user",
+                    "message": "Cannot update squad - user is not in any squad",
+                    "timestamp": time.time()
+                }
+            
+            # Update squad using the fetched ID
+            result = self.update_clan_settings(squad_id, **kwargs)
+            
+            if result:
+                result['auto_fetched_squad_id'] = squad_id
+                result['update_method'] = 'automatic'
+                return result
+            else:
+                return {
+                    "error": "Failed to update squad",
+                    "squad_id": squad_id,
+                    "message": "Squad ID found but update failed",
+                    "timestamp": time.time()
+                }
+                
+        except Exception as e:
+            return {
+                "error": str(e),
+                "message": "Failed to update squad information",
+                "timestamp": time.time()
+            }
+    
+    def get_my_squad_members(self) -> Dict[str, Any]:
+        """
+        Get squad members using automatically fetched squad ID.
+        
+        Returns:
+            Dictionary with squad members or error details
+        """
+        try:
+            squad_id = self.get_my_squad_id()
+            if not squad_id:
+                return {
+                    "error": "No squad found for this user",
+                    "message": "Cannot get squad members - user is not in any squad",
+                    "timestamp": time.time()
+                }
+            
+            # Get squad members using the fetched ID
+            members = self.get_clan_members(squad_id)
+            
+            if members:
+                return {
+                    "squad_id": squad_id,
+                    "members": members,
+                    "member_count": len(members) if isinstance(members, list) else 0,
+                    "fetch_method": "automatic",
+                    "timestamp": time.time()
+                }
+            else:
+                return {
+                    "error": "Failed to fetch squad members",
+                    "squad_id": squad_id,
+                    "message": "Squad ID found but could not fetch members",
+                    "timestamp": time.time()
+                }
+                
+        except Exception as e:
+            return {
+                "error": str(e),
+                "message": "Failed to get squad members",
+                "timestamp": time.time()
+            }
+    
+    # Squad Customization Helpers (NEW!)
+    
+    def calculate_xp_for_level(self, level: int) -> int:
+        """
+        Calculate XP required for a specific squad level.
+        
+        Level System:
+        - Level 1: 1000 XP
+        - Level 2: 2000 XP
+        - ...
+        - Level 10: 10000 XP (maximum)
+        
+        Args:
+            level: Desired level (1-10)
+            
+        Returns:
+            XP value for the level
+        """
+        if level < 1:
+            level = 1
+        elif level > 10:
+            level = 10
+        
+        return level * 1000
+    
+    def get_color_value(self, color_name: str) -> str:
+        """
+        Get color value for common colors.
+        
+        Args:
+            color_name: Name of the color
+            
+        Returns:
+            Color value in decimal format
+        """
+        colors = {
+            'black': '0',
+            'white': '16777215',
+            'red': '16711680',
+            'green': '65280',
+            'blue': '255',
+            'yellow': '16776960',
+            'purple': '16711808',
+            'orange': '16753920',
+            'pink': '16761035',
+            'cyan': '65535',
+            'lime': '65280',
+            'navy': '128',
+            'gold': '16766720',
+            'silver': '12632256',
+            'maroon': '8388608',
+            'teal': '32768',
+            'olive': '8421376'
+        }
+        
+        return colors.get(color_name.lower(), '0')
+    
+    def customize_squad_theme(self, theme_name: str, squad_name: str = None) -> Dict[str, Any]:
+        """
+        Apply a predefined color theme to your squad.
+        
+        Args:
+            theme_name: Name of the theme ('dark', 'fire', 'ice', 'nature')
+            squad_name: Optional custom squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        themes = {
+            'dark': {
+                '_logo_clr_prim': self.get_color_value('black'),
+                '_logo_clr_sec': self.get_color_value('white'),
+                'name': squad_name or 'Dark Knights'
+            },
+            'fire': {
+                '_logo_clr_prim': self.get_color_value('red'),
+                '_logo_clr_sec': self.get_color_value('orange'),
+                'name': squad_name or 'Fire Warriors'
+            },
+            'ice': {
+                '_logo_clr_prim': self.get_color_value('blue'),
+                '_logo_clr_sec': self.get_color_value('cyan'),
+                'name': squad_name or 'Ice Legion'
+            },
+            'nature': {
+                '_logo_clr_prim': self.get_color_value('green'),
+                '_logo_clr_sec': self.get_color_value('lime'),
+                'name': squad_name or 'Nature Guardians'
+            }
+        }
+        
+        theme = themes.get(theme_name.lower())
+        if not theme:
+            return {
+                "error": f"Unknown theme: {theme_name}",
+                "available_themes": list(themes.keys()),
+                "timestamp": time.time()
+            }
+        
+        return self.update_my_squad_info(**theme)
+    
+    def set_squad_level(self, level: int, squad_name: str = None) -> Dict[str, Any]:
+        """
+        Set squad to a specific level with appropriate settings.
+        
+        Args:
+            level: Desired level (1-10)
+            squad_name: Optional custom squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        if level < 1 or level > 10:
+            return {
+                "error": "Level must be between 1 and 10",
+                "timestamp": time.time()
+            }
+        
+        updates = {
+            "name": squad_name or f"Level {level} Squad",
+            "_xp": self.calculate_xp_for_level(level),
+            "rating": level * 500,
+            "_min_join_value": level * 100,
+            "member_limit": 20 + (level * 5),
+            "description": f"Elite squad at Level {level}!"
+        }
+        
+        return self.update_my_squad_info(**updates)
+    
+    def customize_squad_complete(self, **kwargs) -> Dict[str, Any]:
+        """
+        Customize squad with any parameters and validation.
+        
+        Args:
+            **kwargs: Any squad parameters to update
+            
+        Available parameters:
+        - name: Squad name
+        - description: Squad description
+        - rating: Squad rating
+        - score: Squad score
+        - member_limit: Maximum members (1-300)
+        - membership: Membership type ('open' or 'owner_approved')
+        - _logo: Logo ID
+        - _logo_clr_prim: Primary color (RGB decimal 0-16777215)
+        - _logo_clr_sec: Secondary color (RGB decimal 0-16777215)
+        - _min_join_value: Minimum join value
+        - _xp: Squad XP (1000-10000, determines level)
+        - _killsig_id: Kill signature ID
+        - currency: Squad currency
+        - active_clan_label: Active clan label
+        - active_clan_threshold: Active clan threshold
+        
+        Returns:
+            Dictionary with update result or error details
+        """
+        # Validate data
+        errors = []
+        
+        # Validate XP/Level
+        if '_xp' in kwargs:
+            try:
+                xp = int(kwargs['_xp'])
+                if xp < 1000 or xp > 10000:
+                    errors.append("XP must be between 1000 (Level 1) and 10000 (Level 10)")
+            except ValueError:
+                errors.append("_xp must be a valid number")
+        
+        # Validate member limit
+        if 'member_limit' in kwargs:
+            try:
+                limit = int(kwargs['member_limit'])
+                if limit < 1 or limit > 300:
+                    errors.append("Member limit must be between 1 and 300")
+            except ValueError:
+                errors.append("member_limit must be a valid number")
+        
+        # Validate colors
+        for color_key in ['_logo_clr_prim', '_logo_clr_sec']:
+            if color_key in kwargs:
+                try:
+                    color = int(kwargs[color_key])
+                    if color < 0 or color > 16777215:  # RGB max value
+                        errors.append(f"{color_key} must be between 0 and 16777215")
+                except ValueError:
+                    errors.append(f"{color_key} must be a valid number")
+        
+        # Validate rating
+        if 'rating' in kwargs:
+            try:
+                rating = int(kwargs['rating'])
+                if rating < 0 or rating > 99999:
+                    errors.append("Rating must be between 0 and 99999")
+            except ValueError:
+                errors.append("rating must be a valid number")
+        
+        if errors:
+            return {
+                "error": "Validation failed",
+                "validation_errors": errors,
+                "timestamp": time.time()
+            }
+        
+        # Apply updates
+        return self.update_my_squad_info(**kwargs)
+    
     # Events API
     
     def get_events(self, event_type: str = None, status: str = None) -> List[Dict[str, Any]]:

{mc5_api_client-1.0.20.dist-info → mc5_api_client-1.0.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.20
+Version: 1.0.22
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -81,22 +81,27 @@ Dynamic: requires-python
 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Author](https://img.shields.io/badge/author-Chizoba-orange.svg)](mailto:chizoba2026@hotmail.com)
-[![PyPI Version](https://img.shields.io/badge/pypi-1.0.18-blue.svg)](https://pypi.org/project/mc5-api-client/)
+[![PyPI Version](https://img.shields.io/badge/pypi-1.0.21-blue.svg)](https://pypi.org/project/mc5-api-client/)
 [![Production Ready](https://img.shields.io/badge/production-ready-brightgreen.svg)](https://pypi.org/project/mc5-api-client/)
 
 Hey there! 👋 Welcome to the **Modern Combat 5 API Client** - Comprehensive Python library for interacting with Modern Combat 5 game servers
 
-## ✨ **New in v1.0.18: Super Easy Interface & Complete Game Management!**
-
-- 🎯 **NEW: MC5Easy** - Super simple one-line functions for everyday tasks
-- 🚀 **NEW: One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
-- 📝 **NEW: Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
-- 🔧 **NEW: Environment Variables** - Secure credential management with `MC5_USERNAME` and `MC5_PASSWORD`
-- 🌐 **NEW: Service Location** - Dynamic MC5 service endpoint discovery
-- 🎮 **NEW: Federation Sessions** - Complete game launch preparation
-- 🌍 **NEW: Global ID Management** - Device tracking and identification
-- 🔗 **NEW: Connection Monitoring** - Service health and status tracking
-- 🏠 **NEW: Room Discovery** - Find available game rooms
+## ✨ **New in v1.0.21: Revolutionary Automatic Squad Management!**
+
+- 🎮 **REVOLUTIONARY: Automatic Squad Management** - No more manual squad IDs! Automatically detect and manage your squad from your profile
+- 🚀 **Zero Configuration Squad Operations** - `get_my_squad_info()`, `update_my_squad_info()`, `get_my_squad_members()` - all work without squad IDs
+- 🔄 **Squad Switching Support** - Automatically adapts when you change squads
+- 🛡️ **Intelligent Error Handling** - Graceful handling for users without squads
+- 📱 **Perfect for Mobile/Web Apps** - Standalone functions work without client instances
+- 🎯 **MC5Easy** - Super simple one-line functions for everyday tasks
+- 🚀 **One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
+- 📝 **Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
+- 🔧 **Environment Variables** - Secure credential management with `MC5_USERNAME` and `MC5_PASSWORD`
+- 🌐 **Service Location** - Dynamic MC5 service endpoint discovery
+- 🎮 **Federation Sessions** - Complete game launch preparation
+- 🌍 **Global ID Management** - Device tracking and identification
+- 🔗 **Connection Monitoring** - Service health and status tracking
+- 🏠 **Room Discovery** - Find available game rooms
 - 🏰 **PC Storage Admin** - Complete squad management with storage scopes
 - 🔧 **StorageAdminMixin** - Core storage functionality for advanced operations
 - 👤 **System Account Access** - 5 working system accounts discovered
@@ -140,12 +145,84 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 
 ## 🚀 Installation
 
-### 🎉 MC5 API Client v1.0.18 - Super Easy Interface & Clean API!
+### 🎉 MC5 API Client v1.0.21 - Revolutionary Automatic Squad Management!
 
 ```bash
-pip install mc5_api_client==1.0.20
+pip install mc5_api_client==1.0.21
 ```
 
+## 🎮 **🚀 REVOLUTIONARY FEATURE: Automatic Squad Management**
+
+### **🎯 The Problem We Solved:**
+Previously, users had to manually specify squad IDs for squad operations:
+```python
+# ❌ OLD METHOD - Complex and error-prone
+squad_id = "d1e7437c-0156-11f1-ad07-b8ca3a709038"  # Hard to remember!
+squad_info = client.get_clan_settings(squad_id)     # Manual ID required
+```
+
+### **✅ Our Solution - Automatic Detection:**
+```python
+# ✅ NEW METHOD - Simple and automatic
+squad_info = client.get_my_squad_info()  # Auto-fetched from profile!
+```
+
+### **🎮 Key Benefits:**
+- 🎯 **No Squad ID Memorization** - Automatically detected from your profile
+- 🔄 **Squad Switching Support** - Works when you change squads
+- 🛡️ **Intelligent Error Handling** - Graceful handling for users without squads
+- 📱 **Perfect for Mobile/Web Apps** - Standalone functions work without client instances
+- 🚀 **Zero Configuration** - Just call the methods, no setup required
+
+### **🔧 Available Methods:**
+
+#### **Client Methods:**
+```python
+from mc5_api_client import MC5Client
+
+client = MC5Client(username, password)
+
+# Get squad ID automatically
+squad_id = client.get_my_squad_id()
+
+# Get complete squad information
+squad_info = client.get_my_squad_info()
+
+# Get squad members
+members = client.get_my_squad_members()
+
+# Update squad (no squad ID needed!)
+client.update_my_squad_info(
+    name="Elite Squad",
+    description="Best squad in MC5!",
+    rating=2000
+)
+```
+
+#### **Standalone Functions:**
+```python
+from mc5_api_client import get_my_squad_info, update_my_squad_info
+
+# Work without creating a client!
+squad_info = get_my_squad_info(
+    username="your_credential",
+    password="your_password"
+)
+
+# Update squad without client
+result = update_my_squad_info(
+    username="your_credential",
+    password="your_password",
+    name="New Squad Name"
+)
+```
+
+### **🔄 Real-World Impact:**
+- **10x easier** squad management
+- **Zero configuration** required
+- **Automatic adaptation** to squad changes
+- **Perfect for** modern applications
+
 ## 🎯 **Usage Examples**
 
 ### **🎮 Basic Usage (MC5Client)**
@@ -245,6 +322,179 @@ with MC5Easy(username, password) as mc5:
     print(f"Device: {device_info}")
 ```
 
+### **🎮 Automatic Squad Management (REVOLUTIONARY!)**
+```python
+from mc5_api_client import MC5Client, get_my_squad_info, update_my_squad_info
+
+# Initialize client
+client = MC5Client(username, password)
+
+# 🚀 NO MORE SQUAD ID NEEDED! Automatically detected from your profile!
+
+# Get your squad information automatically
+squad_info = client.get_my_squad_info()
+print(f"Squad Name: {squad_info['name']}")
+print(f"Squad Rating: {squad_info['rating']}")
+print(f"Description: {squad_info['description']}")
+
+# Get squad members automatically
+members = client.get_my_squad_members()
+print(f"Member Count: {members['member_count']}")
+for member in members['members'][:3]:
+    print(f"  - {member['name']}")
+
+# Update squad automatically (no squad ID required!)
+client.update_my_squad_info(
+    name="Elite Squad",
+    description="Best squad in MC5!",
+    rating=2000,
+    min_join_value=1000
+)
+
+# 🔄 Works even when you switch squads!
+# The methods automatically detect your current squad
+```
+
+### **🚀 Standalone Squad Management (No Client Required!)**
+```python
+from mc5_api_client import get_my_squad_id, get_my_squad_info, update_my_squad_info
+
+# Get squad ID without creating client
+squad_id = get_my_squad_id(
+    username="your_credential",
+    password="your_password"
+)
+print(f"Your Squad ID: {squad_id}")
+
+# Get squad info without creating client
+squad_info = get_my_squad_info(
+    username="your_credential",
+    password="your_password"
+)
+print(f"Squad: {squad_info['name']}")
+
+# Update squad without creating client
+result = update_my_squad_info(
+    username="your_credential",
+    password="your_password",
+    name="New Squad Name",
+    description="Updated description"
+)
+print(f"Update Result: {result}")
+```
+
+### **🔄 Traditional vs Automatic Squad Management**
+```python
+# ❌ OLD METHOD - Manual squad ID required
+squad_id = "d1e7437c-0156-11f1-ad07-b8ca3a709038"  # Hard to remember!
+squad_info = client.get_clan_settings(squad_id)     # Manual ID required
+members = client.get_clan_members(squad_id)          # Manual ID required
+client.update_clan_settings(squad_id, name="New")    # Manual ID required
+
+# ✅ NEW METHOD - Automatic detection
+squad_info = client.get_my_squad_info()           # Auto-fetched!
+members = client.get_my_squad_members()           # Auto-fetched!
+client.update_my_squad_info(name="New")           # Auto-fetched!
+
+# Benefits:
+# 🎯 No squad ID memorization
+# 🔄 Works when switching squads
+# 🛡️ Error handling for users without squads
+# 🚀 Simpler API for everyday use
+```
+
+### **🎨 Complete Squad Customization (NEW!)**
+```python
+from mc5_api_client import MC5Client
+
+client = MC5Client(username, password)
+
+# 🎯 Set squad to specific level (1-10)
+client.set_squad_level(8, "Level 8 Elite")
+# Automatically sets XP, rating, member limit, etc.
+
+# 🎨 Apply color themes
+client.customize_squad_theme('fire', 'Fire Warriors')  # Red/Orange theme
+client.customize_squad_theme('ice', 'Ice Legion')       # Blue/Cyan theme
+client.customize_squad_theme('dark', 'Dark Knights')   # Black/White theme
+client.customize_squad_theme('nature', 'Nature Guardians') # Green/Lime theme
+
+# 🔧 Complete customization with validation
+client.customize_squad_complete(
+    name="452e55e84897+",
+    description="Professional squad with active members!",
+    rating=3573,
+    score=5200,
+    member_limit=300,
+    membership="owner_approved",
+    _logo="1",
+    _logo_clr_prim=client.get_color_value("red"),     # Red color
+    _logo_clr_sec=client.get_color_value("white"),    # White color
+    _min_join_value=996699,
+    _xp=client.calculate_xp_for_level(9),             # Level 9 = 9000 XP
+    _killsig_id="default_killsig_01",
+    currency="10000",
+    active_clan_label="true",
+    active_clan_threshold="50"
+)
+
+# 🎯 Helper functions
+xp = client.calculate_xp_for_level(5)  # Returns 5000
+color = client.get_color_value('blue')  # Returns '255'
+```
+
+### **📊 Squad Parameters You Can Customize:**
+```python
+# 📝 Basic Information
+name: "Your Squad Name"
+description: "Your squad description"
+rating: 5000
+score: 5200
+
+# 👥 Member Settings
+member_limit: 300                    # 1-300 members
+membership: "owner_approved"          # or "open"
+_min_join_value: 1000               # Minimum score to join
+
+# 🎨 Visual Customization
+_logo: "1"                           # Logo ID
+_logo_clr_prim: "16711680"           # Primary color (RGB decimal)
+_logo_clr_sec: "16777215"            # Secondary color (RGB decimal)
+# Colors: black=0, white=16777215, red=16711680, blue=255, green=65280
+
+# ⭐ Level & Progress
+_xp: "5000"                          # Level 5 (1000-10000, Level 1-10)
+# Level 1: 1000, Level 2: 2000, ..., Level 10: 10000
+
+# 💰 Economy
+currency: "10000"
+_killsig_id: "default_killsig_01"
+
+# 🏃 Activity Settings
+active_clan_label: "true"
+active_clan_threshold: "50"
+```
+
+### **🎮 Quick Customization Examples:**
+```python
+# 🚀 One-line level upgrades
+client.set_squad_level(10)                    # Max level squad
+client.set_squad_level(5, "Level 5 Warriors")  # Custom name
+
+# 🎨 One-line theme applications
+client.customize_squad_theme('fire')            # Fire theme
+client.customize_squad_theme('ice', 'Ice Squad') # Custom name
+
+# 🔧 Complete professional setup
+client.customize_squad_complete(
+    name="Elite Squad",
+    rating=8000,
+    _xp=client.calculate_xp_for_level(8),
+    _logo_clr_prim=client.get_color_value('purple'),
+    member_limit=100
+)
+```
+
 ## 📱 **Run Examples:** Completed!
 
 **🎯 Super Easy Interface (NEW in v1.0.18):**
@@ -329,8 +579,11 @@ python examples/service_location_example.py
 # Game launch and federation sessions:
 python examples/game_launch_example.py
 
-# Device ID management:
-python examples/device_id_example.py
+# Automatic squad management:
+python examples/automatic_squad_management.py
+
+# Complete squad customization:
+python examples/complete_squad_customization.py
 
 # Authentication examples:
 python examples/authentication_example.py

{mc5_api_client-1.0.20.dist-info → mc5_api_client-1.0.22.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mc5_api_client/__init__.py,sha256=lxGygRXrG6aUTZ_Em_TLyMzMxR7ylTXgXOhA5OEXfnM,11942
+mc5_api_client/__init__.py,sha256=izYE-Hb3sfF08lXzwZ8LwphUFJveyiQoLbU_k0yBGiI,13363
 mc5_api_client/account.py,sha256=EmydXCsCXaKqMw21oVttQfYuDl50pa2dwhcTeHtnxbQ,14396
 mc5_api_client/account_quick.py,sha256=t4ki4ujYENmcnd_004f0pO9SPxPyCllz4WHpBG9wNbo,10458
 mc5_api_client/admin_client.py,sha256=527aavolxVhY2M5ceFxVbbE5YTczU9Z86Fdt1UzdRZM,15220
@@ -6,7 +6,7 @@ mc5_api_client/alerts.py,sha256=zW-cEwSSShuHkGxTBQaS8Ynf1a0hh5RMQ0G3WC_ajI0,1322
 mc5_api_client/alerts_quick.py,sha256=D1j0RiHteYqoAgc4KYqTxYG1Hkud3b-xWRV_VOUEnY0,7946
 mc5_api_client/auth.py,sha256=z8vmyQIHUdAzk0pUyKCesT8gTv4jboLIFGBxAu1v_-8,13396
 mc5_api_client/cli.py,sha256=6xciRjWkUMOxgxlbDsoOiHRuirXPy7uc9WURXPKmgGc,17255
-mc5_api_client/client.py,sha256=EWL0IWiP9mwr9GTnnzWwTKHZUPe2LXaY7YxzjKTDjWM,112524
+mc5_api_client/client.py,sha256=IDP8c14f0u0k1rvUNqh7_3VmGBltv64GClLBkusNSJI,126182
 mc5_api_client/debug.py,sha256=524vNCE7jM_KP5JM81-3eI2cmFBBA-Hf7Uy0cIL75W0,8240
 mc5_api_client/easy_mc5.py,sha256=kfjOJMW-VRAZcXEF1yHiGsACgjb-ZjXGuw1U_gepSQY,24202
 mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
@@ -24,9 +24,9 @@ mc5_api_client/storage_admin.py,sha256=l-nwskbpa3KpeIoWcwVRicgBSvrTvQ5aE2QU_e366
 mc5_api_client/telemetry.py,sha256=k8qOimPg-AKsnMclIgeqYCJ_97j2pWyiN7Lg80D4sKo,13246
 mc5_api_client/transfer.py,sha256=-pln70360mo4cKBQIUzp_wt9ce1Cr4YA6aJDFPKEjzQ,14381
 mc5_api_client/transfer_quick.py,sha256=HhRbp4FVzFwuzHDcqOyYiVjeVEIfgezlWd8SN6sh874,11310
-mc5_api_client-1.0.20.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.20.dist-info/METADATA,sha256=jcN6JTeojDPA5C_0U9l1_bCcwKNwkPNbf-1s17Uci3w,83121
-mc5_api_client-1.0.20.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mc5_api_client-1.0.20.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.20.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.20.dist-info/RECORD,,
+mc5_api_client-1.0.22.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.22.dist-info/METADATA,sha256=Twytv04RCN7zec91J7x0SgLbAlUL9WpYkGBbJF0LJFY,91487
+mc5_api_client-1.0.22.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.22.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.22.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.22.dist-info/RECORD,,