mc5-api-client 1.0.22__tar.gz → 1.0.23__tar.gz

{mc5_api_client-1.0.22/src/mc5_api_client.egg-info → mc5_api_client-1.0.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.22
+Version: 1.0.23
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -409,38 +409,37 @@ 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.
+# 🚀 SUPER SIMPLE - One-line customizations!
+client.quick_set_name("My Awesome Squad")           # Change name
+client.quick_set_level(5)                              # Set to Level 5
+client.quick_set_colors("red", "white")               # Red/White colors
+client.quick_set_member_limit(50)                     # Set member limit
+client.quick_set_currency(10000)                       # Set currency
 
-# 🎨 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
+# 🎯 QUICK SETUPS - Professional results in one line!
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional squad
+client.quick_setup_gaming_squad("Gaming Legends", "fire")       # Gaming squad with theme
 
-# 🔧 Complete customization with validation
+# 🎨 THEMES - Beautiful colors instantly
+client.customize_squad_theme('fire')                    # Fire theme
+client.customize_squad_theme('ice')                     # Ice theme
+client.customize_squad_theme('dark')                    # Dark theme
+client.customize_squad_theme('nature')                  # Nature theme
+
+# ⭐ LEVEL SYSTEM - Automatic XP calculation
+client.set_squad_level(10, "Max Level Squad")          # Level 10 (max)
+# Level 1: 1000 XP, Level 5: 5000 XP, Level 10: 10000 XP
+
+# 🔧 COMPLETE CUSTOMIZATION - Full control 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"
+    _logo_clr_prim=client.get_color_value("red"),
+    _xp=client.calculate_xp_for_level(9),
+    currency="10000"
 )
-
-# 🎯 Helper functions
-xp = client.calculate_xp_for_level(5)  # Returns 5000
-color = client.get_color_value('blue')  # Returns '255'
 ```
 
 ### **📊 Squad Parameters You Can Customize:**
@@ -475,11 +474,36 @@ active_clan_label: "true"
 active_clan_threshold: "50"
 ```
 
-### **🎮 Quick Customization Examples:**
+### **🚀 Quick Functions - EASIEST WAY TO CUSTOMIZE!**
+```python
+# 📝 BASIC QUICK FUNCTIONS
+client.quick_set_name("My Squad")              # Change name
+client.quick_set_rating(5000)                    # Set rating
+client.quick_set_member_limit(50)               # Set member limit
+client.quick_set_currency(10000)                  # Set currency
+
+# � COLOR QUICK FUNCTIONS
+client.quick_set_colors("red")                    # Red theme
+client.quick_set_colors("blue", "white")           # Blue/White theme
+client.quick_set_colors("black", "gold")           # Black/Gold theme
+
+# ⭐ LEVEL QUICK FUNCTIONS
+client.quick_set_level(5)                         # Set to Level 5
+client.quick_set_level(10, "Max Level")           # Set to Level 10
+
+# 🏆 PROFESSIONAL QUICK SETUPS
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional setup
+client.quick_setup_gaming_squad("Gaming Squad", "fire")       # Gaming setup
+
+# 🔄 RESET QUICK FUNCTION
+client.quick_reset_to_defaults()                    # Reset to defaults
+```
+
+### **�🎮 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
+client.quick_set_level(10)                    # Max level squad
+client.quick_set_level(5, "Level 5 Warriors")  # Custom name
 
 # 🎨 One-line theme applications
 client.customize_squad_theme('fire')            # Fire theme
@@ -585,6 +609,12 @@ python examples/automatic_squad_management.py
 # Complete squad customization:
 python examples/complete_squad_customization.py
 
+# Quick squad customization:
+python examples/squad_customization_quick.py
+
+# Squad quick start (super simple):
+python examples/squad_quick_start.py
+
 # Authentication examples:
 python examples/authentication_example.py
 

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/README.md

