mc5-api-client 1.0.11__tar.gz → 1.0.12__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/PKG-INFO +32 -35
  2. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/README.md +31 -34
  3. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/pyproject.toml +1 -1
  4. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/__init__.py +1 -1
  5. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/cli.py +1 -1
  6. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/PKG-INFO +32 -35
  7. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/.gitignore +0 -0
  8. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/CHANGELOG.md +0 -0
  9. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/LICENSE +0 -0
  10. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/MANIFEST.in +0 -0
  11. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/admin_squad_management.py +0 -0
  12. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/advanced_automation.py +0 -0
  13. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/advanced_features.py +0 -0
  14. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/basic_usage.py +0 -0
  15. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/clan_management.py +0 -0
  16. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/clan_management_complete.py +0 -0
  17. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/events_and_tasks.py +0 -0
  18. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/help_system.py +0 -0
  19. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/message_management.py +0 -0
  20. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/player_stats.py +0 -0
  21. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/private_messaging.py +0 -0
  22. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/quick_help.py +0 -0
  23. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/simple_usage.py +0 -0
  24. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/squad_management.py +0 -0
  25. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/examples/squad_wall_management.py +0 -0
  26. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/pytest.ini +0 -0
  27. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/requirements-dev.txt +0 -0
  28. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/requirements.txt +0 -0
  29. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/setup.cfg +0 -0
  30. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/setup.py +0 -0
  31. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/admin_client.py +0 -0
  32. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/auth.py +0 -0
  33. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/client.py +0 -0
  34. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/exceptions.py +0 -0
  35. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/help.py +0 -0
  36. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/py.typed +0 -0
  37. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client/simple_client.py +0 -0
  38. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/SOURCES.txt +0 -0
  39. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/dependency_links.txt +0 -0
  40. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/entry_points.txt +0 -0
  41. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/not-zip-safe +0 -0
  42. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/requires.txt +0 -0
  43. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/src/mc5_api_client.egg-info/top_level.txt +0 -0
  44. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/tests/__init__.py +0 -0
  45. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/tests/test_auth.py +0 -0
  46. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/tests/test_cli.py +0 -0
  47. {mc5_api_client-1.0.11 → mc5_api_client-1.0.12}/tests/test_client.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mc5_api_client
3
- Version: 1.0.11
3
+ Version: 1.0.12
4
4
  Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
5
5
  Home-page: https://pypi.org/project/mc5-api-client/
6
6
  Author: Chizoba
@@ -108,9 +108,9 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
108
108
  - ⚡ **One-Liner Functions**: Quick search and kick operations!
109
109
  - 🎯 **User-Friendly**: Designed for beginners and clan leaders!
110
110
  - 🚀 **NEW: Admin Capabilities**: Use admin credentials for enhanced squad management!
111
- - ⭐ **NEW: Squad Rating**: Add 5200+ rating to your squad with admin privileges!
112
111
  - 🎯 **NEW: Player Score Updates**: Update any player's score, XP, and kill signatures!
113
112
  - 🛡️ **NEW: Built-in Help System**: Comprehensive help commands and examples!
113
+ - 🔐 **NEW: Encrypted Token Support**: Generate and encrypt tokens for additional security!
114
114
 
115
115
  ## 🚀 Installation
116
116
 
@@ -122,14 +122,14 @@ pip install mc5_api_client==1.0.8
122
122
 
123
123
  ### ✅ **Major Enhancements Completed!**
124
124
 
125
- **🚀 Advanced Automation Features (NEW in v1.0.8):**
125
+ **🚀 Advanced Automation Features (NEW in v1.0.8+):**
126
126
  - ✅ **AdminMC5Client**: Enhanced client with admin privileges
127
- - ✅ **Squad Rating Management**: Add 5200+ rating to any squad
128
- - ✅ **Player Score Updates**: Update any player's score, XP, and kill signatures
127
+ - ✅ **Player Score Management**: Update individual player scores, XP, and kill signatures
129
128
  - ✅ **Batch Processing**: Search multiple players with loops and conditionals
