Metadata-Version: 2.4
Name: FlexbaseGFFT
Version: 2.0.6
Summary: Garena Free Fire Toolkit Module
Home-page: https://github.com/Flexbasei/FlexbaseGFFT
Author: Flexbase
Author-email: your_email@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.1
Requires-Dist: pycryptodome>=3.10.1
Requires-Dist: PyJWT>=2.1.0
Requires-Dist: protobuf>=5.26.1
Requires-Dist: urllib3
Requires-Dist: httpx
Requires-Dist: beautifulsoup4
Requires-Dist: google-play-scraper
Requires-Dist: rich>=12.0.0

# 🚀 FlexbaseGFFT

**FlexbaseGFFT** (**Flexbase Garena Free Fire Toolkit**) is a fast and lightweight Python library designed for Garena Free Fire automation. It provides secure JWT token generation, player information utilities, server endpoint discovery, suspension status checking, and automatic live game update retrieval through a simple synchronous API.

No `async`/`await` is required, making integration easy for any Python project.

---

# ✨ Features

- 🚀 **Fast & Lightweight**
  - Optimized for speed and efficient performance.

- 🧠 **Smart Caching**
  - Live game update information is fetched only once during bulk processing and cached in memory.

- ⚡ **Simple Synchronous API**
  - No `async`/`await`.
  - Easy integration.
  - Clean and minimal interface.

- 🔐 **FFJTG**
  - Generates secure JWT verification tokens using Garena authentication credentials.

- 🚫 **BanCheck**
  - Retrieves player suspension status using a target player UID.

- 👤 **UTN (UidToName)**
  - Quickly returns a player's nickname using a simple function call.

- 🌍 **RegionCheck**
  - Detects and returns the target player's active region.

- 🌐 **CBSU**
  - Parses login response mappings and returns live server endpoint details.

- 🔄 **FFUpdater**
  - Dynamically retrieves the latest live game version information.

- 📦 **Automatic Dependency Installation**
  - Required dependencies are installed automatically through pip.

---

# 📋 Requirements

- Python **3.10+**
- pip

---

# 📥 Installation

Install directly from PyPI:

```bash
pip install FlexbaseGFFT
```

Or install from source:

```bash
git clone https://github.com/Flexbasei/FlexbaseGFFT.git
cd FlexbaseGFFT
pip install .
```

---

# 🚀 Quick Start

```python
from FlexbaseGFFT import FFJTG, FFUpdater

# Fetch latest game update information
updater = FFUpdater()
print(updater.info)

# Generate JWT token
engine = FFJTG()

result = engine.access_token(
    access_token="YOUR_ACCESS_TOKEN"
)

print(result)
```

---

# 📚 Modules

---

## 🔐 FFJTG (JWT Token Generator)

Generates secure JWT verification tokens using Garena authentication credentials.

### UID + Password

```python
from FlexbaseGFFT import FFJTG

engine = FFJTG()

result = engine.uid_password(
    uid="YOUR_UID",
    password="YOUR_PASSWORD"
)

print(result)
```

### Access Token

```python
from FlexbaseGFFT import FFJTG

engine = FFJTG()

result = engine.access_token(
    access_token="YOUR_ACCESS_TOKEN"
)

print(result)
```

### Access Token + Open ID

```python
from FlexbaseGFFT import FFJTG

engine = FFJTG()

result = engine.access_token(
    access_token="YOUR_ACCESS_TOKEN",
    open_id="YOUR_OPEN_ID"
)

print(result)
```

Example Output

```python
{
    "status": "success",
    "account_id": 13103014678,
    "account_name": "Garena",
    "open_id": "f1200aa49c070fbb81...",
    "access_token": "D24rdw46uh9igs247...",
    "platform": "Guest",
    "region": "BD",
    "token": "eyJhbGciOiJIUzI1Ni..."
}
```

---

## 🚫 BanCheck

Retrieve player suspension status.

```python
from FlexbaseGFFT import BanCheck

checker = BanCheck()

result = checker.check("13103014678")

print(result)
```

Example Output

```python
{
    "status": true,
    "uid": "13103014678",
    "nickname": "Garena",
    "region": "BD",
    "ban_status": "Not banned",
    "is_banned": false,
    "ban_period_months": null
}
```

---

## 👤 UTN (UidToName)

Return a player's nickname.

```python
from FlexbaseGFFT import UTN

nickname = UTN("13103014678")

print(nickname)
```

Output

```text
Garena
```

---

## 🌍 RegionCheck

Return the player's active region.

```python
from FlexbaseGFFT import RegionCheck

region = RegionCheck("13103014678")

print(region)
```

Output

```text
BD
```

---

## 🌐 CBSU (Credential By Server URL)

Retrieve live server endpoint information.

### UID + Password

```python
from FlexbaseGFFT import CBSU

engine = CBSU()

result = engine.uid_password(
    "YOUR_UID",
    "YOUR_PASSWORD"
)

print(result)
```

### Access Token

```python
result = engine.access_token(
    access_token="YOUR_ACCESS_TOKEN"
)

print(result)
```

### Access Token + Open ID

```python
result = engine.access_token(
    access_token="YOUR_ACCESS_TOKEN",
    open_id="YOUR_OPEN_ID"
)

print(result)
```

Example Output

```python
{
    "status": "success",
    "account_id": "13103014678",
    "account_name": "Garena",
    "open_id": "f1200aa49c070fbb81...",
    "access_token": "D24rdw46uh9igs247...",
    "platform": "Guest",
    "region": "BD",
    "server_url": "https://clientbp.ggpolarbear.com",
    "server_login_url": "https://loginbp.ggblueshark.com"
}
```

---

## 🔄 FFUpdater

Retrieve the latest live game update information.

```python
from FlexbaseGFFT import FFUpdater

updater = FFUpdater()

print(updater.info)
```

Example Output

```python
{
    "VersionCode": "1.104.X",
    "ReleaseVersion": "OB54",
    "FromVersion": "OB53",
    "ToVersion": "OB54",
    "NextUpdateDate": "September 15, 2026 (GMT-3)",
    "Countdown": "24 days"
}
```

---

# ⚡ Performance

- Smart in-memory caching
- Lightweight synchronous execution
- Reduced network requests
- Optimized for bulk processing
- Fast runtime performance

---


```

---

# 🤝 Community & Support

Stay updated with our latest projects and releases.

- 💝 **Telegram:** https://t.me/Flexbasei
- 🌺 **Developer:** https://t.me/spideerio_yt
- 💻 **GitHub:** https://github.com/Flexbasei

---

# ⭐ Support

If you find this project useful, please consider giving it a **⭐ Star** on GitHub.

Made with ❤️ by **Flexbase**
