miraiv2: A JavaScript repository from m1raibot

MiraiBot

A simple Facebook Messenger Bot made by me(CatalizCS) and my brother SpermLord.

Report Bug · Request Feature

Table of Contents

Giới thiệu
Hướng dẫn cài đặt
Contributing
License
Contact

introduce

MIRAIPROJECT LÀ GÌ?

MiraiProject thật chất là một dự án mang đến Messenger một trải nghiệm mới cho người dùng bằng cách xây dựng một hệ thống bot dành riêng cho messenger facebook. Dự án này được Catalizcs(Founder) và SpermLord(Co-Founder) xây dựng và duy trì.

Installation

Sau đây là các bước cơ bản để có thể cài đặt và vận hành.

Yêu cầu

Dung lượng của máy phải trống tầm 1-2gb.
Cần một số phần mềm chỉnh sửa file, khuyến khích sử dụng notepad++ hoặc sublime text 3
Cần hiểu biết sơ lược qua về node, javascript.
Một tài khoản Facebook dùng để làm bot(Khuyến khích nên sử dụng acc đã bỏ hoặc không còn sử dụng để tránh mất acc hay acc bị khoá).
Đối với:
- Windows: Cần cài đặt windows-build-tools.
- Linux: Cần cài đặt python3 hoặc python2.
- Android Sử dụng termux để vận hành bot.

Cài Đặt

Windows

Tải về Nodejs và git sau đó cài đặt
1. Nếu bạn window 7 trở xuống và không thể cài đặt nodejs thì có thể tải file cài đặt nodejs tại đây(win 64bit) hoặc tại đây(win 32bit)
Cài đặt windows-build-tools:
1. Mở powershell với quyền adminstrator thông qua startMenu
2. Nhập
```
npm install windows-build-tools
```
Clone source code của bot
1. chuột phải ở folder cần cài đặt source code nhấn vào git bash
2. nhập
```
git clone https://github.com/miraipr0ject/miraiv2.git miraiv2
```
Cài đặt các package cần thiết
1. Mở cmd/terminal ở thư mục bot, LƯU Ý thư mục đó phải có file package.json
2. Nhập
```
npm install
```
Chỉnh sửa file config
1. Mở file config.json thông qua notepad++ hoặc sublime text 3 đã cài đặt ở trên
2. tùy chỉnh mail, password, tên bot, ...
3. Sao lưu và đóng lại
Lấy appstate
- Bạn có thể sử dụng fbstate của c3c bot, nhưng cần đổi tên lại thành appstate.json hoặc đổi lại tên trong phần config.json như bước ở trên
1. Nhập
```
node login
```
1. Nhập mã xác thực hai lớp
2. Nếu trên cmd/terminal hiện Đã ghi xong appstate tức là appstate của bạn đã được lưu lại, còn nếu ra dòng có chữ error thì appstate của bạn chưa được lưu lại, bạn cần phải kiểm tra lại thông tin tài khoản, và kiểm tra xem tài khoản của bạn có phải bị checkpoint hay không.
Chạy bot và tận hưởng
1. Nhập
```
  npm start
```
1. Đợi source code load file và tận hưởng!

Android

Sử dụng google play và tải termux

Mở termux và nhập

termux-setup-storage && apt update && apt upgrade && pkg install curl -y && bash <(curl -s https://raw.githubusercontent.com/catalizcs/storage-data/master/install.sh)

Đợi mọi package, lib cài đặt thành công là có thể sử dụng
Lấy appstate
- Bạn có thể sử dụng fbstate của c3c bot, nhưng cần đổi tên lại thành appstate.json hoặc đổi lại tên trong config.json
1. Nhập
```
node login
```
1. Nhập mã xác thực hai lớp
2. Nếu trên cmd/terminal hiện Đã ghi xong appstate tức là appstate của bạn đã được lưu lại, còn nếu ra dòng có chữ error thì appstate của bạn chưa được lưu lại, bạn cần phải kiểm tra lại thông tin tài khoản, và kiểm tra xem tài khoản của bạn có phải bị checkpoint hay không.
về cách sử dụng, edit, vận hành
1. Để bật được file manager bạn chỉ cần nhập vào termux
```
manager
```
1. Để vận hành bot, bạn chỉ cần nhập vào termux
```
cd ./miraiv2 && npm start
```

Linux/ubuntu

Cài đặt node và git bằng cách nhập vào terminal

sudo apt-get install curl
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install nodejs git sqlite3 -y
sudo npm install -g npm

Clone source code của bot bằng cách nhập vào terminal

git clone https://github.com/miraipr0ject/miraiv2.git miraiv2

Cài đặt các package cần thiết
1. Mở cmd/terminal ở thư mục bot, LƯU Ý thư mục đó phải có file package.json
2. Nhập
```
npm install
```
Chỉnh sửa file config
1. Mở file config.json thông qua notepad++ hoặc sublime text 3 đã cài đặt
2. tùy chỉnh mail, password, tên bot, ...
3. Sao lưu và đóng lại
Lấy appstate
- Bạn có thể sử dụng fbstate của c3c bot, nhưng cần đổi tên lại thành appstate.json hoặc đổi lại tên trong phần config.json như bước ở trên
1. Nhập
```
node login
```
1. Nhập mã xác thực hai lớp
2. Nếu trên cmd/terminal hiện Đã ghi xong appstate tức là appstate của bạn đã được lưu lại, còn nếu ra dòng có chữ error thì appstate của bạn chưa được lưu lại, bạn cần phải kiểm tra lại thông tin tài khoản, và kiểm tra xem tài khoản của bạn có phải bị checkpoint hay không.
Chạy bot và tận hưởng
1. Nhập
```
  npm start
```
1. Đợi source code load file và tận hưởng!

Video hướng dẫn cài đặt

Windows: Tutorial install for win 10(WIP)
Linux: Tutorial install for linux/ubuntu(WIP)
Android: Tutorial install for android using termux

Contributing

Sự đóng góp của bạn sẽ khiến cho project ngày càng tốt hơn, các bước để bạn có thể đóng góp

Fork project này
Tạo một branch mới chứa tính năng của bạn (git checkout -b feature/AmazingFeature)
Commit những gì bạn muốn đóng góp (git commit -m 'Add some AmazingFeature')
Đẩy branch chứa tính năng của bạn lên (git push origin feature/AmazingFeature)
Tạo một pull request mới và sự đóng góp của bạn đã sẵn sàng để có thể đóng góp!

License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file.

Contact

CatalizCS - Facebook - GitHub - miraiv2.official@gmail.com

SpermLord - GitHub - Facebook

m1raibot/miraiv2