# postbit-dice
Postbit interface for triggering simple randomized dice rolls.

### Pre-Installation
postbit-dice makes use of a hardcoded user with uid 999999999. If this user id isn't available, installation will fail or cause unintended behavior.  
The user and post creation makes SQL queries to the builtin _posts and _users tables. If other plugins make additional fields to these tables without well defined defaults, postbit-dice may create 'broken' posts/user accounts/tables.  
Attempt installation with existing plugins in a test environment beforehand.  

### Installation
Copy the files into the root of the MyBB installation. This should merge the contents of the inc/plugin folder with the existing one.  
The plugin should appear in the MyBB plugin manager in the Admin CP as 'Postbit Dice'. Select the 'Install & Activate' option.  

### Usage
After installation, each post will have a 'Roll Dice' option for admins to the left of the 'Edit' button. The button will trigger a pop-over window similar to the default report button with three fields:  
- # of rolls => Number of times to roll the dice.  
- Lower bound/Upper bound => INCLUSIVE Range of values to return on the dice roll.

On submission, the thread will be replied to with the resulting random values.  
Currently, only users with admin permissions can see the results of and trigger dice rolls.

# xúc xắc postbit
Giao diện Postbit để kích hoạt tung xúc xắc ngẫu nhiên đơn giản.

### Cài đặt trước
postbit-dice sử dụng người dùng được mã hóa cứng với Uid 999999999. Nếu id người dùng này không khả dụng, cài đặt sẽ không thành công hoặc gây ra hành vi ngoài ý muốn.  
Việc tạo người dùng và bài đăng thực hiện các truy vấn SQL đến các bảng _posts và _users tích hợp sẵn. Nếu các plugin khác tạo các trường bổ sung cho các bảng này mà không có mặc định được xác định rõ ràng, postbit-dice có thể tạo ra các bài đăng/tài khoản người dùng/bảng 'bị hỏng'.  
Thử cài đặt với các plugin hiện có trong môi trường thử nghiệm trước.  

### Cài đặt
Sao chép các tập tin vào thư mục gốc của cài đặt MyBB. Điều này sẽ hợp nhất nội dung của thư mục inc/plugin với thư mục hiện có.  
Plugin sẽ xuất hiện trong trình quản lý plugin MyBB trong Admin CP dưới dạng 'Postbit Dice'. Chọn tùy chọn 'Cài đặt & Kích hoạt'.  

### Cách sử dụng
Sau khi cài đặt, mỗi bài đăng sẽ có tùy chọn 'Tung xúc xắc' cho quản trị viên ở bên trái nút 'Chỉnh sửa'. Nút này sẽ kích hoạt một cửa sổ bật lên tương tự như nút báo cáo mặc định với ba trường:  
- # cuộn => Số lần tung xúc xắc.  
- Giới hạn dưới/Giới hạn trên => BAO GỒM Phạm vi giá trị để trả về khi tung xúc xắc.

Khi gửi, luồng sẽ được trả lời với các giá trị ngẫu nhiên kết quả.  
Hiện tại, chỉ những người dùng có quyền quản trị mới có thể xem kết quả và kích hoạt tung xúc xắc.