2.1 KiB
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.
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
./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.
/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.
/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.