Tutorial Article: Black Fox Config Builder

1. Language, Updates & Activity Log (Settings)

In the fifth tab (Settings), you can manage language, app updates, remote config, and diagnostic logs:

• Language: Dropdown supporting 10 languages (English, Persian, Russian, Chinese, German, Uzbek, Turkish, Indonesian, Ukrainian, and Hindi). Selecting Persian immediately switches the UI to full RTL.
• Check for updates: Compares your installed app with the server. If a newer version exists, tap update to download the APK with live percentage progress (%) and install directly (forced updates open the prompt immediately).
• Updates & Remote Config: Opens a dialog showing the server version and a manual refresh button to update server version, wallet, and news feeds from dual servers (blackfoxupdate.ir and foxnext.net).
• Activity log: Automatically records timestamped events ([INFO], [OK], [ERROR]) and auto-scrolls to the latest line. Use Copy log or Clear log to manage entries.

2. Secure 3X-UI Panel Connection (Connection)

In the first tab, enter your 3X-UI panel login details. Config Builder supports two authentication methods:

• Panel URL (Required): Full panel address including protocol, port, and base path, e.g. https://sub.domain.com:2053/mybase.
• Username & Password: Standard panel credentials (password characters are masked).
• API Key (optional): Smart mode! Entering an API key automatically activates API authentication, locks/disables the Username and Password fields, and speeds up panel operations. Leave empty if you do not have an API key.
• Sub URI (optional): If your panel's subscription endpoint uses a separate domain or port, enter its base URL here; otherwise leave blank to use the panel's default setting.

4 Action Buttons Explained

• Connect: Validates credentials, saves them in secure storage, connects to the panel, and immediately loads the inbound list. Your Session stays active until you disconnect.
• Disconnect: Enabled only when connected; closes the active panel session and clears creation tabs.
• Save: Saves the entered credentials to Android Secure Storage without connecting.
• Delete: Disconnects any active session and erases all saved panel credentials from your phone.

3. Creating a Single Config (Single)

Once the top badge turns green (Connected), open the second tab to create a new client:

• Config name: Enter the client name. Naming rule: only English letters (A-Z, a-z), digits, spaces, and hyphens (-) are allowed (no non-Latin characters or special symbols). Duplicate names are blocked automatically. Tap the spin icon (↻) to generate a unique random name formatted as Black fox-XXXXXX.
• Traffic (GB): Defaults to 10 GB. Entering 0 displays the helper hint 0 = unlimited.
• Duration (days): Defaults to 30 days. Entering 0 means unlimited duration.
• Select inbounds: Dropdown listing all panel inbounds formatted as protocol · remark · port · status. Select one or more inbounds at once (or tap refresh to reload from the server).
• Create config: Tap the blue button to generate the config instantly and save it to local history.

Generated Output (Bottom Half)

• Two separate links: Both the direct Config link and the Sub link are shown for copying.
• Two separate QR codes: Config QR and Sub QR appear side by side. Tap either QR code once to copy its link immediately!
• Clear page: Shows a confirmation dialog and clears the form and results.

4. Batch & Group Creation (Bulk)

To create multiple configs at once (ideal for resellers and team distribution), open the third tab:

• Base name: Prefix for generated accounts (e.g., Team), used to create unique sequential names. Tap ↻ to generate a unique random base name.
• Count: Number of clients needed (default 10). Total formula: selecting 10 across 2 inbounds generates 20 configs in total.
• Traffic & Duration: Applied uniformly to every config in the batch (0 = unlimited).
• Progress bar & Stop button: After tapping Create bulk configs, a progress indicator (e.g. 0 / 10 until complete) and Stop button appear so you can request cancellation before results are committed.

Managing Generated Links

• Clean two-column grid: Outputs appear in two columns (Config link and Sub link) with blue row numbers. Tap any cell to copy that link instantly.
• Pair copy by row (Link number + Copy): Enter a row number (e.g. 3) and tap Copy to copy both the config link and subscription link for row 3 at once!

5. History & Server Deletion (List)

All configs created in Single and Bulk are stored automatically in the fourth tab (List). When empty, it shows No configs created yet..

• Row details: Shows client name, traffic quota (GB), validity (days), and a link preview.
• Single or batch selection: Each row has a checkbox, and the top header provides Select all plus a live counter (Selected: N).
• Three-dot action menu (⋮): If multiple rows are checked, the action applies to all selected items:
  1. Copy link: Copies all selected links one per line.
  2. Delete from panel: Real server deletion! After confirmation, removes clients directly from the 3X-UI panel and then from the phone list (requires an active panel connection). Batch deletions show a summary dialog with Success, Failed, and any error messages.
  3. Delete from list: Removes records only from local phone storage while leaving users untouched and active on the server.

6. Support & Official Channels (Contact)

The final tab (Contact) brings together every official support channel. Tap any card to open your browser, email app, or Telegram:

• Official Website: www.foxnext.net
• Support Email: [email protected]
• GitHub Open-Source Org: BlackFoxGroup
• Official Telegram Channel: @BlackFoxVpnn
• Direct Telegram Support: @HiBlackFox
• Purchase & Service Bot: @BlackFox_Agent_Bot
• Telegram Community Group: @Black_Fox_Group