130
129
  - ✅ **Real-time Monitoring**: Continuous activity tracking with while loops
131
130
  - ✅ **Smart Clan Cleanup**: Intelligent member management with safety features
132
131
  - ✅ **Built-in Help System**: Comprehensive help commands and examples
132
+ - ✅ **Encrypted Token Support**: Generate and encrypt tokens for additional security
133
133
  - ✅ **Production Ready**: Thoroughly tested and verified for production use
134
134
 
135
135
  **🎮 Revolutionary Simple Interface (from v1.0.7):**
@@ -174,12 +174,11 @@ pip install mc5_api_client
174
174
 
175
175
  New in v1.0.8! Powerful admin capabilities for enhanced squad management:
176
176
 
177
- ### **⭐ Add 5200+ Rating to Your Squad**
178
-
177
+ ### **⭐ Update Player Scores (Admin Only):**
179
178
  ```python
180
179
  from mc5_api_client import quick_update_player_score
181
180
 
182
- # Add 5200 rating to your squad by updating your player score
181
+ # Update any player's score, XP, and kill signature
183
182
  result = quick_update_player_score(
184
183
  target_user_id="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
185
184
  score=5200,
@@ -188,48 +187,47 @@ result = quick_update_player_score(
188
187
  killsig_id="default_killsig_80"
189
188
  )
190
189
 
191
- print(f"✅ Success! Score updated: {result['score_updated']}")
190
+ if result.get('success'):
191
+ print("✅ Player score updated successfully!")
192
+ print(f"New score: {result.get('score')}")
193
+ print(f"New XP: {result.get('xp')}")
192
194
  ```
193
195
 
194
- ### **🛡️ Admin Client Usage**
195
-
196
+ ### **� Admin Client Usage:**
196
197
  ```python
197
198
  from mc5_api_client import create_admin_client
198
199
 
199
- # Create admin client with enhanced privileges
200
+ # Create admin client with elevated privileges
200
201
  client = create_admin_client()
201
202
  client.connect()
202
203
 
203
- # Update any player's score
204
+ # Update player information
204
205
  result = client.update_player_score(
205
206
  target_user_id="player_user_id",
206
207
  score=10000,
207
- xp=5000000
208
+ xp=5000000,
209
+ killsig_color="16777215",
210
+ killsig_id="default_killsig_42"
208
211
  )
209
212
 
210
- # Get squad members
213
+ # Get squad members (if you have access)
211
214
  members = client.get_squad_members()
212
- print(f"Squad has {len(members)} members")
215
+ print(f"Found {len(members)} squad members")
216
+
217
+ # Kick members (if you have permissions)
218
+ # client.kick_member("member_user_id", "Reason for kick")
213
219
 
214
220
  client.close()
215
221
  ```
216
222
 
217
- ### **🎯 Quick Squad Rating**
223
+ ### **⚠️ Important Admin Limitations:**
224
+ - ✅ **Can Update**: Individual player scores, XP, kill signatures
225
+ - ✅ **Can Kick**: Squad members (with proper permissions)
226
+ - ❌ **Cannot Edit**: Squad rating directly (requires squad ownership)
227
+ - ❌ **Cannot Modify**: Squad settings (requires squad ownership)
218
228
 
219
- ```python
220
- from mc5_api_client import quick_add_squad_rating
221
-
222
- # Add rating using admin credentials
223
- result = quick_add_squad_rating(
224
- username="game:mc5_system",
225
- password="admin",
226
- rating=5200,
227
- use_admin=True
228
- )
229
-
230
- if 'error' not in result:
231
- print("✅ 5200 rating added to squad!")
232
- ```
229
+ ### **🔧 How It Actually Works:**
230
+ Admin privileges allow you to modify individual player data within a squad, which indirectly affects the squad's overall rating through the sum of member scores, but you cannot directly set the squad's rating value.
233
231
 
234
232
  ## 🎮 **Simple Usage for Non-Developers**
