Prickle Mod cho Minecraft 1.21, 26.3

Prickle là một định dạng cấu hình dựa trên JSON. Mod này cho phép định dạng này được sử dụng trong Minecraft! Để xem tài liệu kỹ thuật, vui lòng xem trang GitHub.

Câu hỏi thường gặp

Prickle mang lại những lợi ích gì? Prickle dựa trên JSON nhưng bổ sung một số tính năng hữu ích như chú thích và decorator. Prickle tương thích ngược 100% với JSON và hỗ trợ tất cả các tính năng, công cụ và tô sáng cú pháp của nó.

Tại sao lại gọi là Prickle? Prickle là danh từ tập hợp chỉ một nhóm nhím. Nhím là một trong những loài động vật yêu thích của tôi và tôi nghĩ chúng là một phép ẩn dụ phù hợp cho các tệp cấu hình. Ví dụ, cả hai đều có thể trông đáng sợ lúc đầu nhưng lại trở nên dễ chịu một khi bạn làm quen và hiểu chúng.

Tại sao không dùng một định dạng có sẵn? Trước đây tôi đã dùng JSON cho các tệp cấu hình của mình nhưng có một số vấn đề như thiếu chú thích và giá trị mặc định. Prickle bổ sung những tính năng này vào JSON trong khi vẫn tương thích ngược 100%. Tôi đã thử các định dạng khác như TOML nhưng thất vọng với nhiều bản triển khai Java của chúng. Chúng thường thiếu những tính năng tôi cho là quan trọng, có lỗi nghiêm trọng và không còn được bảo trì nữa. Minecraft đã sử dụng JSON cho datapack và lệnh, khiến nó trở thành lựa chọn quen thuộc với hầu hết người chơi.

Thông số kỹ thuật định dạng

Trong Prickle, các giá trị thuộc tính được bọc trong một đối tượng JSON. Điều này cho phép gán metadata như chú thích cho thuộc tính đó.

Ví dụ, một tệp JSON tiêu chuẩn sẽ trông như thế này.

{ "databasehost": "192.168.1.222" }

Cùng một JSON đó dưới dạng tệp Prickle sẽ trông như thế này.

{ "databasehost": { "//": "The IP address of the database to connect to.", "value": "192.168.1.222" } }

Chú thích

Khóa // được dành riêng cho chú thích. Chú thích chỉ được dùng để cung cấp thêm ngữ cảnh cho người đọc và không bao giờ được ảnh hưởng đến cách tệp được phân tích cú pháp. Chú thích có thể là một chuỗi JSON hoặc một mảng chuỗi cho chú thích nhiều dòng.

{ "databasehost": { "//": [ "The IP address of the database to connect to.", "The port can be defined at the end using an :" ], "value": "192.168.1.222:1273" } }

Decorator

Decorator là các chú thích có tên truyền đạt một thuộc tính cụ thể của thuộc tính đó. Một ví dụ phổ biến của decorator là //default, có thể được dùng để hiển thị giá trị mặc định của thuộc tính. Giống như chú thích, decorator không ảnh hưởng đến cách tệp được phân tích cú pháp, chúng chỉ mô tả cách thuộc tính sẽ được phân tích cú pháp.

Bạn có thể gặp một số decorator sau trong các tệp prickle.

• //default - Giá trị mặc định của thuộc tính.
• //reference - Một tài nguyên có thể được dùng để tìm hiểu thêm, như liên kết đến một trang wiki.
• //range - Phạm vi chấp nhận được cho một giá trị. Ví dụ >=5.
• //regex - Một mẫu regex mà giá trị phải khớp.
• //empty-allowed - Giá trị có thể để trống hay không. (mặc định là true).

Nhà tài trợ

Dự án này được tài trợ bởi Nodecraft. Sử dụng mã DARKHAX để được giảm 30% cho tháng dịch vụ đầu tiên của bạn!