Neskol/MaiLib

🎵 MaiLib - Thư viện phân tích biểu đồ maimai bằng C#

MaiLib là một thư viện C# giúp phân tích và thao tác với các biểu đồ (chart) của trò chơi rhythm điện tử maimai, hỗ trợ cả định dạng MA2 và Simai.

MaiLib là một thư viện parser dùng cho việc giải mã và thao tác với các biểu đồ của game rhythm điện tử maimai. Dù ban đầu được thiết kế để hỗ trợ maimai, cấu trúc của nó vẫn giữ khả năng mở rộng cho các trò chơi khác. Thư viện hiện hỗ trợ hai định dạng chính: MA2 – mã giả dễ máy đọc của maimai chính thức, và Simai – mã giả dễ con người đọc, được sử dụng rộng rãi trong các phần mềm chơi chart.

✨ Điểm nổi bật

• Hỗ trợ 2 định dạng chart: MA2 (mã giản máy tính) và Simai (mã giản con người).
• Cấu trúc Tokenizer-Parser-Compiler: xử lý file theo mô hình chuẩn, sử dụng cây cú pháp trừu tượng (AST).
• Lớp Chart trung gian: hỗ trợ tương thích giữa các định dạng, dễ dàng mở rộng cho định dạng mới.
• Dễ tích hợp: hỗ trợ thêm dưới dạng submodule Git hoặc build trực tiếp bằng dotnet.
• Ví dụ thực tế: MaichartConverter – công cụ chuyển đổi giữa Simai và MA2.
• Tài liệu tham khảo rõ ràng: có hướng dẫn sử dụng, cấu hình đường dẫn và ví dụ trong VSCode.

💡 Vì sao đáng chú ý

MaiLib nổi bật bởi khả năng hỗ trợ đồng thời hai định dạng chart phổ biến trong cộng đồng maimai, đồng thời áp dụng kiến trúc rõ ràng (Tokenizer-Parser-Compiler) giúp dễ dàng mở rộng. Đây là lựa chọn lý tưởng cho các nhà phát triển muốn xây dựng công cụ chuyển đổi, phân tích hoặc tạo chart cho maimai, đặc biệt khi kết hợp với dự án như MaichartConverter.

---

#maimai #CSharp #ParserLibrary #RhythmGame #OpenSource #TiniX