@@ -331,38 +331,37 @@ 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
+# 🚀 SUPER SIMPLE - One-line customizations!
+client.quick_set_name("My Awesome Squad")           # Change name
+client.quick_set_level(5)                              # Set to Level 5
+client.quick_set_colors("red", "white")               # Red/White colors
+client.quick_set_member_limit(50)                     # Set member limit
+client.quick_set_currency(10000)                       # Set currency
+
+# 🎯 QUICK SETUPS - Professional results in one line!
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional squad
+client.quick_setup_gaming_squad("Gaming Legends", "fire")       # Gaming squad with theme
+
+# 🎨 THEMES - Beautiful colors instantly
+client.customize_squad_theme('fire')                    # Fire theme
+client.customize_squad_theme('ice')                     # Ice theme
+client.customize_squad_theme('dark')                    # Dark theme
+client.customize_squad_theme('nature')                  # Nature theme
+
+# ⭐ LEVEL SYSTEM - Automatic XP calculation
+client.set_squad_level(10, "Max Level Squad")          # Level 10 (max)
+# Level 1: 1000 XP, Level 5: 5000 XP, Level 10: 10000 XP
+
+# 🔧 COMPLETE CUSTOMIZATION - Full control 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"
+    _logo_clr_prim=client.get_color_value("red"),
+    _xp=client.calculate_xp_for_level(9),
+    currency="10000"
 )
-
-# 🎯 Helper functions
-xp = client.calculate_xp_for_level(5)  # Returns 5000
-color = client.get_color_value('blue')  # Returns '255'
 ```
 
 ### **📊 Squad Parameters You Can Customize:**
@@ -397,11 +396,36 @@ active_clan_label: "true"
 active_clan_threshold: "50"
 ```
 
-### **🎮 Quick Customization Examples:**
+### **🚀 Quick Functions - EASIEST WAY TO CUSTOMIZE!**
+```python
+# 📝 BASIC QUICK FUNCTIONS
+client.quick_set_name("My Squad")              # Change name
+client.quick_set_rating(5000)                    # Set rating
+client.quick_set_member_limit(50)               # Set member limit
+client.quick_set_currency(10000)                  # Set currency
+
+# � COLOR QUICK FUNCTIONS
+client.quick_set_colors("red")                    # Red theme
+client.quick_set_colors("blue", "white")           # Blue/White theme
+client.quick_set_colors("black", "gold")           # Black/Gold theme
+
+# ⭐ LEVEL QUICK FUNCTIONS
+client.quick_set_level(5)                         # Set to Level 5
+client.quick_set_level(10, "Max Level")           # Set to Level 10
+
+# 🏆 PROFESSIONAL QUICK SETUPS
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional setup
+client.quick_setup_gaming_squad("Gaming Squad", "fire")       # Gaming setup
+
+# 🔄 RESET QUICK FUNCTION
+client.quick_reset_to_defaults()                    # Reset to defaults
+```
+
+### **�🎮 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
+client.quick_set_level(10)                    # Max level squad
+client.quick_set_level(5, "Level 5 Warriors")  # Custom name
 
 # 🎨 One-line theme applications
 client.customize_squad_theme('fire')            # Fire theme
@@ -507,6 +531,12 @@ python examples/automatic_squad_management.py
 # Complete squad customization:
 python examples/complete_squad_customization.py
 
+# Quick squad customization:
+python examples/squad_customization_quick.py
+
+# Squad quick start (super simple):
+python examples/squad_quick_start.py
+
 # Authentication examples:
 python examples/authentication_example.py
 

mc5_api_client-1.0.23/examples/squad_customization_quick.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : squad_customization_quick.py
+# | License  | MIT License © 2026 Chizoba
+# | Brief    | Quick squad customization examples
+# ────────────────★─────────────────────────────────
+
+"""
+Quick Squad Customization Examples for MC5 API Client
+
+This shows the most common squad customization tasks in a simple, easy-to-understand way.
+"""
+
+from mc5_api_client import MC5Client
+
+def main():
+    """Quick squad customization demo."""
+    print("🎮 MC5 API Client - Quick Squad Customization")
+    print("=" * 50)
+    print("🚀 Easy squad customization examples!")
+    print()
+    
+    # Initialize client
+    client = MC5Client(
+        client_id="1875:55979:6.0.0a:windows:windows",
+        username="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
+        password="sSJKzhQ5l4vrFgov"
+    )
+    
+    print("✅ Client initialized!")
+    
+    # Example 1: Set squad to Level 8
+    print("\n🎯 Example 1: Set Squad to Level 8")
+    print("-" * 35)
+    
+    result = client.set_squad_level(8, "Level 8 Elite")
+    if result and 'error' not in result:
+        print("✅ Level 8 set successfully!")
+    else:
+        print(f"❌ Failed: {result}")
+    
+    # Example 2: Apply Fire Theme
+    print("\n🔥 Example 2: Apply Fire Theme")
+    print("-" * 30)
+    
+    result = client.customize_squad_theme('fire', 'Fire Warriors')
+    if result and 'error' not in result:
+        print("✅ Fire theme applied!")
+    else:
+        print(f"❌ Failed: {result}")
+    
+    # Example 3: Quick customization
+    print("\n⚡ Example 3: Quick Customization")
+    print("-" * 30)
+    
+    result = client.customize_squad_complete(
+        name="452e55e84897+",
+        rating=5000,
+        member_limit=100
+    )
+    if result and 'error' not in result:
+        print("✅ Quick customization done!")
+    else:
+        print(f"❌ Failed: {result}")
+    
+    print("\n" + "=" * 50)
+    print("🎉 Quick Demo Complete!")
+    print("=" * 50)
+    print()
+    print("💡 Available helper functions:")
+    print("   🎯 set_squad_level(level, name)")
+    print("   🎨 customize_squad_theme(theme, name)")
+    print("   🔧 customize_squad_complete(**kwargs)")
+    print()
+    print("🚀 All functions work automatically - no manual IDs needed!")
+
+if __name__ == "__main__":
+    main()

