Giới thiệu sản phẩm
Source server Avatar 2D Java Socket và MySQL
Bộ mã nguồn Avatar 2D dành cho người nghiên cứu game online dạng socket, gồm source Java, database mẫu, dữ liệu game, tài nguyên HD/Medium và file avatar-server.jar chạy sẵn. Người phát triển có thể tìm hiểu xử lý session, message theo command, bản đồ, nhân vật và các dịch vụ trong server.
Chức năng và dữ liệu có trong source
- Tài khoản, tạo nhân vật, đăng nhập, đổi mật khẩu và lưu trạng thái người chơi.
- Bản đồ nhiều zone, di chuyển, chat, NPC và menu tương tác.
- Vật phẩm, trang bị, rương, shop và thời hạn sử dụng.
- Nhà, vật phẩm trang trí, dữ liệu farm và inventory nông trại.
- Vòng quay DialLucky với cấu hình phần thưởng trong database.
- Các bảng giftcode, giftcode_use và giaodich_logs để nghiên cứu hoặc phát triển tiếp.
Công nghệ và cấu trúc
Server dùng Java Socket, MySQL, HikariCP, MySQL Connector/J cùng các thư viện JSON và logging. Source có pom.xml, class chính avatar.server.Avatar, database/avatar.sql và tài nguyên trong res/hd, res/medium, res/data. Cấu hình database và server tách trong database.properties và config.properties.
Chuẩn bị môi trường
Cần Windows hoặc Linux, Java JDK 11 trở lên (khuyến nghị JDK 17) và MySQL 5.7/8 hoặc MariaDB tương thích. Import database/avatar.sql, cập nhật kết nối database rồi kiểm tra IP, cổng và đường dẫn tài nguyên. Cổng game mặc định là 19128; khi chạy online cần cấu hình firewall tương ứng.
Lưu ý khóa cấu hình mật khẩu database
Phiên bản hiện tại có chỗ đọc khóa passeword trong src/main/java/avatar/db/DbManager.java. Nếu database có mật khẩu, cần sửa phần đọc thành props.getProperty("password") hoặc khai báo khóa passeword tương ứng trong database.properties. Không đưa thông tin kết nối thật lên nội dung công khai.
Khởi chạy và build lại
Trong thư mục FULLSOURCEAVATAR, có thể thử file chạy sẵn bằng java -jar avatar-server.jar. Ví dụ giới hạn bộ nhớ JVM: java -Xms512m -Xmx2g -jar avatar-server.jar. Theo dõi log khởi động và kết nối client tương ứng trước khi sử dụng.
Để nghiên cứu source, mở dự án Maven trong IDE hỗ trợ Java và chạy class avatar.server.Avatar. Có thể build bằng mvn clean package, nhưng pom.xml hiện chưa cấu hình đầy đủ plugin tạo fat jar: file trong target có thể cần bổ sung dependency để chạy độc lập. File avatar-server.jar ở thư mục gốc đã kèm dependency.
Phạm vi sản phẩm
Đây là mã nguồn server và dữ liệu đi kèm để học tập, tham khảo và phát triển. Nên xác nhận client tương thích, tình trạng từng module và yêu cầu triển khai trước khi sử dụng cho dự án riêng.