49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Spigot Quest Board
|
|
|
|
A Purpur 26.2 plugin for shared physical quest boards. Players can escrow rewards for requested block items, deliver those blocks at any quest board, and claim delivered or returned items safely.
|
|
|
|
The approved behavior is specified in the [OKF knowledge bundle](knowledge/index.md).
|
|
|
|
## Status
|
|
|
|
Administrators can register persistent shared quest boards by targeting a block within five blocks and running `/questadmin createboard`. Right-clicking any registered board opens a native dialog where a player can request a block and quantity while escrowing the exact reward stack held in their main hand. Every board and `/quests list` show the same active quests with requested blocks, rewards, issuers, and time remaining. Players can complete quests at any board or with `/quests complete <quest>` by delivering the required blocks. Exact escrowed rewards are granted immediately, and delivered blocks are held for the issuer. Issuers can cancel their own active quests at any board or with `/quests cancel <quest>`. Completed deliveries and rewards from cancelled or seven-day-expired quests are held durably and can be collected at any board or with `/quests claim`; inventory overflow drops at the claimant's feet.
|
|
|
|
## Requirements
|
|
|
|
- Purpur 26.2 build 2618
|
|
- Java 25 or newer
|
|
|
|
## Build
|
|
|
|
```bash
|
|
./gradlew clean check jar
|
|
```
|
|
|
|
The plugin JAR is written to `build/libs/`.
|
|
|
|
## Player commands
|
|
|
|
Player commands are disabled by default and can be enabled persistently by an administrator. When disabled, players are directed to use a physical quest board.
|
|
|
|
```text
|
|
/quests
|
|
/quests list
|
|
/quests create ...
|
|
/quests complete <quest>
|
|
/quests cancel <quest>
|
|
/quests claim
|
|
```
|
|
|
|
## Administration
|
|
|
|
The `spigotquestboard.admin` permission is granted to server operators by default.
|
|
|
|
```text
|
|
/questadmin createboard
|
|
/questadmin commands <enable|disable>
|
|
```
|
|
|
|
## Releases
|
|
|
|
Gitea Actions checks pushes and pull requests and stores a development JAR. Pull requests validate conventional commits. Main-branch conventional commits drive semantic releases when the repository defines a `RELEASE_TOKEN` with contents-write permission.
|