mc5_api_client-1.0.23/examples/squad_quick_start.py

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : squad_quick_start.py
+# | License  | MIT License © 2026 Chizoba
+# | Brief    | Super simple squad customization
+# ────────────────★─────────────────────────────────
+
+"""
+Super Simple Squad Customization - Quick Start Guide
+
+This shows the easiest ways to customize your squad.
+Perfect for beginners!
+"""
+
+from mc5_api_client import MC5Client
+
+def main():
+    """Super simple squad customization."""
+    print("🎮 MC5 API Client - Squad Quick Start")
+    print("=" * 40)
+    print("🚀 Easiest squad customization ever!")
+    print()
+    
+    # Initialize client
+    client = MC5Client(
+        client_id="1875:55979:6.0.0a:windows:windows",
+        username="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
+        password="sSJKzhQ5l4vrFgov"
+    )
+    
+    print("✅ Client ready!")
+    
+    # Most common customizations
+    print("\n🎯 Most Common Customizations:")
+    print("-" * 30)
+    
+    # 1. Change name
+    print("1. Change squad name:")
+    result = client.quick_set_name("My Awesome Squad")
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # 2. Set level
+    print("\n2. Set to Level 5:")
+    result = client.quick_set_level(5)
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # 3. Set colors
+    print("\n3. Set colors (Red and White):")
+    result = client.quick_set_colors("red", "white")
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # 4. Set member limit
+    print("\n4. Set member limit to 50:")
+    result = client.quick_set_member_limit(50)
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # 5. Set currency
+    print("\n5. Set currency to 10000:")
+    result = client.quick_set_currency(10000)
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # Quick setups
+    print("\n🚀 Quick Setups:")
+    print("-" * 20)
+    
+    # Professional squad
+    print("6. Professional squad setup:")
+    result = client.quick_setup_professional_squad("Elite Squad", level=8)
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    # Gaming squad
+    print("\n7. Gaming squad setup:")
+    result = client.quick_setup_gaming_squad("Gaming Legends", "fire")
+    print(f"   ✅ {'Success!' if 'error' not in result else 'Failed'}")
+    
+    print("\n" + "=" * 40)
+    print("🎉 Quick Start Complete!")
+    print("=" * 40)
+    print()
+    print("💡 Quick functions available:")
+    print("   📝 quick_set_name(name)")
+    print("   ⭐ quick_set_level(level)")
+    print("   🎨 quick_set_colors(primary, secondary)")
+    print("   👥 quick_set_member_limit(limit)")
+    print("   💰 quick_set_currency(amount)")
+    print("   🏆 quick_setup_professional_squad(name, level)")
+    print("   🎮 quick_setup_gaming_squad(name, theme)")
+    print("   🔄 quick_reset_to_defaults()")
+    print()
+    print("🚀 All functions work automatically - no manual IDs needed!")
+
+if __name__ == "__main__":
+    main()

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mc5_api_client"
-version = "1.0.22"
+version = "1.0.23"
 description = "A comprehensive Python library for interacting with the Modern Combat 5 API"
 readme = "README.md"
 license = {file = "LICENSE"}

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/setup.py

