This project is a launcher for the game Blade & Soul, designed for connecting to a private game server. The launcher provides users with an intuitive interface for registration, login, and server connection settings.
This launcher is designed to work only with specific API servers, which can be downloaded from the following links:
- Screenshots
- Key Features
- Requirements
- Installation
- Usage
- File Structure
- Encryption
- Notifications
- Dependencies
- Latest Release
- License
Click to see more screenshots
- User Registration & Login: Allows users to create an account and sign in to the game using a secure registration and login system.
- Configuration Management: Users can configure server IP addresses and choose between 32-bit or 64-bit architectures for the game client.
- Data Encryption: Sensitive data, such as registration information, is encrypted using AES-256-CBC before being saved to disk.
- Notifications: Toastr notifications provide feedback to users for various actions like saving settings, registration success, and errors.
- Server Connectivity Check: Users can verify server availability by checking the IP address directly from the launcher.
- Game Version Display: The launcher displays the current version of the game client upon successful loading.
- Platform Compatibility: The launcher can switch between 32-bit and 64-bit game client architectures.
- Social Links Integration: Social media icons allow users to open external links directly from the launcher.
- Node.js
- Electron
- npm (Node Package Manager)
-
Clone the repository:
git clone https://github.com/war100ck/blade-soul-game-launcher.git cd blade-soul-game-launcher -
Ensure you have all necessary dependencies installed, including Node.js and npm. Before building the launcher, run the following command to install all required packages:
npm install
-
Build the launcher using the command:
npm run build
If you prefer not to build the launcher manually, you can download the pre-built version from the Releases section and proceed to step 6 in the installation instructions to complete the setup and start using the launcher.
To reduce the size of the launcher files and improve loading times, it is recommended to compress JavaScript, CSS, HTML, and all image files before building the launcher. This process not only minimizes the file size but also enhances the overall performance of the launcher by speeding up resource loading. Utilizing tools like UglifyJS for JavaScript, CSSNano for CSS, and image optimization tools can help achieve significant reductions in file sizes without compromising quality.
-
After building, the project release will be located in the folder:
blade-soul-game-launcher/release/win-unpacked/ -
In this folder, you will find the executable file BNS_Launcher.exe.
6. File Transfer: Copy the following files to the Blade & Soul game folder:
Blade & Soul game folder
│
├── BIN/ # folder with 32-bit game files
│ ├── (game files) # executable files and libraries are located here
│
├── BIN64/ # folder with 64-bit game files
│ ├── (game files) # 64-bit versions of executable files and libraries are located here
│
├── ────────────────────────────────
│
│ # Game Launcher Files
│
├── locales/ # folder with localization files
│ ├── en-US.pak # localization for English (US)
│ ├── ru-RU.pak # localization for Russian
│ ├── de-DE.pak # localization for German
│ ├── fr-FR.pak # localization for French
│ └── (other localization files) # translation files for the game
│
├── resources/ # folder with game resources
│ ├── app.asar # archive containing the application code and game resources
│ └── (other resources) # various game resources such as graphics and sound files
│
├── BNS_Launcher.exe # executable file for the game launcher
│
├── chrome_100_percent.pak # resource package for the user interface
│
├── chrome_200_percent.pak # resource package for the user interface (high resolution)
│
├── d3dcompiler_47.dll # Direct3D library for shader compilation
│
├── ffmpeg.dll # library for audio and video processing
│
├── icudtl.dat # ICU (International Components for Unicode) data
│
├── libEGL.dll # OpenGL ES library for graphics management
│
├── libGLESv2.dll # OpenGL ES 2.0 library
│
├── LICENSE.electron.txt # license for Electron
│
├── LICENSES.chromium.html # licenses for Chromium
│
├── resources.pak # resource package for the game
│
├── snapshot_blob.bin # binary file with snapshots of the state
│
├── v8_context_snapshot.bin # snapshot of the V8 context state
│
├── vk_swiftshader.dll # library for software implementation of Vulkan
│
├── vk_swiftshader_icd.json # configuration file for SwiftShader
│
└── vulkan-1.dll # library for Vulkan API
Follow these steps for the initial setup of the Blade & Soul Game Launcher:
-
File Transfer: After building the launcher, copy the contents from the
blade-soul-game-launcher/release/win-unpacked/folder to your Blade & Soul game directory. -
Launch the Launcher: Open the BNS_Launcher.exe file to start the launcher.
-
Open the Settings Panel:
- Click on the settings icon in the top bar to access the configuration panel.
-
Configure Server Settings:
- Enter the IP address of the Blade & Soul private server in the designated field.
- Click the Check Connection button to verify server availability.
-
Select Game Architecture:
- Choose your desired game architecture (32-bit or 64-bit) from the options provided.
-
Save Configuration:
- After entering the server IP and selecting the architecture, click the Save Configuration button to apply the changes.
- Note: This step only needs to be done once, prior to the first launch of the game.
-
Restart the Launcher:
- Close the launcher and reopen it to refresh the configuration with your new settings.
-
User Registration:
- Click on the registration icon in the top bar to open the registration panel.
- Fill in the required fields (nickname, email, and password) and complete the registration process.
-
Start the Game:
- After successful registration or if you already have an account, log in using your credentials.
- Click the Play button to launch the Blade & Soul game client.
By following these steps, you will ensure that the launcher is correctly configured for your game experience.
Upon first launch, the user can configure the following settings:
- Server IP: The IP address of the Blade & Soul private server.
- Architecture: Select between 32-bit (
x32) or 64-bit (x64) game client.
These settings are saved to a configuration file (config.json), which can be found in the data folder of the launcher directory. If the folder does not exist, it will be created automatically.
- Registration: Users can register a new account by providing a nickname, email, and password. The registration data is encrypted and saved locally.
- Login: After registering, users can log in with their email and password to start the game.
After configuring the settings and logging in, users can launch the game by clicking the "Play" button. The launcher sends a signal to start the Blade & Soul client using the selected configuration (32-bit or 64-bit).
Users can access social media or external links by clicking on the provided icons. These links will open in the user's default web browser.
script.js: The core functionality of the launcher is implemented in this file. It handles encryption, configuration management, user registration, and server communication.data/config.json: Stores the user's configuration (e.g., server IP and client architecture).data/data.json: Stores encrypted user registration data (nickname, email, and password).
The launcher uses AES-256-CBC encryption to secure sensitive information like user registration data. The key for encryption is derived from a predefined secret using the crypto.scryptSync method, and the data is encrypted before being saved locally.
The launcher utilizes Toastr for displaying notifications to users. These notifications inform the user of events such as:
- Successful configuration saves
- Registration and login successes or failures
- Errors during any process
This project uses the following Node.js modules:
- electron: Used for building cross-platform desktop apps.
- fs: Node.js built-in module for file system operations.
- path: Node.js built-in module for handling file and directory paths.
- crypto: Node.js built-in module for cryptographic functions.
- toastr: Library for displaying non-blocking notifications.
You can find the latest version of the Blade & Soul Game Launcher at the releases page. This page includes all available versions.
Note: The game server for this launcher can be downloaded from https://github.com/war100ck/BnS-Api-Server - 2020 or https://github.com/war100ck/Server-Api-BnS-2017 - 2017.
This project is licensed under the MIT License - see the LICENSE file for details.
For further information and discussions related to the Blade & Soul Game API Server and Game Launcher, visit the active discussion on the forum:
Here you will find project details, exchange of experiences, and solutions to various technical issues related to the setup and launch of the Blade & Soul API server.