235
233
 
@@ -400,8 +398,7 @@ client.connect()
400
398
  player = client.search_player('f55f')
401
399
 
402
400
  # 🔹 Admin Operations
403
- quick_update_player_score('user_id', 5200)
404
- quick_add_squad_rating('admin', 'admin', 5200, use_admin=True)
401
+ quick_update_player_score('user_id', 5200, xp=2037745)
405
402
 
406
403
  # 🔹 Error Handling
407
404
  try: except AuthenticationError:
@@ -413,10 +410,10 @@ try: except MC5APIError:
413
410
  ### **🚀 Install from PyPI (Recommended)**
414
411
 
415
412
  ```bash
416
- pip install mc5_api_client==1.0.10
413
+ pip install mc5_api_client==1.0.12
417
414
  ```
418
415
 
419
- ✅ **Published and Available!** The MC5 API Client v1.0.10 is now live on PyPI with advanced automation features and admin capabilities!
416
+ ✅ **Published and Available!** The MC5 API Client v1.0.12 is now live on PyPI with accurate admin capabilities, encrypted token support, and corrected documentation!
420
417
 
421
418
  ### **� Install from Local Package**
422
419
 
@@ -30,9 +30,9 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
30
30
  - ⚡ **One-Liner Functions**: Quick search and kick operations!
31
31
  - 🎯 **User-Friendly**: Designed for beginners and clan leaders!
32
32
  - 🚀 **NEW: Admin Capabilities**: Use admin credentials for enhanced squad management!
33
- - ⭐ **NEW: Squad Rating**: Add 5200+ rating to your squad with admin privileges!
34
33
  - 🎯 **NEW: Player Score Updates**: Update any player's score, XP, and kill signatures!
35
34
  - 🛡️ **NEW: Built-in Help System**: Comprehensive help commands and examples!
35
+ - 🔐 **NEW: Encrypted Token Support**: Generate and encrypt tokens for additional security!
36
36
 
37
37
  ## 🚀 Installation
38
38
 
@@ -44,14 +44,14 @@ pip install mc5_api_client==1.0.8
44
44
 
45
45
  ### ✅ **Major Enhancements Completed!**
46
46
 
47
- **🚀 Advanced Automation Features (NEW in v1.0.8):**
47
+ **🚀 Advanced Automation Features (NEW in v1.0.8+):**
48
48
  - ✅ **AdminMC5Client**: Enhanced client with admin privileges
49
- - ✅ **Squad Rating Management**: Add 5200+ rating to any squad
50
- - ✅ **Player Score Updates**: Update any player's score, XP, and kill signatures
49
+ - ✅ **Player Score Management**: Update individual player scores, XP, and kill signatures
51
50
  - ✅ **Batch Processing**: Search multiple players with loops and conditionals
52
51
  - ✅ **Real-time Monitoring**: Continuous activity tracking with while loops
53
52
  - ✅ **Smart Clan Cleanup**: Intelligent member management with safety features
54
53
  - ✅ **Built-in Help System**: Comprehensive help commands and examples
54
+ - ✅ **Encrypted Token Support**: Generate and encrypt tokens for additional security
55
55
  - ✅ **Production Ready**: Thoroughly tested and verified for production use
56
56
 
57
57
  **🎮 Revolutionary Simple Interface (from v1.0.7):**
@@ -96,12 +96,11 @@ pip install mc5_api_client
96
96
 
97
97
  New in v1.0.8! Powerful admin capabilities for enhanced squad management:
98
98
 
99
- ### **⭐ Add 5200+ Rating to Your Squad**
100
-
99
+ ### **⭐ Update Player Scores (Admin Only):**
101
100
  ```python
102
101
  from mc5_api_client import quick_update_player_score
103
102
 
104
- # Add 5200 rating to your squad by updating your player score
103
+ # Update any player's score, XP, and kill signature
105
104
  result = quick_update_player_score(
106
105
  target_user_id="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
107
106
  score=5200,
@@ -110,48 +109,47 @@ result = quick_update_player_score(
110
109
  killsig_id="default_killsig_80"
111
110
  )
112
111
 
113
- print(f"✅ Success! Score updated: {result['score_updated']}")
112
+ if result.get('success'):
113
+ print("✅ Player score updated successfully!")
114
+ print(f"New score: {result.get('score')}")
115
+ print(f"New XP: {result.get('xp')}")
114
116
  ```
