Paper 1.21.11+ Kotlin 2.1 TabooLib 6.3 Folia supported Buffer-pure Input

ShinnUI Wiki

Tài liệu tiếng Việt chính thức cho ShinnUI — plugin menu thế hệ mới cho Paper, được xây dựng lại từ TrMenu trên nền Kotlin + TabooLib. Tạo GUI không giới hạn, tuỳ biến sâu: Input Menu buffer-pure, 5 Render-Type, action random:, catcher validation, Effect Packs và 3 ngôn ngữ script (Kether · JavaScript · JEXL).

🚀 Bắt đầu cài đặt 🧺 Input Menu 🎭 Render-Type

🧺

Input Menu#3>
Kéo-thả vật phẩm vào GUI với mô hình buffer-pure — kho thật không bị trừ cho tới khi bạn commit bằng action `input`. Hỗ trợ `required` per-slot, overflow và withdraw.
Tìm hiểu →

🎭

5 Render-Type#3>
Cùng một file menu — 5 kiểu hiển thị: CHEST, ENCHANT (bàn phù phép), MERCHANT (giao dịch villager), DISPLAY (hologram trong thế giới) và BOOK (menu dạng sách).
Tìm hiểu →

🎲

Action `random:`#3>
Chọn nhánh theo trọng số — mỗi lần click roll đúng 1 nhánh, hỗ trợ `else` và điều kiện lồng nhau. Khác với option inline `{chance=X}` là gate xác suất cho action đơn.
Tìm hiểu →

✅

Catcher Validation#3>
Kiểm tra input bằng regex từng stage trước khi lưu meta. Nhập sai → reaction `fail:` riêng, có thể `retype` để hỏi lại. Mỗi stage giữ meta riêng `input-<stage>`.
Tìm hiểu →

💥

Effect Packs#3>
Gói âm thanh + hạt hiệu ứng đặt tên một lần trong settings.yml, dùng chung mọi menu qua action `effect:`. Đổi theme server = sửa 1 chỗ.
Tìm hiểu →

🔮

Kether · JS · JEXL#3>
Ba ngôn ngữ script ngay trong menu: Kether (mặc định), JavaScript (Nashorn/GraalJS) và Apache JEXL — dùng cho action, condition, biến và function nội bộ.
Tìm hiểu →

ShinnUI là gì?#2>
ShinnUI là fork/rework của TrMenu — plugin menu nổi tiếng viết bằng Kotlin trên nền TabooLib. Fork giữ nguyên khả năng bám theo upstream nhưng được xây dựng lại với các tính năng mới:

Điểm Chi tiết

Phiên bản server Paper `1.21.11+`, Folia supported, API-level 1.13, Java 21.

Input Menu Hệ thống kéo-vật-phẩm-vào-GUI viết lại hoàn toàn theo mô hình buffer-pure, kèm `required` per-slot và thông báo thiếu đồ cấu hình được.

Item Matcher Bổ sung trait `enchant:`, `pdc:` (namespace mặc định `shinnui`), `nbt:` ngoài các trait cũ (material, name, lore, model-data…).

Render-Type 5 loại: `WINDOW`, `ENCHANT`, `MERCHANT`, `DISPLAY` (hologram qua FancyHolograms), `BOOK` (sách packet-based).

Lệnh `/shinnui` (alias `/sui`, `/shui`), quyền `shinnui.use` để dùng menu.

Ngôn ngữ Bundle lang `vi_VN` (Tiếng Việt).

Điểm	Chi tiết
Phiên bản server	Paper `1.21.11+`, Folia supported, API-level 1.13, Java 21.
Input Menu	Hệ thống kéo-vật-phẩm-vào-GUI viết lại hoàn toàn theo mô hình buffer-pure, kèm `required` per-slot và thông báo thiếu đồ cấu hình được.
Item Matcher	Bổ sung trait `enchant:`, `pdc:` (namespace mặc định `shinnui`), `nbt:` ngoài các trait cũ (material, name, lore, model-data…).
Render-Type	5 loại: `WINDOW`, `ENCHANT`, `MERCHANT`, `DISPLAY` (hologram qua FancyHolograms), `BOOK` (sách packet-based).
Lệnh	`/shinnui` (alias `/sui`, `/shui`), quyền `shinnui.use` để dùng menu.
Ngôn ngữ	Bundle lang `vi_VN` (Tiếng Việt).

