📄
pasted-code-1794385512160.txt
txt
589 lines
▶
# BLUE LOCK: EGOIST FOOTBALL
## Minecraft Mod – Fabric 1.21.4
Bạn là một Senior Minecraft Mod Developer, Java Engineer, Game Designer và Multiplayer Engineer.
Hãy phát triển một Minecraft Mod bóng đá PvP lấy cảm hứng từ anime Blue Lock. Đây phải là một trò chơi bóng đá hoàn chỉnh bên trong Minecraft, không phải một bản đồ trang trí hoặc một bộ NPC đơn giản.
# PHẦN 1. CẤU HÌNH KỸ THUẬT
Bắt buộc sử dụng:
- Minecraft Java Edition: 1.21.4.
- Mod Loader: Fabric.
- Java: JDK 21.
- Fabric Loader: phiên bản tương thích Minecraft 1.21.4.
- Fabric API: phiên bản tương thích Minecraft 1.21.4.
- Fabric Loom: phiên bản tương thích dự án 1.21.4.
- Ngôn ngữ lập trình: Java.
- Build system: Gradle.
- IDE khuyến nghị: IntelliJ IDEA.
Tên mod: Blue Lock Egoist Football.
Mod ID: bluelock.
Mod phải hỗ trợ:
1. Singleplayer.
2. Multiplayer qua LAN.
3. Multiplayer qua Dedicated Server.
Không sử dụng Forge hoặc NeoForge.
Không sử dụng API dành riêng cho phiên bản Minecraft khác.
# PHẦN 2. KIẾN TRÚC DỰ ÁN
Tổ chức source code thành các module riêng biệt:
- core: quản lý hệ thống chính.
- lobby: quản lý sảnh chờ.
- match: quản lý trận đấu.
- football: quản lý bóng và vật lý bóng.
- player: quản lý người chơi và đội.
- position: quản lý vị trí thi đấu.
- character: quản lý nhân vật.
- skill: quản lý kỹ năng.
- goalkeeper: quản lý thủ môn AI.
- ui: quản lý giao diện.
- camera: quản lý camera.
- cosmetics: quản lý emote, goal effects và name tags.
- spin: quản lý hệ thống quay nhân vật.
- networking: quản lý đồng bộ Multiplayer.
- data: quản lý lưu trữ dữ liệu.
Yêu cầu:
- Không viết tất cả code trong một class.
- Mỗi hệ thống phải có nhiệm vụ riêng.
- Sử dụng OOP.
- Hạn chế code trùng lặp.
- Dễ thêm nhân vật và kỹ năng mới.
- Có thể mở rộng thành các chế độ chơi khác trong tương lai.
# PHẦN 3. SINGLEPLAYER VÀ MULTIPLAYER
Sử dụng cùng một hệ thống gameplay cho tất cả chế độ.
Singleplayer:
- Người chơi vào Lobby.
- Có thể chơi với các thủ môn AI.
- Có thể thêm Bot đồng đội và Bot đối thủ trong các bản cập nhật.
- Tất cả trận đấu chạy trên Integrated Server.
Multiplayer:
- Người chơi có thể kết nối với Dedicated Server.
- Hỗ trợ nhiều người tham gia cùng một trận.
- Đồng bộ vị trí, chuyển động, bóng, kỹ năng, điểm số và thời gian.
- Không để mỗi máy tự tính một kết quả bóng đá khác nhau.
QUY TẮC QUAN TRỌNG:
Server là nguồn dữ liệu chính (Authoritative Server).
Server xử lý:
- Vị trí và trạng thái bóng.
- Người đang sở hữu bóng.
- Tính điểm.
- Thời gian trận đấu.
- Kết quả trận đấu.
- Cooldown kỹ năng.
- Xoạc bóng và cướp bóng.
- Trạng thái choáng.
- Đội và vị trí cầu thủ.
Client xử lý:
- Camera.
- HUD.
- Hiệu ứng hình ảnh.
- Animation hiển thị.
- Input bàn phím và chuột.
- Thanh lực sút.
Client gửi yêu cầu hành động lên Server thông qua Custom Packet Payload. Server kiểm tra tính hợp lệ rồi mới thực hiện.
Không tin tưởng trực tiếp vào dữ liệu từ Client.
Không để Client tự quyết định ghi bàn hoặc tự thay đổi điểm số.
# PHẦN 4. LOBBY
Khi người chơi vào mod lần đầu, tự động đưa họ đến Lobby.
Lobby có thiết kế hiện đại theo phong cách Blue Lock:
- Màu xanh dương đậm.
- Đen.
- Ánh sáng neon.
- Các màn hình hiển thị thông tin.
- Sân tập bóng đá.
Có 5 khu vực chính:
1. PLAY: vào trận.
2. SPIN: quay nhân vật.
3. EMOTE SHOP: mua biểu cảm.
4. GOAL EFFECT SHOP: mua hiệu ứng ghi bàn.
5. NAME TAG SHOP: mua bảng tên.
Giao diện chính có hai nút lớn:
PLAY và ENTER CODE.
PLAY:
- Tìm trận.
- Tạo trận.
- Chọn chế độ.
- Vào phòng chờ.
ENTER CODE:
- Nhập mã phòng.
- Tham gia phòng riêng.
# PHẦN 5. HỆ THỐNG TRẬN ĐẤU
Sân bóng có kích thước chính xác:
- Ngang: 90 blocks.
- Dọc: 50 blocks.
Có:
- Hai khung thành.
- Đường giữa sân.
- Vòng tròn giữa sân.
- Khu vực cấm địa.
- Vạch biên.
- Hai khu vực thủ môn.
Mỗi trận kéo dài 4 phút.
Luật chiến thắng:
- Đội ghi nhiều bàn hơn khi hết giờ sẽ thắng.
- Đội dẫn trước đối thủ 5 bàn sẽ thắng ngay lập tức.
- Nếu hòa khi hết giờ, kết thúc với kết quả hòa.
- Có bảng tổng kết sau trận.
Mỗi đội có 5 vị trí:
- CF.
- RW.
- LW.
- CM.
- GK.
Khi người chơi vào trận:
1. Mở giao diện chọn vị trí.
2. Chọn vị trí muốn chơi.
3. Kiểm tra vị trí có người chọn chưa.
4. Nếu vị trí đã có người, không cho chọn.
5. Khi chọn xong, dịch chuyển người chơi đến vị trí tương ứng.
6. Mặc áo đấu theo màu đội.
Có 4 màu đội:
- Xanh biển.
- Đỏ.
- Trắng.
- Vàng.
# PHẦN 6. HỆ THỐNG BÓNG
Tạo một Ball Entity riêng, không sử dụng quả bóng vanilla.
Bóng có:
- Vật lý 3D.
- Trọng lực.
- Ma sát.
- Độ nảy.
- Tốc độ.
- Hướng di chuyển.
- Va chạm với người chơi.
- Va chạm với khung thành và mặt sân.
Khi bóng chạm vào người chơi và được xác định là đã kiểm soát:
- Bóng gắn với người đó.
- Người đó trở thành Ball Owner.
- Xuất hiện vòng tròn dưới chân.
- Vòng tròn có màu của đội đang giữ bóng.
Khi sút:
- Bóng rời khỏi người chơi.
- Tính lực sút.
- Tính hướng sút.
- Tính vận tốc bóng.
Phải có cơ chế phân biệt:
- Bóng đang tự do.
- Bóng đang được kiểm soát.
- Bóng đang bay.
- Bóng đã vào khung thành.
Không để bóng tự động dính vào người chơi khi chỉ chạm thoáng qua. Cần có kiểm tra quyền kiểm soát bóng và cơ chế tranh chấp.
# PHẦN 7. THỦ MÔN AI
Ban đầu, mỗi đội có một thủ môn máy.
Thủ môn AI:
- Di chuyển ngang theo hướng bóng.
- Đứng trước khung thành.
- Dự đoán hướng bóng.
- Bay người khi bóng tiến đến.
- Có animation bắt bóng.
- Có animation đổ người.
Tỷ lệ bắt bóng thành công ban đầu: 30%.
Tỷ lệ này phải được tính trong Server.
Thủ môn không được di chuyển xuyên qua khung thành hoặc vật cản.
# PHẦN 8. NHÂN VẬT
Có 9 nhân vật:
1. Isagi Yoichi.
2. Chigiri Hyoma.
3. Gagamaru Gin.
4. Mikage Reo.
5. Nagi Seishiro.
6. Barou Shoei.
7. Itoshi Rin.
8. Itoshi Sae.
9. Kunigami Rensuke.
Mỗi nhân vật cần có:
- Model 3D riêng.
- Skin và trang phục riêng.
- Animation chạy.
- Animation nhảy.
- Animation sút bóng.
- Animation xoạc bóng.
- Animation kỹ năng.
- Hai kỹ năng đặc biệt.
- Có thể có kỹ năng thứ ba với một số nhân vật.
Hệ thống Spin:
- Quay nhận nhân vật.
- Có hiệu ứng quay.
- Có độ hiếm.
- Có lịch sử nhân vật nhận được.
- Có thể trang bị nhân vật.
- Lưu nhân vật đã sở hữu.
# PHẦN 9. ĐIỀU KHIỂN
WASD: di chuyển.
Shift: chạy nhanh.
Space: nhảy.
Nếu bóng ở phía trên đầu, nhấn Space để đánh đầu.
Chuột trái:
- Nhấn một lần để sút nhẹ.
- Giữ để tích lực sút.
- Thanh lực tăng dần theo thời gian.
- Thả chuột để sút.
- Lực sút phụ thuộc vào thời gian giữ.
E: xoạc bóng.
- Hạ thấp người.
- Trượt về phía trước.
- Nếu va chạm hợp lệ với người đang giữ bóng, có thể cướp bóng.
- Có cooldown.
Q: xoay người.
- Xoay một vòng.
- Né xoạc bóng.
- Nếu đối thủ xoạc trúng trong lúc đang Q, đối thủ bị choáng 1 giây.
- Hiện chữ UNBREAKABLE màu đỏ trên màn hình đối thủ.
C: kỹ năng 1.
B: kỹ năng 2.
B: kỹ năng 3 đối với nhân vật có kỹ năng thứ ba. Nếu nhân vật đã có kỹ năng 2, phải thiết kế thêm cách kích hoạt không bị trùng phím, ví dụ B và giữ B hoặc một phím phụ có thể chỉnh trong Settings.
Tất cả phím điều khiển phải tùy chỉnh được trong Minecraft Controls.
# PHẦN 10. ISAGI YOICHI – NHÂN VẬT ĐẦU TIÊN
Ưu tiên làm Isagi hoàn chỉnh trước.
Chỉ số ban đầu:
- Speed: 75.
- Shooting: 85.
- Dribbling: 80.
- Defense: 60.
- Control: 85.
## Skill 1: DIRECT SHOT
Phím C.
Cơ chế:
- Có thể nhấn hoặc giữ C.
- Khi thả C, Isagi lập tức sút bóng.
- Bóng bay cực nhanh.
- Tầm sút khoảng 10 blocks.
- Hướng sút theo hướng nhân vật đang nhìn.
- Có animation sút.
- Có hiệu ứng năng lượng xanh.
- Có âm thanh riêng.
Đây là cú sút nhanh ở cự ly ngắn, không phải cú sút xa toàn sân.
Nếu không có bóng, không được kích hoạt kỹ năng.
## Skill 2: BREAKTHROUGH
Phím B.
Chỉ sử dụng khi Isagi đang có bóng.
Cơ chế:
- Isagi lao nhanh về phía trước.
- Có animation tăng tốc.
- Có hiệu ứng tốc độ xanh.
- Khi đi qua vùng va chạm của đối thủ, đối thủ bị choáng 0,5 giây.
- Không thể xuyên qua tường hoặc vật cản.
- Có cooldown.
- Không thể sử dụng liên tục.
# PHẦN 11. CAMERA VÀ GOAL EFFECTS
Khi ghi bàn:
1. Xác định người ghi bàn.
2. Tạm dừng gameplay.
3. Camera chuyển về người ghi bàn.
4. Zoom vào nhân vật.
5. Hiện tên nhân vật.
6. Hiện tên người ghi bàn.
7. Hiện dòng chữ GOAL!
8. Kích hoạt hiệu ứng ghi bàn.
9. Phát âm thanh.
10. Sau 3–5 giây, quay về camera bình thường.
11. Đưa bóng về giữa sân.
Các hiệu ứng:
- Blue Explosion.
- Red Lightning.
- Golden Aura.
- White Flash.
Cho phép thay đổi Goal Effect trong Shop.
# PHẦN 12. GIAO DIỆN HUD
Trong trận đấu:
Trên cùng:
- Tỷ số.
- Tên hai đội.
- Đồng hồ 4 phút.
Phía dưới:
- Thanh lực sút.
- Thanh thể lực.
- Kỹ năng C.
- Kỹ năng B.
- Cooldown kỹ năng.
Góc màn hình:
- Tên nhân vật.
- Vị trí thi đấu.
- Trạng thái có bóng hay không.
Khi bị choáng:
- Hiển thị hiệu ứng choáng.
- Vô hiệu hóa điều khiển trong thời gian choáng.
# PHẦN 13. HỆ THỐNG LƯU DỮ LIỆU
Sử dụng Persistent State phù hợp với từng loại dữ liệu.
Lưu:
- Nhân vật đã sở hữu.
- Nhân vật đang trang bị.
- Tiền trong game.
- Emote đã mua.
- Goal Effect đã mua.
- Name Tag đã mua.
- Các thiết lập cá nhân.
Dữ liệu người chơi cần được lưu theo UUID.
Trong Dedicated Server, dữ liệu phải được quản lý phía Server.
Không lưu tiến trình người chơi chỉ trong biến RAM.
Có cơ chế xử lý khi người chơi thoát giữa trận.
# PHẦN 14. KIẾN TRÚC NETWORKING
Tạo hệ thống Custom Payload riêng cho từng nhóm hành động.
Client to Server:
- RequestJoinMatch.
- RequestCreateRoom.
- RequestJoinRoom.
- RequestSelectPosition.
- RequestShootBall.
- RequestUseSkill.
- RequestTackle.
- RequestDribble.
- RequestJump.
- RequestEquipCharacter.
- RequestSpin.
Server to Client:
- MatchStateUpdate.
- BallStateUpdate.
- ScoreUpdate.
- TimerUpdate.
- GoalScored.
- SkillStateUpdate.
- PlayerPositionUpdate.
- CharacterDataUpdate.
- RoomCodeUpdate.
Mọi hành động đều phải được kiểm tra:
- Người chơi có đang ở trong trận không.
- Người chơi có quyền sử dụng kỹ năng không.
- Có đủ cooldown không.
- Có đang bị choáng không.
- Có đang giữ bóng không.
- Có nằm trong khoảng cách hợp lệ không.
Tối ưu tần suất gửi dữ liệu bóng, không gửi quá nhiều packet không cần thiết.
# PHẦN 15. CẤU TRÚC FILE
Tạo cấu trúc dự án dễ quản lý:
src/main/java/.../
BlueLockMod.java
core/
lobby/
match/
football/
player/
position/
character/
skill/
goalkeeper/
networking/
data/
cosmetics/
src/client/java/.../
BlueLockClient.java
camera/
renderer/
animation/
hud/
input/
screen/
src/main/resources/
fabric.mod.json
assets/bluelock/
textures/
models/
animations/
sounds/
lang/
particles/
gui/
Không bắt buộc phải dùng chính xác cấu trúc trên nếu có cách tổ chức tốt hơn, nhưng phải giữ sự phân chia Client và Common hợp lý.
# PHẦN 16. PHƯƠNG PHÁP PHÁT TRIỂN
Không được viết toàn bộ dự án trong một lần rồi bỏ mặc lỗi.
Chia thành các giai đoạn:
GIAI ĐOẠN 1:
- Khởi tạo Fabric Mod.
- Tạo Lobby.
- Tạo giao diện chính.
- Build thành công.
GIAI ĐOẠN 2:
- Tạo sân bóng 90 × 50.
- Tạo Ball Entity.
- Tạo vật lý bóng.
- Tạo cơ chế ghi bàn.
GIAI ĐOẠN 3:
- Tạo hệ thống đội.
- Chọn vị trí.
- Tạo đồng hồ và bảng tỷ số.
- Tạo luật chiến thắng.
GIAI ĐOẠN 4:
- Tạo Isagi.
- Tạo animation.
- Tạo Direct Shot.
- Tạo Breakthrough.
GIAI ĐOẠN 5:
- Hoàn thiện hệ thống Multiplayer.
- Kiểm tra đồng bộ.
- Kiểm tra Dedicated Server.
GIAI ĐOẠN 6:
- Tạo thủ môn AI.
- Tạo camera cinematic.
- Tạo hiệu ứng ghi bàn.
GIAI ĐOẠN 7:
- Tạo Spin.
- Thêm 8 nhân vật còn lại.
- Thêm Shop.
- Thêm Emote.
- Thêm Goal Effects.
- Thêm Name Tags.
GIAI ĐOẠN 8:
- Kiểm tra toàn bộ gameplay.
- Sửa lỗi.
- Tối ưu FPS.
- Kiểm tra nhiều người chơi.
- Đóng gói file .jar.
# PHẦN 17. TIÊU CHUẨN HOÀN THÀNH
Chỉ coi một giai đoạn hoàn thành khi:
- Code biên dịch thành công.
- Không có lỗi nghiêm trọng khi khởi động game.
- Chức năng thực sự hoạt động.
- Multiplayer không bị desync.
- Không có nút giao diện giả.
- Có hướng dẫn kiểm thử.
- Không phá hỏng những chức năng đã hoàn thành trước đó.
Sau mỗi giai đoạn:
1. Liệt kê file đã tạo.
2. Cung cấp toàn bộ code cần thiết.
3. Chạy Gradle build.
4. Sửa tất cả lỗi biên dịch.
5. Hướng dẫn cách chạy Minecraft để kiểm tra.
6. Chỉ chuyển sang giai đoạn tiếp theo khi giai đoạn hiện tại hoạt động.
# YÊU CẦU CUỐI CÙNG
Hãy bắt đầu bằng việc tạo một Fabric Mod project hoàn chỉnh dành cho Minecraft 1.21.4.
Đầu tiên, kiểm tra các dependency và phiên bản tương thích.
Sau đó tạo cấu trúc dự án, đăng ký mod và xây dựng Lobby cơ bản.
Không chỉ đưa ra hướng dẫn hoặc code minh họa. Hãy trực tiếp tạo và chỉnh sửa các file trong workspace nếu môi trường hỗ trợ.
Nếu thiếu công cụ hoặc không thể chạy Minecraft để kiểm thử, hãy nói rõ, không được giả vờ rằng mod đã chạy thành công.
Ưu tiên chất lượng gameplay, hệ thống bóng, kỹ năng Isagi và Multiplayer trước các tính năng trang trí.
Mục tiêu cuối cùng là một Minecraft Blue Lock Mod có thể chơi thực sự, có thể đóng gói thành file .jar và cài vào Minecraft Fabric 1.21.4.
Khởi tạo Fabric 1.21.4 và tách mã client/server.
Tạo giao diện sảnh cơ bản và lệnh thông tin, không thêm nút giả cho chức năng chưa có.
Nêu rõ những phần chưa thể kiểm thử hoặc chưa triển khai.
Đã tạo bộ khung Fabric 1.21.4 và giao diện sảnh cơ bản. Trong thế giới, nhấn O để mở giao diện; phím này có thể đổi trong Controls. Lệnh /bluelock hiển thị thông tin trạng thái.
Chưa hoàn thành giai đoạn 1: sảnh hiện chỉ là giao diện thông báo, chưa có khu vực Lobby, PLAY hay ENTER CODE. Các hệ thống sân, bóng, trận đấu, nhân vật và multiplayer cũng chưa được triển khai.
Các phiên bản dependency đã được khai báo, nhưng chưa xác minh bằng build. Tôi không thể chạy Gradle hoặc Minecraft trong môi trường này, nên chưa thể xác nhận mod biên dịch hay hoạt động.
Để kiểm tra, nhấn Compile trên thanh trên cùng, rồi Compile trong cửa sổ mở ra. Nếu build thất bại, chọn Auto-fix trong chat hoặc Fix trong cửa sổ build.
package com.bluelock;
import com.bluelock.lobby.LobbyCommands;
import net.fabricmc.api.ModInitializer;
public final class BlueLockMod implements ModInitializer {
@Override
public void onInitialize() {
LobbyCommands.register();
}
}