115
117
 
116
- ### **🛡️ Admin Client Usage**
117
-
118
+ ### **� Admin Client Usage:**
118
119
  ```python
119
120
  from mc5_api_client import create_admin_client
120
121
 
121
- # Create admin client with enhanced privileges
122
+ # Create admin client with elevated privileges
122
123
  client = create_admin_client()
123
124
  client.connect()
124
125
 
125
- # Update any player's score
126
+ # Update player information
126
127
  result = client.update_player_score(
127
128
  target_user_id="player_user_id",
128
129
  score=10000,
129
- xp=5000000
130
+ xp=5000000,
131
+ killsig_color="16777215",
132
+ killsig_id="default_killsig_42"
130
133
  )
131
134
 
132
- # Get squad members
135
+ # Get squad members (if you have access)
133
136
  members = client.get_squad_members()
134
- print(f"Squad has {len(members)} members")
137
+ print(f"Found {len(members)} squad members")
138
+
139
+ # Kick members (if you have permissions)
140
+ # client.kick_member("member_user_id", "Reason for kick")
135
141
 
136
142
  client.close()
137
143
  ```
138
144
 
139
- ### **🎯 Quick Squad Rating**
145
+ ### **⚠️ Important Admin Limitations:**
146
+ - ✅ **Can Update**: Individual player scores, XP, kill signatures
147
+ - ✅ **Can Kick**: Squad members (with proper permissions)
148
+ - ❌ **Cannot Edit**: Squad rating directly (requires squad ownership)
149
+ - ❌ **Cannot Modify**: Squad settings (requires squad ownership)
140
150
 
141
- ```python
142
- from mc5_api_client import quick_add_squad_rating
143
-
144
- # Add rating using admin credentials
145
- result = quick_add_squad_rating(
146
- username="game:mc5_system",
147
- password="admin",
148
- rating=5200,
149
- use_admin=True
150
- )
151
-
152
- if 'error' not in result:
153
- print("✅ 5200 rating added to squad!")
154
- ```
151
+ ### **🔧 How It Actually Works:**
152
+ Admin privileges allow you to modify individual player data within a squad, which indirectly affects the squad's overall rating through the sum of member scores, but you cannot directly set the squad's rating value.
155
153
 
156
154
  ## 🎮 **Simple Usage for Non-Developers**
157
155
 
@@ -322,8 +320,7 @@ client.connect()
322
320
  player = client.search_player('f55f')
323
321
 
324
322
  # 🔹 Admin Operations
325
- quick_update_player_score('user_id', 5200)
326
- quick_add_squad_rating('admin', 'admin', 5200, use_admin=True)
323
+ quick_update_player_score('user_id', 5200, xp=2037745)
327
324
 
328
325
  # 🔹 Error Handling
329
326
  try: except AuthenticationError:
@@ -335,10 +332,10 @@ try: except MC5APIError:
335
332
  ### **🚀 Install from PyPI (Recommended)**
336
333
 
337
334
  ```bash
338
- pip install mc5_api_client==1.0.10
335
+ pip install mc5_api_client==1.0.12
339
336
  ```
340
337
 
341
- ✅ **Published and Available!** The MC5 API Client v1.0.10 is now live on PyPI with advanced automation features and admin capabilities!
338
+ ✅ **Published and Available!** The MC5 API Client v1.0.12 is now live on PyPI with accurate admin capabilities, encrypted token support, and corrected documentation!
342
339
 
343
340
  ### **� Install from Local Package**
344
341
 
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "mc5_api_client"
7
- version = "1.0.11"
7
+ version = "1.0.12"
8
8
  description = "A comprehensive Python library for interacting with the Modern Combat 5 API"