Bắt đầu nhanh#2>

Tải ShinnUI-1.0-beta.jar, thả vào plugins/, khởi động lại server — xem chi tiết ở Cài đặt.
Mở menu demo đầu tiên: /shinnui open Example.
Liệt kê menu đã nạp: /shinnui list. Xem hết lệnh ở Lệnh & Quyền.
Sửa hoặc tạo menu trong plugins/ShinnUI/menus/ — cấu trúc file ở Cấu trúc menu.

/shinnui open Example        # mở menu demo
/shinnui list                # liệt kê menu
/shinnui reload              # tải lại toàn bộ
/shinnui effects             # xem gói hiệu ứng

Mục lục nhanh#2>

Nhóm Trang

Bắt đầu Cài đặt · Lệnh & Quyền

Menu Cấu trúc menu · Icon · Action · Condition · Catcher

Render-Type 5 loại hiển thị

Fork Input Menu · Item Matcher

Nhóm Trang

Biến & Script Placeholder · Functions · JavaScript · Kether

Tích hợp PlaceholderAPI · Plugin hỗ trợ · API cho dev

Menu mẫu 13 file demo trong `menus/` — `Input-Demo`, `Book-Demo`, `Merchant-Demo`, `Random-Demo`…

Wiki này viết dựa trên source code thực tế của ShinnUI (kèm tài liệu gốc trmenu.trixey.cc làm tham chiếu), nên các thông số như tên key YAML, giá trị mặc định và hành vi action đều khớp với bản `1.0-beta` bạn đang dùng.

SAU →
Cài đặt

ShinnUI Wiki (VI) — biên soạn từ source code GitHub · TrMenu gốc

Nhóm	Trang
Bắt đầu	Cài đặt · Lệnh & Quyền
Menu	Cấu trúc menu · Icon · Action · Condition · Catcher
Render-Type	5 loại hiển thị
Fork	Input Menu · Item Matcher

Nhóm	Trang
Biến & Script	Placeholder · Functions · JavaScript · Kether
Tích hợp	PlaceholderAPI · Plugin hỗ trợ · API cho dev
Menu mẫu	13 file demo trong `menus/` — `Input-Demo`, `Book-Demo`, `Merchant-Demo`, `Random-Demo`…

ShinnUI Wiki

Input Menu#3> Kéo-thả vật phẩm vào GUI với mô hình buffer-pure — kho thật không bị trừ cho tới khi bạn commit bằng action input. Hỗ trợ required per-slot, overflow và withdraw. Tìm hiểu →

5 Render-Type#3> Cùng một file menu — 5 kiểu hiển thị: CHEST, ENCHANT (bàn phù phép), MERCHANT (giao dịch villager), DISPLAY (hologram trong thế giới) và BOOK (menu dạng sách). Tìm hiểu →

Action random:#3> Chọn nhánh theo trọng số — mỗi lần click roll đúng 1 nhánh, hỗ trợ else và điều kiện lồng nhau. Khác với option inline {chance=X} là gate xác suất cho action đơn. Tìm hiểu →

Catcher Validation#3> Kiểm tra input bằng regex từng stage trước khi lưu meta. Nhập sai → reaction fail: riêng, có thể retype để hỏi lại. Mỗi stage giữ meta riêng input-<stage>. Tìm hiểu →

Effect Packs#3> Gói âm thanh + hạt hiệu ứng đặt tên một lần trong settings.yml, dùng chung mọi menu qua action effect:. Đổi theme server = sửa 1 chỗ. Tìm hiểu →

Kether · JS · JEXL#3> Ba ngôn ngữ script ngay trong menu: Kether (mặc định), JavaScript (Nashorn/GraalJS) và Apache JEXL — dùng cho action, condition, biến và function nội bộ. Tìm hiểu →