@@ -33,7 +33,7 @@ def read_requirements():
 setup(
     name="mc5_api_client",
     use_scm_version=False,
-    version="1.0.22",
+    version="1.0.23",
     description="A comprehensive Python library for interacting with the Modern Combat 5 API",
     long_description=read_readme(),
     long_description_content_type="text/markdown",

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/src/mc5_api_client/__init__.py

@@ -15,7 +15,7 @@ messaging, and more.
 
 from typing import Optional, Dict, Any
 
-__version__ = "1.0.22"
+__version__ = "1.0.23"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"
@@ -442,6 +442,15 @@ __all__ = [
     "customize_squad_theme",
     "set_squad_level",
     "customize_squad_complete",
+    "quick_set_name",
+    "quick_set_rating",
+    "quick_set_member_limit",
+    "quick_set_colors",
+    "quick_set_level",
+    "quick_set_currency",
+    "quick_setup_professional_squad",
+    "quick_setup_gaming_squad",
+    "quick_reset_to_defaults",
     "generate_device_id",
     "create_federation_session",
     "locate_service",

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/src/mc5_api_client/client.py

@@ -2038,6 +2038,161 @@ class MC5Client(SquadBattleMixin, FederationMixin, AlertsMixin, AccountMixin, Tr
         # Apply updates
         return self.update_my_squad_info(**kwargs)
     
+    # Quick Squad Customization Functions (NEW!)
+    
+    def quick_set_name(self, name: str) -> Dict[str, Any]:
+        """
+        Quickly set squad name.
+        
+        Args:
+            name: New squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(name=name)
+    
+    def quick_set_rating(self, rating: int) -> Dict[str, Any]:
+        """
+        Quickly set squad rating.
+        
+        Args:
+            rating: New squad rating (0-99999)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(rating=rating)
+    
+    def quick_set_member_limit(self, limit: int) -> Dict[str, Any]:
+        """
+        Quickly set member limit.
+        
+        Args:
+            limit: New member limit (1-300)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(member_limit=limit)
+    
+    def quick_set_colors(self, primary_color: str, secondary_color: str = None) -> Dict[str, Any]:
+        """
+        Quickly set squad colors using color names.
+        
+        Args:
+            primary_color: Primary color name
+            secondary_color: Secondary color name (optional)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        updates = {
+            "_logo_clr_prim": self.get_color_value(primary_color)
+        }
+        
+        if secondary_color:
+            updates["_logo_clr_sec"] = self.get_color_value(secondary_color)
+        
+        return self.update_my_squad_info(**updates)
+    
+    def quick_set_level(self, level: int, name: str = None) -> Dict[str, Any]:
+        """
+        Quickly set squad to specific level.
+        
+        Args:
+            level: Desired level (1-10)
+            name: Optional custom squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.set_squad_level(level, name)
+    
+    def quick_set_currency(self, amount: int) -> Dict[str, Any]:
+        """
+        Quickly set squad currency.
+        
+        Args:
+            amount: Currency amount
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(currency=str(amount))
+    
+    def quick_setup_professional_squad(self, name: str, level: int = 8) -> Dict[str, Any]:
+        """
+        Quick setup for professional squad with optimal settings.
+        
+        Args:
+            name: Squad name
+            level: Squad level (1-10)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.customize_squad_complete(
+            name=name,
+            _xp=self.calculate_xp_for_level(level),
+            rating=level * 1000,
+            member_limit=50 + (level * 10),
+            membership="owner_approved",
+            _min_join_value=level * 200,
+            description=f"Professional squad at Level {level}!",
+            currency=str(level * 5000),
+            active_clan_label="true"
+        )
+    
+    def quick_setup_gaming_squad(self, name: str, theme: str = "fire") -> Dict[str, Any]:
+        """
+        Quick setup for gaming squad with theme.
+        
+        Args:
+            name: Squad name
+            theme: Color theme ('fire', 'ice', 'dark', 'nature')
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        # Apply theme first
+        theme_result = self.customize_squad_theme(theme, name)
+        
+        if theme_result and 'error' not in theme_result:
+            # Add gaming-specific settings
+            gaming_updates = {
+                membership="owner_approved",
+                _min_join_value=1000,
+                currency="10000",
+                active_clan_label="true"
+            }
+            
+            return self.update_my_squad_info(**gaming_updates)
+        
+        return theme_result
+    
+    def quick_reset_to_defaults(self) -> Dict[str, Any]:
+        """
+        Quick reset squad to default settings.
+        
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.customize_squad_complete(
+            name="Default Squad",
+            description="Default squad description",
+            rating=1000,
+            member_limit=30,
+            membership="open",
+            _logo="1",
+            _logo_clr_prim=self.get_color_value("blue"),
+            _logo_clr_sec=self.get_color_value("white"),
+            _min_join_value=500,
+            _xp=self.calculate_xp_for_level(1),
+            currency="0",
+            active_clan_label="false"
+        )
+    
     # Events API
     
     def get_events(self, event_type: str = None, status: str = None) -> List[Dict[str, Any]]:

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23/src/mc5_api_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.22
+Version: 1.0.23
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -409,38 +409,37 @@ 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.
+# 🚀 SUPER SIMPLE - One-line customizations!
+client.quick_set_name("My Awesome Squad")           # Change name
+client.quick_set_level(5)                              # Set to Level 5
+client.quick_set_colors("red", "white")               # Red/White colors
+client.quick_set_member_limit(50)                     # Set member limit
+client.quick_set_currency(10000)                       # Set currency
 
-# 🎨 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
+# 🎯 QUICK SETUPS - Professional results in one line!
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional squad
+client.quick_setup_gaming_squad("Gaming Legends", "fire")       # Gaming squad with theme
 
-# 🔧 Complete customization with validation
+# 🎨 THEMES - Beautiful colors instantly
+client.customize_squad_theme('fire')                    # Fire theme
+client.customize_squad_theme('ice')                     # Ice theme
+client.customize_squad_theme('dark')                    # Dark theme
+client.customize_squad_theme('nature')                  # Nature theme
+
+# ⭐ LEVEL SYSTEM - Automatic XP calculation
+client.set_squad_level(10, "Max Level Squad")          # Level 10 (max)
+# Level 1: 1000 XP, Level 5: 5000 XP, Level 10: 10000 XP
+
+# 🔧 COMPLETE CUSTOMIZATION - Full control 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"
+    _logo_clr_prim=client.get_color_value("red"),
+    _xp=client.calculate_xp_for_level(9),
+    currency="10000"
 )
-
-# 🎯 Helper functions
-xp = client.calculate_xp_for_level(5)  # Returns 5000
-color = client.get_color_value('blue')  # Returns '255'
 ```
 
 ### **📊 Squad Parameters You Can Customize:**
@@ -475,11 +474,36 @@ active_clan_label: "true"
 active_clan_threshold: "50"
 ```
 
-### **🎮 Quick Customization Examples:**
+### **🚀 Quick Functions - EASIEST WAY TO CUSTOMIZE!**
+```python
+# 📝 BASIC QUICK FUNCTIONS
+client.quick_set_name("My Squad")              # Change name
+client.quick_set_rating(5000)                    # Set rating
+client.quick_set_member_limit(50)               # Set member limit
+client.quick_set_currency(10000)                  # Set currency
+
+# � COLOR QUICK FUNCTIONS
+client.quick_set_colors("red")                    # Red theme
+client.quick_set_colors("blue", "white")           # Blue/White theme
+client.quick_set_colors("black", "gold")           # Black/Gold theme
+
+# ⭐ LEVEL QUICK FUNCTIONS
+client.quick_set_level(5)                         # Set to Level 5
+client.quick_set_level(10, "Max Level")           # Set to Level 10
+
+# 🏆 PROFESSIONAL QUICK SETUPS
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional setup
+client.quick_setup_gaming_squad("Gaming Squad", "fire")       # Gaming setup
+
+# 🔄 RESET QUICK FUNCTION
+client.quick_reset_to_defaults()                    # Reset to defaults
+```
+
+### **�🎮 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
+client.quick_set_level(10)                    # Max level squad
+client.quick_set_level(5, "Level 5 Warriors")  # Custom name
 
 # 🎨 One-line theme applications
 client.customize_squad_theme('fire')            # Fire theme
@@ -585,6 +609,12 @@ python examples/automatic_squad_management.py
 # Complete squad customization:
 python examples/complete_squad_customization.py
 
+# Quick squad customization:
+python examples/squad_customization_quick.py
+
+# Squad quick start (super simple):
+python examples/squad_quick_start.py
+
 # Authentication examples:
 python examples/authentication_example.py
 

{mc5_api_client-1.0.22 → mc5_api_client-1.0.23}/src/mc5_api_client.egg-info/SOURCES.txt

@@ -28,7 +28,9 @@ examples/quick_help.py
 examples/quick_reference.py
 examples/service_location_example.py
 examples/simple_usage.py
+examples/squad_customization_quick.py
 examples/squad_management.py
+examples/squad_quick_start.py
 examples/squad_wall_management.py
 src/mc5_api_client/__init__.py
 src/mc5_api_client/account.py