9
9
  readme = "README.md"
10
10
  license = {file = "LICENSE"}
@@ -15,7 +15,7 @@ messaging, and more.
15
15
 
16
16
  from typing import Optional, Dict, Any
17
17
 
18
- __version__ = "1.0.11"
18
+ __version__ = "1.0.12"
19
19
  __author__ = "Chizoba"
20
20
  __email__ = "chizoba2026@hotmail.com"
21
21
  __license__ = "MIT"
@@ -447,7 +447,7 @@ class MC5CLI:
447
447
 
448
448
  def _print_version(self):
449
449
  """Print version information."""
450
- self._print("MC5 API Client v1.0.11", "cyan")
450
+ self._print("MC5 API Client v1.0.12", "cyan")
451
451
  self._print("The ultimate Modern Combat 5 API library", "green")
452
452
  self._print("Author: Chizoba", "blue")
453
453
  self._print("Email: chizoba2026@hotmail.com", "blue")
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mc5_api_client
3
- Version: 1.0.11
3
+ Version: 1.0.12
4
4
  Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
5
5
  Home-page: https://pypi.org/project/mc5-api-client/
6
6
  Author: Chizoba
@@ -108,9 +108,9 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
108
108
  - ⚡ **One-Liner Functions**: Quick search and kick operations!
109
109
  - 🎯 **User-Friendly**: Designed for beginners and clan leaders!
110
110
  - 🚀 **NEW: Admin Capabilities**: Use admin credentials for enhanced squad management!
111
- - ⭐ **NEW: Squad Rating**: Add 5200+ rating to your squad with admin privileges!
112
111
  - 🎯 **NEW: Player Score Updates**: Update any player's score, XP, and kill signatures!
113
112
  - 🛡️ **NEW: Built-in Help System**: Comprehensive help commands and examples!
113
+ - 🔐 **NEW: Encrypted Token Support**: Generate and encrypt tokens for additional security!
114
114
 
115
115
  ## 🚀 Installation
116
116
 
@@ -122,14 +122,14 @@ pip install mc5_api_client==1.0.8
122
122
 
123
123
  ### ✅ **Major Enhancements Completed!**
124
124
 
125
- **🚀 Advanced Automation Features (NEW in v1.0.8):**
125
+ **🚀 Advanced Automation Features (NEW in v1.0.8+):**
126
126
  - ✅ **AdminMC5Client**: Enhanced client with admin privileges
127
- - ✅ **Squad Rating Management**: Add 5200+ rating to any squad
128
- - ✅ **Player Score Updates**: Update any player's score, XP, and kill signatures
127
+ - ✅ **Player Score Management**: Update individual player scores, XP, and kill signatures
129
128
  - ✅ **Batch Processing**: Search multiple players with loops and conditionals
130
129
  - ✅ **Real-time Monitoring**: Continuous activity tracking with while loops
131
130
  - ✅ **Smart Clan Cleanup**: Intelligent member management with safety features
132
131
  - ✅ **Built-in Help System**: Comprehensive help commands and examples
132
+ - ✅ **Encrypted Token Support**: Generate and encrypt tokens for additional security
133
133
  - ✅ **Production Ready**: Thoroughly tested and verified for production use
134
134
 
135
135
  **🎮 Revolutionary Simple Interface (from v1.0.7):**
@@ -174,12 +174,11 @@ pip install mc5_api_client
174
174
 
175
175
  New in v1.0.8! Powerful admin capabilities for enhanced squad management:
176
176
 
177
- ### **⭐ Add 5200+ Rating to Your Squad**
178
-
177
+ ### **⭐ Update Player Scores (Admin Only):**
179
178
  ```python
180
179
  from mc5_api_client import quick_update_player_score
181
180
 
182
- # Add 5200 rating to your squad by updating your player score
181
+ # Update any player's score, XP, and kill signature
183
182
  result = quick_update_player_score(
184
183
  target_user_id="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
185
184
  score=5200,
@@ -188,48 +187,47 @@ result = quick_update_player_score(
188
187
  killsig_id="default_killsig_80"
189
188
  )
190
189
 
191
- print(f"✅ Success! Score updated: {result['score_updated']}")
190
+ if result.get('success'):
191
+ print("✅ Player score updated successfully!")
192
+ print(f"New score: {result.get('score')}")
193
+ print(f"New XP: {result.get('xp')}")
192
194
  ```
193
195
 
194
- ### **🛡️ Admin Client Usage**
195
-
196
+ ### **� Admin Client Usage:**
196
197
  ```python
197
198
  from mc5_api_client import create_admin_client
198
199
 
199
- # Create admin client with enhanced privileges
200
+ # Create admin client with elevated privileges
200
201
  client = create_admin_client()
201
202
  client.connect()
202
203
 
203
- # Update any player's score
204
+ # Update player information
204
205
  result = client.update_player_score(
205
206
  target_user_id="player_user_id",
206
207
  score=10000,
207
- xp=5000000
208
+ xp=5000000,
209
+ killsig_color="16777215",
210
+ killsig_id="default_killsig_42"
208
211
  )
209
212
 
210
- # Get squad members
213
+ # Get squad members (if you have access)
211
214
  members = client.get_squad_members()
212
- print(f"Squad has {len(members)} members")
215
+ print(f"Found {len(members)} squad members")
216
+
217
+ # Kick members (if you have permissions)
218
+ # client.kick_member("member_user_id", "Reason for kick")
213
219
 
214
220
  client.close()
215
221
  ```
216
222
 
217
- ### **🎯 Quick Squad Rating**
223
+ ### **⚠️ Important Admin Limitations:**
224
+ - ✅ **Can Update**: Individual player scores, XP, kill signatures
225
+ - ✅ **Can Kick**: Squad members (with proper permissions)
226
+ - ❌ **Cannot Edit**: Squad rating directly (requires squad ownership)
227
+ - ❌ **Cannot Modify**: Squad settings (requires squad ownership)
218
228
 
219
- ```python
220
- from mc5_api_client import quick_add_squad_rating
221
-
222
- # Add rating using admin credentials
223
- result = quick_add_squad_rating(
224
- username="game:mc5_system",
225
- password="admin",
226
- rating=5200,
227
- use_admin=True
228
- )
229
-
230
- if 'error' not in result:
231
- print("✅ 5200 rating added to squad!")
232
- ```
229
+ ### **🔧 How It Actually Works:**
230
+ Admin privileges allow you to modify individual player data within a squad, which indirectly affects the squad's overall rating through the sum of member scores, but you cannot directly set the squad's rating value.
233
231
 
234
232
  ## 🎮 **Simple Usage for Non-Developers**
235
233
 
@@ -400,8 +398,7 @@ client.connect()
400
398
  player = client.search_player('f55f')
401
399
 
402
400
  # 🔹 Admin Operations
403
- quick_update_player_score('user_id', 5200)
404
- quick_add_squad_rating('admin', 'admin', 5200, use_admin=True)
401
+ quick_update_player_score('user_id', 5200, xp=2037745)
405
402
 
406
403
  # 🔹 Error Handling
407
404
  try: except AuthenticationError:
@@ -413,10 +410,10 @@ try: except MC5APIError:
413
410
  ### **🚀 Install from PyPI (Recommended)**
414
411
 
415
412
  ```bash
416
- pip install mc5_api_client==1.0.10
413
+ pip install mc5_api_client==1.0.12
417
414
  ```
418
415
 
419
- ✅ **Published and Available!** The MC5 API Client v1.0.10 is now live on PyPI with advanced automation features and admin capabilities!
416
+ ✅ **Published and Available!** The MC5 API Client v1.0.12 is now live on PyPI with accurate admin capabilities, encrypted token support, and corrected documentation!
420
417
 
421
418
  ### **� Install from Local Package**
422
419
 
File without changes