Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
be13b9b87c | ||
|
|
af6d6d0827 | ||
|
|
5ca939be6c | ||
|
|
9344390599 |
@@ -6,7 +6,7 @@ The approved behavior is specified in the [OKF knowledge bundle](knowledge/index
|
|||||||
|
|
||||||
## Status
|
## 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. Delivery and claims remain under development.
|
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
|
## Requirements
|
||||||
|
|
||||||
@@ -21,9 +21,9 @@ Administrators can register persistent shared quest boards by targeting a block
|
|||||||
|
|
||||||
The plugin JAR is written to `build/libs/`.
|
The plugin JAR is written to `build/libs/`.
|
||||||
|
|
||||||
## Planned player commands
|
## Player commands
|
||||||
|
|
||||||
Player commands are disabled by default and can be enabled by an administrator.
|
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
|
```text
|
||||||
/quests
|
/quests
|
||||||
@@ -34,7 +34,7 @@ Player commands are disabled by default and can be enabled by an administrator.
|
|||||||
/quests claim
|
/quests claim
|
||||||
```
|
```
|
||||||
|
|
||||||
## Planned administration
|
## Administration
|
||||||
|
|
||||||
The `spigotquestboard.admin` permission is granted to server operators by default.
|
The `spigotquestboard.admin` permission is granted to server operators by default.
|
||||||
|
|
||||||
|
|||||||
@@ -47,3 +47,32 @@ description: Chronological record of material decisions affecting Spigot Quest B
|
|||||||
- Listings include requested blocks, exact reward summaries, issuer names, and boundary-safe remaining durations.
|
- Listings include requested blocks, exact reward summaries, issuer names, and boundary-safe remaining durations.
|
||||||
- Added persisted lifecycle status with backward-compatible active defaults and filtered stale quest IDs from contextual completion and cancellation suggestions.
|
- Added persisted lifecycle status with backward-compatible active defaults and filtered stale quest IDs from contextual completion and cancellation suggestions.
|
||||||
- Verified 37 tests and the plugin JAR with `./gradlew clean check jar`.
|
- Verified 37 tests and the plugin JAR with `./gradlew clean check jar`.
|
||||||
|
|
||||||
|
## 2026-09-05 — Block delivery and quest completion
|
||||||
|
|
||||||
|
- Added board actions and `/quests complete <quest>` for exact requested-material delivery from player inventories.
|
||||||
|
- Completion serializes state transitions, holds delivered blocks in durable issuer claims, and grants exact escrowed rewards with owner-protected overflow drops.
|
||||||
|
- Added durable online and next-login issuer notifications and rollback before persistence succeeds.
|
||||||
|
- Verified 49 tests and the plugin JAR with `./gradlew clean check jar`.
|
||||||
|
|
||||||
|
## 2026-09-05 — Issuer quest cancellation
|
||||||
|
|
||||||
|
- Added issuer-only board actions and `/quests cancel <quest>` with ownership-filtered autocomplete.
|
||||||
|
- Cancellation atomically moves exact reward escrow into an issuer claim without directly changing inventory.
|
||||||
|
- Serialized cancellation against completion and retained active state when persistence fails.
|
||||||
|
- Verified 58 tests and the plugin JAR with `./gradlew clean check jar`.
|
||||||
|
|
||||||
|
## 2026-09-05 — Quest expiration and held-item claims
|
||||||
|
|
||||||
|
- Added boundary-safe scheduled expiration that moves exact rewards into durable issuer claims.
|
||||||
|
- Added claim collection at every board and through `/quests claim`, distinguishing delivered blocks from cancelled or expired reward returns.
|
||||||
|
- Inventory overflow drops at the claimant's feet with ownership protection, and failed claim acknowledgement rolls inventory and drops back before retry.
|
||||||
|
- Added persisted online and next-login expiry notifications.
|
||||||
|
- Verified 73 tests and the plugin JAR with `./gradlew clean check jar`.
|
||||||
|
|
||||||
|
## 2026-09-05 — Administrative player-command control
|
||||||
|
|
||||||
|
- Disabled all player `/quests` command forms and autocomplete by default while preserving equivalent physical-board actions.
|
||||||
|
- Added persistent `/questadmin commands enable|disable` control with permission-aware autocomplete and failure-safe updates.
|
||||||
|
- Kept administrative board creation available independently of the player-command setting.
|
||||||
|
- Verified 82 tests and the plugin JAR with `./gradlew clean check jar`.
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
type: User Story
|
type: User Story
|
||||||
title: "US-005: Deliver blocks and complete a quest"
|
title: "US-005: Deliver blocks and complete a quest"
|
||||||
description: Let a player deliver requested blocks at a quest board and receive the escrowed reward.
|
description: Let a player deliver requested blocks at a quest board and receive the escrowed reward.
|
||||||
status: backlog
|
status: done
|
||||||
---
|
---
|
||||||
|
|
||||||
# US-005: Deliver blocks and complete a quest
|
# US-005: Deliver blocks and complete a quest
|
||||||
@@ -11,17 +11,17 @@ As a **player**, I want to deliver requested blocks to a quest board so that I r
|
|||||||
|
|
||||||
## Acceptance criteria
|
## Acceptance criteria
|
||||||
|
|
||||||
- [ ] An active quest offers a Complete Quest action through every registered board.
|
- [x] An active quest offers a Complete Quest action through every registered board.
|
||||||
- [ ] Completion requires the delivering player to possess the full requested quantity of the exact block material.
|
- [x] Completion requires the delivering player to possess the full requested quantity of the exact block material.
|
||||||
- [ ] Successful completion removes the requested blocks from the delivering player's inventory and stores them as a claim for the issuer.
|
- [x] Successful completion removes the requested blocks from the delivering player's inventory and stores them as a claim for the issuer.
|
||||||
- [ ] Successful completion gives the exact escrowed reward items to the delivering player.
|
- [x] Successful completion gives the exact escrowed reward items to the delivering player.
|
||||||
- [ ] Reward items that do not fit are dropped safely at the delivering player's feet with a clear message.
|
- [x] Reward items that do not fit are dropped safely at the delivering player's feet with a clear message.
|
||||||
- [ ] The issuer is notified immediately when online or on their next login when offline that delivered blocks can be claimed at a quest board.
|
- [x] The issuer is notified immediately when online or on their next login when offline that delivered blocks can be claimed at a quest board.
|
||||||
- [ ] When player commands are enabled, `/quests complete <quest>` provides equivalent behavior with contextual autocomplete.
|
- [x] When player commands are enabled, `/quests complete <quest>` provides equivalent behavior with contextual autocomplete.
|
||||||
- [ ] Completion is atomic and exactly one player can complete a quest, including simultaneous attempts.
|
- [x] Completion is atomic and exactly one player can complete a quest, including simultaneous attempts.
|
||||||
- [ ] Validation or persistence failure does not consume delivered blocks, release rewards, or change quest state.
|
- [x] Validation or persistence failure does not consume delivered blocks, release rewards, or change quest state.
|
||||||
- [ ] Completed quests are no longer shown as active or completable.
|
- [x] Completed quests are no longer shown as active or completable.
|
||||||
- [ ] Automated tests verify inventory validation, settlement, overflow, notifications, rollback, and concurrent completion protection.
|
- [x] Automated tests verify inventory validation, settlement, overflow, notifications, rollback, and concurrent completion protection.
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
type: User Story
|
type: User Story
|
||||||
title: "US-006: Cancel an owned quest"
|
title: "US-006: Cancel an owned quest"
|
||||||
description: Let an issuer cancel an active quest and reclaim its escrowed reward safely.
|
description: Let an issuer cancel an active quest and reclaim its escrowed reward safely.
|
||||||
status: backlog
|
status: done
|
||||||
---
|
---
|
||||||
|
|
||||||
# US-006: Cancel an owned quest
|
# US-006: Cancel an owned quest
|
||||||
@@ -11,15 +11,15 @@ As a **quest issuer**, I want to cancel my active quest so that I can reclaim th
|
|||||||
|
|
||||||
## Acceptance criteria
|
## Acceptance criteria
|
||||||
|
|
||||||
- [ ] An issuer can cancel their own active quest through any registered board.
|
- [x] An issuer can cancel their own active quest through any registered board.
|
||||||
- [ ] A player cannot cancel a quest issued by another player.
|
- [x] A player cannot cancel a quest issued by another player.
|
||||||
- [ ] Completed, cancelled, and expired quests cannot be cancelled.
|
- [x] Completed, cancelled, and expired quests cannot be cancelled.
|
||||||
- [ ] Cancellation removes the quest from active listings and converts its exact escrowed reward into a claim for the issuer.
|
- [x] Cancellation removes the quest from active listings and converts its exact escrowed reward into a claim for the issuer.
|
||||||
- [ ] The reward is not inserted directly into the issuer's inventory during cancellation.
|
- [x] The reward is not inserted directly into the issuer's inventory during cancellation.
|
||||||
- [ ] When player commands are enabled, `/quests cancel <quest>` provides equivalent behavior and only autocompletes the player's cancellable quest identifiers.
|
- [x] When player commands are enabled, `/quests cancel <quest>` provides equivalent behavior and only autocompletes the player's cancellable quest identifiers.
|
||||||
- [ ] Cancellation and simultaneous completion are serialized so items cannot be duplicated or lost.
|
- [x] Cancellation and simultaneous completion are serialized so items cannot be duplicated or lost.
|
||||||
- [ ] Persistence failure leaves the quest active and its reward escrowed.
|
- [x] Persistence failure leaves the quest active and its reward escrowed.
|
||||||
- [ ] Automated tests verify ownership, state validation, claim creation, autocomplete, rollback, and completion races.
|
- [x] Automated tests verify ownership, state validation, claim creation, autocomplete, rollback, and completion races.
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
type: User Story
|
type: User Story
|
||||||
title: "US-007: Expire quests and claim held items"
|
title: "US-007: Expire quests and claim held items"
|
||||||
description: Hold delivered blocks and returned rewards until their owner safely claims them.
|
description: Hold delivered blocks and returned rewards until their owner safely claims them.
|
||||||
status: backlog
|
status: done
|
||||||
---
|
---
|
||||||
|
|
||||||
# US-007: Expire quests and claim held items
|
# US-007: Expire quests and claim held items
|
||||||
@@ -11,18 +11,18 @@ As a **quest issuer**, I want delivered blocks and returned rewards held at the
|
|||||||
|
|
||||||
## Acceptance criteria
|
## Acceptance criteria
|
||||||
|
|
||||||
- [ ] An uncompleted quest expires seven days after its creation time.
|
- [x] An uncompleted quest expires seven days after its creation time.
|
||||||
- [ ] Expiration removes the quest from active listings and converts its exact escrowed reward into a claim for the issuer.
|
- [x] Expiration removes the quest from active listings and converts its exact escrowed reward into a claim for the issuer.
|
||||||
- [ ] Completed-quest claims contain the exact block items delivered by the completing player.
|
- [x] Completed-quest claims contain the exact block items delivered by the completing player.
|
||||||
- [ ] Claims from completion, cancellation, and expiration can be collected through any registered board.
|
- [x] Claims from completion, cancellation, and expiration can be collected through any registered board.
|
||||||
- [ ] The board clearly distinguishes delivered blocks from returned rewards.
|
- [x] The board clearly distinguishes delivered blocks from returned rewards.
|
||||||
- [ ] Online issuers receive a real-time message when items become claimable.
|
- [x] Online issuers receive a real-time message when items become claimable.
|
||||||
- [ ] Offline issuers receive a message on their next login.
|
- [x] Offline issuers receive a message on their next login.
|
||||||
- [ ] When player commands are enabled, `/quests claim` collects the same pending claims.
|
- [x] When player commands are enabled, `/quests claim` collects the same pending claims.
|
||||||
- [ ] Items are inserted into the claimant's inventory where space permits; overflow is dropped safely at their feet with a clear message.
|
- [x] Items are inserted into the claimant's inventory where space permits; overflow is dropped safely at their feet with a clear message.
|
||||||
- [ ] A claim is removed only after all of its items have been inserted or dropped successfully.
|
- [x] A claim is removed only after all of its items have been inserted or dropped successfully.
|
||||||
- [ ] Pending claims and notification state survive logout and server restart without duplication or loss.
|
- [x] Pending claims and notification state survive logout and server restart without duplication or loss.
|
||||||
- [ ] Automated tests verify expiry boundaries, each claim source, notifications, overflow, failure recovery, and persistence.
|
- [x] Automated tests verify expiry boundaries, each claim source, notifications, overflow, failure recovery, and persistence.
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
type: User Story
|
type: User Story
|
||||||
title: "US-008: Control player quest commands"
|
title: "US-008: Control player quest commands"
|
||||||
description: Let administrators require physical-board interaction by controlling access to player quest commands.
|
description: Let administrators require physical-board interaction by controlling access to player quest commands.
|
||||||
status: backlog
|
status: done
|
||||||
---
|
---
|
||||||
|
|
||||||
# US-008: Control player quest commands
|
# US-008: Control player quest commands
|
||||||
@@ -11,14 +11,14 @@ As an **administrator**, I want to enable or disable player quest commands so th
|
|||||||
|
|
||||||
## Acceptance criteria
|
## Acceptance criteria
|
||||||
|
|
||||||
- [ ] Player `/quests` commands are disabled by default.
|
- [x] Player `/quests` commands are disabled by default.
|
||||||
- [ ] An authorized administrator can use `/questadmin commands enable|disable` with contextual autocomplete.
|
- [x] An authorized administrator can use `/questadmin commands enable|disable` with contextual autocomplete.
|
||||||
- [ ] The command setting persists across server restarts.
|
- [x] The command setting persists across server restarts.
|
||||||
- [ ] When disabled, `/quests`, `list`, `create`, `complete`, `cancel`, and `claim` reject execution with a clear message directing the player to a quest board.
|
- [x] When disabled, `/quests`, `list`, `create`, `complete`, `cancel`, and `claim` reject execution with a clear message directing the player to a quest board.
|
||||||
- [ ] Disabling commands does not prevent any equivalent action through a registered board.
|
- [x] Disabling commands does not prevent any equivalent action through a registered board.
|
||||||
- [ ] `/questadmin` remains available to authorized administrators regardless of the player-command setting.
|
- [x] `/questadmin` remains available to authorized administrators regardless of the player-command setting.
|
||||||
- [ ] Unauthorized users cannot change the setting.
|
- [x] Unauthorized users cannot change the setting.
|
||||||
- [ ] Automated tests verify the default, persistence, authorization, every gated subcommand, and autocomplete.
|
- [x] Automated tests verify the default, persistence, authorization, every gated subcommand, and autocomplete.
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,54 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
import org.bukkit.Server;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.event.EventHandler;
|
||||||
|
import org.bukkit.event.Listener;
|
||||||
|
import org.bukkit.event.player.PlayerJoinEvent;
|
||||||
|
|
||||||
|
final class BukkitIssuerNotifier implements IssuerNotifier, Listener {
|
||||||
|
private final QuestService quests;
|
||||||
|
private final Server server;
|
||||||
|
private final Logger logger;
|
||||||
|
|
||||||
|
BukkitIssuerNotifier(QuestService quests, Server server, Logger logger) {
|
||||||
|
this.quests = Objects.requireNonNull(quests, "quests");
|
||||||
|
this.server = Objects.requireNonNull(server, "server");
|
||||||
|
this.logger = Objects.requireNonNull(logger, "logger");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void notifyIfOnline(UUID issuerId) {
|
||||||
|
Player player = server.getPlayer(issuerId);
|
||||||
|
if (player != null && player.isOnline()) {
|
||||||
|
deliver(player);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@EventHandler
|
||||||
|
public void onPlayerJoin(PlayerJoinEvent event) {
|
||||||
|
deliver(event.getPlayer());
|
||||||
|
}
|
||||||
|
|
||||||
|
void deliver(Player player) {
|
||||||
|
for (IssuerNotification notification
|
||||||
|
: quests.pendingNotifications(player.getUniqueId())) {
|
||||||
|
player.sendMessage(notification.message());
|
||||||
|
try {
|
||||||
|
quests.markNotificationDelivered(notification.id());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
logger.log(
|
||||||
|
Level.WARNING,
|
||||||
|
"Could not persist delivery of issuer notification " + notification.id()
|
||||||
|
+ "; it will be retried",
|
||||||
|
exception
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import org.bukkit.entity.Item;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.bukkit.inventory.PlayerInventory;
|
||||||
|
|
||||||
|
final class BukkitQuestClaimInventory implements QuestClaimInventory {
|
||||||
|
@Override
|
||||||
|
public PreparedClaim prepare(List<EscrowItem> items) {
|
||||||
|
List<ItemStack> stacks = items.stream().map(EscrowItem::toItemStack).toList();
|
||||||
|
return player -> deliver(player, stacks);
|
||||||
|
}
|
||||||
|
|
||||||
|
static Delivery deliver(Player player, List<ItemStack> stacks) {
|
||||||
|
PlayerInventory inventory = player.getInventory();
|
||||||
|
ItemStack[] snapshot = cloneContents(inventory.getStorageContents());
|
||||||
|
List<Item> drops = new ArrayList<>();
|
||||||
|
int overflow = 0;
|
||||||
|
try {
|
||||||
|
for (ItemStack stack : stacks) {
|
||||||
|
Map<Integer, ItemStack> leftovers = inventory.addItem(stack.clone());
|
||||||
|
for (ItemStack leftover : leftovers.values()) {
|
||||||
|
Item drop = player.getWorld().dropItem(player.getLocation(), leftover.clone());
|
||||||
|
drops.add(drop);
|
||||||
|
drop.setOwner(player.getUniqueId());
|
||||||
|
overflow += leftover.getAmount();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (RuntimeException exception) {
|
||||||
|
inventory.setStorageContents(cloneContents(snapshot));
|
||||||
|
drops.forEach(Item::remove);
|
||||||
|
throw exception;
|
||||||
|
}
|
||||||
|
int deliveredOverflow = overflow;
|
||||||
|
return new Delivery() {
|
||||||
|
private boolean rolledBack;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public int overflowAmount() {
|
||||||
|
return deliveredOverflow;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void rollback() {
|
||||||
|
if (rolledBack) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
inventory.setStorageContents(cloneContents(snapshot));
|
||||||
|
drops.forEach(Item::remove);
|
||||||
|
rolledBack = true;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
private static ItemStack[] cloneContents(ItemStack[] contents) {
|
||||||
|
ItemStack[] copy = new ItemStack[contents.length];
|
||||||
|
for (int index = 0; index < contents.length; index++) {
|
||||||
|
copy[index] = contents[index] == null ? null : contents[index].clone();
|
||||||
|
}
|
||||||
|
return copy;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,92 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.Objects;
|
||||||
|
import org.bukkit.Material;
|
||||||
|
import org.bukkit.entity.Item;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.bukkit.inventory.PlayerInventory;
|
||||||
|
|
||||||
|
final class BukkitQuestCompletionInventory implements QuestCompletionInventory {
|
||||||
|
@Override
|
||||||
|
public RemovedDelivery remove(Player player, String materialName, int amount) {
|
||||||
|
Objects.requireNonNull(player, "player");
|
||||||
|
Material material = Objects.requireNonNull(Material.matchMaterial(materialName), "material");
|
||||||
|
PlayerInventory inventory = player.getInventory();
|
||||||
|
ItemStack[] contents = inventory.getStorageContents();
|
||||||
|
int available = 0;
|
||||||
|
for (ItemStack stack : contents) {
|
||||||
|
if (stack != null && stack.getType() == material) {
|
||||||
|
available += stack.getAmount();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (available < amount) {
|
||||||
|
throw new IllegalArgumentException(
|
||||||
|
"You need exactly " + amount + " " + material.name()
|
||||||
|
+ " to complete this quest (you have " + available + ")."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Map<Integer, ItemStack> snapshots = new LinkedHashMap<>();
|
||||||
|
List<EscrowItem> removedItems = new ArrayList<>();
|
||||||
|
int remaining = amount;
|
||||||
|
for (int slot = 0; slot < contents.length && remaining > 0; slot++) {
|
||||||
|
ItemStack stack = contents[slot];
|
||||||
|
if (stack == null || stack.getType() != material) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
snapshots.put(slot, stack.clone());
|
||||||
|
int removedAmount = Math.min(stack.getAmount(), remaining);
|
||||||
|
ItemStack removed = stack.clone();
|
||||||
|
removed.setAmount(removedAmount);
|
||||||
|
removedItems.add(EscrowItem.fromItemStack(removed));
|
||||||
|
if (removedAmount == stack.getAmount()) {
|
||||||
|
inventory.clear(slot);
|
||||||
|
} else {
|
||||||
|
ItemStack reduced = stack.clone();
|
||||||
|
reduced.setAmount(stack.getAmount() - removedAmount);
|
||||||
|
inventory.setItem(slot, reduced);
|
||||||
|
}
|
||||||
|
remaining -= removedAmount;
|
||||||
|
}
|
||||||
|
|
||||||
|
return new RemovedDelivery() {
|
||||||
|
private boolean rolledBack;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public List<EscrowItem> items() {
|
||||||
|
return List.copyOf(removedItems);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void rollback() {
|
||||||
|
if (rolledBack) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
snapshots.forEach(inventory::setItem);
|
||||||
|
rolledBack = true;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public PreparedReward prepare(List<EscrowItem> reward) {
|
||||||
|
List<ItemStack> stacks = reward.stream().map(EscrowItem::toItemStack).toList();
|
||||||
|
return player -> {
|
||||||
|
int overflow = 0;
|
||||||
|
for (ItemStack stack : stacks) {
|
||||||
|
Map<Integer, ItemStack> leftovers = player.getInventory().addItem(stack.clone());
|
||||||
|
for (ItemStack leftover : leftovers.values()) {
|
||||||
|
Item dropped = player.getWorld().dropItem(player.getLocation(), leftover);
|
||||||
|
dropped.setOwner(player.getUniqueId());
|
||||||
|
overflow += leftover.getAmount();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return overflow;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
record ClaimCollectionResult(int claimsCollected, int overflowItems) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
record IssuerNotification(
|
||||||
|
UUID id,
|
||||||
|
UUID questId,
|
||||||
|
UUID recipientId,
|
||||||
|
String message,
|
||||||
|
Instant createdAt
|
||||||
|
) {
|
||||||
|
IssuerNotification {
|
||||||
|
Objects.requireNonNull(id, "id");
|
||||||
|
Objects.requireNonNull(questId, "questId");
|
||||||
|
Objects.requireNonNull(recipientId, "recipientId");
|
||||||
|
if (Objects.requireNonNull(message, "message").isBlank()) {
|
||||||
|
throw new IllegalArgumentException("Notification message must not be blank");
|
||||||
|
}
|
||||||
|
Objects.requireNonNull(createdAt, "createdAt");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
interface IssuerNotifier {
|
||||||
|
void notifyIfOnline(UUID issuerId);
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.Objects;
|
||||||
|
|
||||||
|
final class PlayerCommandSettings {
|
||||||
|
private final PlayerCommandSettingsRepository repository;
|
||||||
|
private boolean enabled;
|
||||||
|
|
||||||
|
PlayerCommandSettings(PlayerCommandSettingsRepository repository) throws IOException {
|
||||||
|
this.repository = Objects.requireNonNull(repository, "repository");
|
||||||
|
enabled = repository.loadEnabled();
|
||||||
|
}
|
||||||
|
|
||||||
|
boolean enabled() {
|
||||||
|
return enabled;
|
||||||
|
}
|
||||||
|
|
||||||
|
void setEnabled(boolean enabled) throws IOException {
|
||||||
|
repository.saveEnabled(enabled);
|
||||||
|
this.enabled = enabled;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
interface PlayerCommandSettingsRepository {
|
||||||
|
boolean loadEnabled() throws IOException;
|
||||||
|
void saveEnabled(boolean enabled) throws IOException;
|
||||||
|
}
|
||||||
@@ -1,19 +1,24 @@
|
|||||||
package games.dmg.spigotquestboard;
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Locale;
|
||||||
import java.util.Objects;
|
import java.util.Objects;
|
||||||
import org.bukkit.block.Block;
|
import org.bukkit.block.Block;
|
||||||
import org.bukkit.command.Command;
|
import org.bukkit.command.Command;
|
||||||
import org.bukkit.command.CommandExecutor;
|
import org.bukkit.command.CommandExecutor;
|
||||||
import org.bukkit.command.CommandSender;
|
import org.bukkit.command.CommandSender;
|
||||||
|
import org.bukkit.command.TabCompleter;
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
final class QuestAdminCommand implements CommandExecutor {
|
final class QuestAdminCommand implements CommandExecutor, TabCompleter {
|
||||||
private static final String PERMISSION = "spigotquestboard.admin";
|
private static final String PERMISSION = "spigotquestboard.admin";
|
||||||
private final BoardRegistry registry;
|
private final BoardRegistry registry;
|
||||||
|
private final PlayerCommandSettings playerCommands;
|
||||||
|
|
||||||
QuestAdminCommand(BoardRegistry registry) {
|
QuestAdminCommand(BoardRegistry registry, PlayerCommandSettings playerCommands) {
|
||||||
this.registry = Objects.requireNonNull(registry, "registry");
|
this.registry = Objects.requireNonNull(registry, "registry");
|
||||||
|
this.playerCommands = Objects.requireNonNull(playerCommands, "playerCommands");
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
@@ -24,18 +29,50 @@ final class QuestAdminCommand implements CommandExecutor {
|
|||||||
sender.sendMessage("You do not have permission to administer quest boards.");
|
sender.sendMessage("You do not have permission to administer quest boards.");
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
if (arguments.length == 2 && "commands".equalsIgnoreCase(arguments[0])) {
|
||||||
|
return updatePlayerCommands(sender, arguments[1]);
|
||||||
|
}
|
||||||
if (arguments.length != 1 || !"createboard".equalsIgnoreCase(arguments[0])) {
|
if (arguments.length != 1 || !"createboard".equalsIgnoreCase(arguments[0])) {
|
||||||
sender.sendMessage("Usage: /questadmin createboard");
|
sender.sendMessage(
|
||||||
|
"Usage: /questadmin createboard | /questadmin commands enable|disable"
|
||||||
|
);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
createBoard(sender);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean updatePlayerCommands(CommandSender sender, String action) {
|
||||||
|
final boolean enabled;
|
||||||
|
if ("enable".equalsIgnoreCase(action)) {
|
||||||
|
enabled = true;
|
||||||
|
} else if ("disable".equalsIgnoreCase(action)) {
|
||||||
|
enabled = false;
|
||||||
|
} else {
|
||||||
|
sender.sendMessage("Usage: /questadmin commands enable|disable");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
playerCommands.setEnabled(enabled);
|
||||||
|
sender.sendMessage("Player quest commands " + (enabled ? "enabled." : "disabled."));
|
||||||
|
} catch (IOException exception) {
|
||||||
|
sender.sendMessage(
|
||||||
|
"Player command setting could not be saved. Player quest commands remain "
|
||||||
|
+ (playerCommands.enabled() ? "enabled." : "disabled.")
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
private void createBoard(CommandSender sender) {
|
||||||
if (!(sender instanceof Player player)) {
|
if (!(sender instanceof Player player)) {
|
||||||
sender.sendMessage("A player must target the quest board block.");
|
sender.sendMessage("A player must target the quest board block.");
|
||||||
return true;
|
return;
|
||||||
}
|
}
|
||||||
Block target = player.getTargetBlockExact(5);
|
Block target = player.getTargetBlockExact(5);
|
||||||
if (target == null) {
|
if (target == null) {
|
||||||
sender.sendMessage("Target a physical block within five blocks.");
|
sender.sendMessage("Target a physical block within five blocks.");
|
||||||
return true;
|
return;
|
||||||
}
|
}
|
||||||
try {
|
try {
|
||||||
BoardRegistrationResult result = registry.register(RegisteredBoard.from(target));
|
BoardRegistrationResult result = registry.register(RegisteredBoard.from(target));
|
||||||
@@ -45,6 +82,28 @@ final class QuestAdminCommand implements CommandExecutor {
|
|||||||
} catch (IOException exception) {
|
} catch (IOException exception) {
|
||||||
sender.sendMessage("The quest board could not be saved. No board was created.");
|
sender.sendMessage("The quest board could not be saved. No board was created.");
|
||||||
}
|
}
|
||||||
return true;
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public List<String> onTabComplete(
|
||||||
|
CommandSender sender, Command command, String alias, String[] arguments
|
||||||
|
) {
|
||||||
|
if (!sender.hasPermission(PERMISSION)) {
|
||||||
|
return List.of();
|
||||||
|
}
|
||||||
|
if (arguments.length == 1) {
|
||||||
|
return startsWith(List.of("createboard", "commands"), arguments[0]);
|
||||||
|
}
|
||||||
|
if (arguments.length == 2 && "commands".equalsIgnoreCase(arguments[0])) {
|
||||||
|
return startsWith(List.of("enable", "disable"), arguments[1]);
|
||||||
|
}
|
||||||
|
return List.of();
|
||||||
|
}
|
||||||
|
|
||||||
|
private static List<String> startsWith(List<String> candidates, String prefix) {
|
||||||
|
String normalized = prefix.toLowerCase(Locale.ROOT);
|
||||||
|
return candidates.stream()
|
||||||
|
.filter(candidate -> candidate.startsWith(normalized))
|
||||||
|
.toList();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -10,6 +10,7 @@ import io.papermc.paper.registry.data.dialog.type.DialogType;
|
|||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.time.Clock;
|
import java.time.Clock;
|
||||||
import java.time.Duration;
|
import java.time.Duration;
|
||||||
|
import java.util.ArrayList;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.Objects;
|
import java.util.Objects;
|
||||||
import net.kyori.adventure.text.Component;
|
import net.kyori.adventure.text.Component;
|
||||||
@@ -19,11 +20,47 @@ import org.bukkit.entity.Player;
|
|||||||
final class QuestBoardDialogUi implements QuestBoardUi {
|
final class QuestBoardDialogUi implements QuestBoardUi {
|
||||||
private final QuestCreationGateway creator;
|
private final QuestCreationGateway creator;
|
||||||
private final QuestBrowser browser;
|
private final QuestBrowser browser;
|
||||||
|
private final QuestCompletionGateway completer;
|
||||||
|
private final QuestCancellationGateway canceller;
|
||||||
|
private final QuestClaimGateway claimant;
|
||||||
private final Clock clock;
|
private final Clock clock;
|
||||||
|
|
||||||
QuestBoardDialogUi(QuestCreationGateway creator, QuestBrowser browser, Clock clock) {
|
QuestBoardDialogUi(QuestCreationGateway creator, QuestBrowser browser, Clock clock) {
|
||||||
|
this(creator, browser, null, null, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestBoardDialogUi(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
this(creator, browser, completer, null, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestBoardDialogUi(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
this(creator, browser, completer, canceller, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestBoardDialogUi(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
QuestClaimGateway claimant,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
this.creator = Objects.requireNonNull(creator, "creator");
|
this.creator = Objects.requireNonNull(creator, "creator");
|
||||||
this.browser = Objects.requireNonNull(browser, "browser");
|
this.browser = Objects.requireNonNull(browser, "browser");
|
||||||
|
this.completer = completer;
|
||||||
|
this.canceller = canceller;
|
||||||
|
this.claimant = claimant;
|
||||||
this.clock = Objects.requireNonNull(clock, "clock");
|
this.clock = Objects.requireNonNull(clock, "clock");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -45,11 +82,39 @@ final class QuestBoardDialogUi implements QuestBoardUi {
|
|||||||
.lifetime(Duration.ofMinutes(10))
|
.lifetime(Duration.ofMinutes(10))
|
||||||
.build()))
|
.build()))
|
||||||
.build();
|
.build();
|
||||||
String listing = listingText();
|
java.time.Instant now = clock.instant();
|
||||||
|
List<Quest> activeQuests = browser.activeQuests(now);
|
||||||
|
String listing = QuestListingFormatter.formatAll(activeQuests, now);
|
||||||
|
String claimListing = claimListingText(player);
|
||||||
|
List<ActionButton> actions = new ArrayList<>();
|
||||||
|
actions.add(create);
|
||||||
|
if (claimant != null) {
|
||||||
|
actions.add(ActionButton.builder(Component.text("Collect pending claims"))
|
||||||
|
.tooltip(Component.text("Collect delivered blocks and returned rewards"))
|
||||||
|
.width(250)
|
||||||
|
.action(DialogAction.customClick((response, audience) -> {
|
||||||
|
if (audience instanceof Player respondingPlayer) {
|
||||||
|
submitClaim(respondingPlayer);
|
||||||
|
}
|
||||||
|
}, ClickCallback.Options.builder()
|
||||||
|
.uses(1)
|
||||||
|
.lifetime(Duration.ofMinutes(10))
|
||||||
|
.build()))
|
||||||
|
.build());
|
||||||
|
}
|
||||||
|
for (Quest quest : activeQuests) {
|
||||||
|
if (completer != null) {
|
||||||
|
actions.add(completionButton(quest));
|
||||||
|
}
|
||||||
|
if (canceller != null && quest.issuerId().equals(player.getUniqueId())) {
|
||||||
|
actions.add(cancellationButton(quest));
|
||||||
|
}
|
||||||
|
}
|
||||||
DialogBase base = DialogBase.builder(Component.text("Quest Board"))
|
DialogBase base = DialogBase.builder(Component.text("Quest Board"))
|
||||||
.externalTitle(Component.text("Quest Board — Active quests and create"))
|
.externalTitle(Component.text("Quest Board — Active quests and create"))
|
||||||
.body(List.of(DialogBody.plainMessage(Component.text(
|
.body(List.of(DialogBody.plainMessage(Component.text(
|
||||||
"ACTIVE QUESTS\n" + listing + "\n\nCREATE A QUEST\n"
|
"ACTIVE QUESTS\n" + listing + "\n\nYOUR PENDING CLAIMS\n" + claimListing
|
||||||
|
+ "\n\nCREATE A QUEST\n"
|
||||||
+ "Hold the reward in your main hand. The entire exact stack, including all item metadata, "
|
+ "Hold the reward in your main hand. The entire exact stack, including all item metadata, "
|
||||||
+ "will be removed and held in escrow only if this quest saves successfully."
|
+ "will be removed and held in escrow only if this quest saves successfully."
|
||||||
), 800)))
|
), 800)))
|
||||||
@@ -69,7 +134,7 @@ final class QuestBoardDialogUi implements QuestBoardUi {
|
|||||||
.build();
|
.build();
|
||||||
player.showDialog(Dialog.create(factory -> factory.empty()
|
player.showDialog(Dialog.create(factory -> factory.empty()
|
||||||
.base(base)
|
.base(base)
|
||||||
.type(DialogType.notice(create))));
|
.type(DialogType.multiAction(actions).columns(1).build())));
|
||||||
}
|
}
|
||||||
|
|
||||||
String listingText() {
|
String listingText() {
|
||||||
@@ -77,6 +142,111 @@ final class QuestBoardDialogUi implements QuestBoardUi {
|
|||||||
return QuestListingFormatter.formatAll(browser.activeQuests(now), now);
|
return QuestListingFormatter.formatAll(browser.activeQuests(now), now);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
String claimListingText(Player player) {
|
||||||
|
if (claimant == null) {
|
||||||
|
return "Claim collection is unavailable.";
|
||||||
|
}
|
||||||
|
List<QuestClaim> claims = claimant.pendingClaims(player);
|
||||||
|
if (claims.isEmpty()) {
|
||||||
|
return "No pending claims.";
|
||||||
|
}
|
||||||
|
return claims.stream().map(claim -> {
|
||||||
|
String kind = claim.type() == QuestClaimType.DELIVERED_BLOCKS
|
||||||
|
? "DELIVERED BLOCKS" : "RETURNED REWARD (" + claim.source().name() + ")";
|
||||||
|
String items = claim.items().stream()
|
||||||
|
.map(item -> item.amount() + " " + item.material())
|
||||||
|
.reduce((left, right) -> left + ", " + right)
|
||||||
|
.orElseThrow();
|
||||||
|
return kind + " — " + items + " — quest " + claim.questId();
|
||||||
|
}).reduce((left, right) -> left + "\n" + right).orElseThrow();
|
||||||
|
}
|
||||||
|
|
||||||
|
private ActionButton completionButton(Quest quest) {
|
||||||
|
String id = quest.id().toString();
|
||||||
|
return ActionButton.builder(Component.text(
|
||||||
|
"Complete " + quest.requestedAmount() + " " + quest.requestedMaterial()
|
||||||
|
))
|
||||||
|
.tooltip(Component.text("Deliver blocks for quest " + id))
|
||||||
|
.width(250)
|
||||||
|
.action(DialogAction.customClick((response, audience) -> {
|
||||||
|
if (audience instanceof Player respondingPlayer) {
|
||||||
|
submitCompletion(respondingPlayer, id);
|
||||||
|
}
|
||||||
|
}, ClickCallback.Options.builder()
|
||||||
|
.uses(1)
|
||||||
|
.lifetime(Duration.ofMinutes(10))
|
||||||
|
.build()))
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
private ActionButton cancellationButton(Quest quest) {
|
||||||
|
String id = quest.id().toString();
|
||||||
|
return ActionButton.builder(Component.text(
|
||||||
|
"Cancel " + quest.requestedAmount() + " " + quest.requestedMaterial()
|
||||||
|
))
|
||||||
|
.tooltip(Component.text("Return the escrowed reward to claims for quest " + id))
|
||||||
|
.width(250)
|
||||||
|
.action(DialogAction.customClick((response, audience) -> {
|
||||||
|
if (audience instanceof Player respondingPlayer) {
|
||||||
|
submitCancellation(respondingPlayer, id);
|
||||||
|
}
|
||||||
|
}, ClickCallback.Options.builder()
|
||||||
|
.uses(1)
|
||||||
|
.lifetime(Duration.ofMinutes(10))
|
||||||
|
.build()))
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
List<String> cancellableQuestIds(Player player) {
|
||||||
|
return browser.cancellableQuestIds(player.getUniqueId(), clock.instant());
|
||||||
|
}
|
||||||
|
|
||||||
|
void submitCancellation(Player player, String questId) {
|
||||||
|
if (canceller == null) {
|
||||||
|
player.sendMessage("Quest cancellation is unavailable.");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
canceller.cancel(player, questId, clock.instant());
|
||||||
|
} catch (IllegalArgumentException | IllegalStateException exception) {
|
||||||
|
player.sendMessage(exception.getMessage());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
player.sendMessage(
|
||||||
|
"The quest could not be saved. It remains active and its reward remains escrowed."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void submitClaim(Player player) {
|
||||||
|
if (claimant == null) {
|
||||||
|
player.sendMessage("Quest claims are unavailable.");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
claimant.collect(player);
|
||||||
|
} catch (IOException | RuntimeException exception) {
|
||||||
|
player.sendMessage(
|
||||||
|
"Your claim could not be collected safely. It remains pending; please try again."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void submitCompletion(Player player, String questId) {
|
||||||
|
if (completer == null) {
|
||||||
|
player.sendMessage("Quest completion is unavailable.");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
completer.complete(player, questId, clock.instant());
|
||||||
|
} catch (IllegalArgumentException | IllegalStateException exception) {
|
||||||
|
player.sendMessage(exception.getMessage());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
player.sendMessage(
|
||||||
|
"The quest could not be saved. Your delivered blocks were restored."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void submit(Player player, String material, String quantityText) {
|
void submit(Player player, String material, String quantityText) {
|
||||||
final int quantity;
|
final int quantity;
|
||||||
try {
|
try {
|
||||||
|
|||||||
@@ -0,0 +1,31 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
final class QuestCancellationController implements QuestCancellationGateway {
|
||||||
|
private final QuestService quests;
|
||||||
|
|
||||||
|
QuestCancellationController(QuestService quests) {
|
||||||
|
this.quests = Objects.requireNonNull(quests, "quests");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestClaim cancel(Player player, String questId, Instant cancelledAt) throws IOException {
|
||||||
|
Objects.requireNonNull(player, "player");
|
||||||
|
final UUID id;
|
||||||
|
try {
|
||||||
|
id = UUID.fromString(Objects.requireNonNull(questId, "questId"));
|
||||||
|
} catch (IllegalArgumentException exception) {
|
||||||
|
throw new IllegalArgumentException("Quest identifier must be a valid UUID.", exception);
|
||||||
|
}
|
||||||
|
QuestClaim claim = quests.cancel(id, player.getUniqueId(), cancelledAt);
|
||||||
|
player.sendMessage(
|
||||||
|
"Quest " + id + " cancelled. Your exact escrowed reward is ready to claim at a quest board."
|
||||||
|
);
|
||||||
|
return claim;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
interface QuestCancellationGateway {
|
||||||
|
QuestClaim cancel(Player player, String questId, Instant cancelledAt) throws IOException;
|
||||||
|
}
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
record QuestClaim(
|
||||||
|
UUID id,
|
||||||
|
UUID questId,
|
||||||
|
UUID ownerId,
|
||||||
|
List<EscrowItem> items,
|
||||||
|
Instant createdAt,
|
||||||
|
QuestClaimSource source
|
||||||
|
) {
|
||||||
|
QuestClaim {
|
||||||
|
Objects.requireNonNull(id, "id");
|
||||||
|
Objects.requireNonNull(questId, "questId");
|
||||||
|
Objects.requireNonNull(ownerId, "ownerId");
|
||||||
|
items = List.copyOf(Objects.requireNonNull(items, "items"));
|
||||||
|
if (items.isEmpty()) {
|
||||||
|
throw new IllegalArgumentException("Claim items must not be empty");
|
||||||
|
}
|
||||||
|
Objects.requireNonNull(createdAt, "createdAt");
|
||||||
|
Objects.requireNonNull(source, "source");
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestClaim(
|
||||||
|
UUID id, UUID questId, UUID ownerId, List<EscrowItem> items, Instant createdAt
|
||||||
|
) {
|
||||||
|
this(id, questId, ownerId, items, createdAt, QuestClaimSource.COMPLETION);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestClaimType type() {
|
||||||
|
return source == QuestClaimSource.COMPLETION
|
||||||
|
? QuestClaimType.DELIVERED_BLOCKS : QuestClaimType.RETURNED_REWARD;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Objects;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
final class QuestClaimController implements QuestClaimGateway {
|
||||||
|
private final QuestService quests;
|
||||||
|
private final QuestClaimInventory inventory;
|
||||||
|
|
||||||
|
QuestClaimController(QuestService quests, QuestClaimInventory inventory) {
|
||||||
|
this.quests = Objects.requireNonNull(quests, "quests");
|
||||||
|
this.inventory = Objects.requireNonNull(inventory, "inventory");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public List<QuestClaim> pendingClaims(Player player) {
|
||||||
|
Objects.requireNonNull(player, "player");
|
||||||
|
return quests.claimsFor(player.getUniqueId());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public synchronized ClaimCollectionResult collect(Player player) throws IOException {
|
||||||
|
Objects.requireNonNull(player, "player");
|
||||||
|
List<QuestClaim> claims = quests.claimsFor(player.getUniqueId());
|
||||||
|
if (claims.isEmpty()) {
|
||||||
|
player.sendMessage("You have no pending quest claims.");
|
||||||
|
return new ClaimCollectionResult(0, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
int collected = 0;
|
||||||
|
int overflow = 0;
|
||||||
|
for (QuestClaim claim : claims) {
|
||||||
|
QuestClaimInventory.PreparedClaim prepared = inventory.prepare(claim.items());
|
||||||
|
QuestClaimInventory.Delivery delivery = prepared.deliver(player);
|
||||||
|
try {
|
||||||
|
quests.acknowledgeClaim(player.getUniqueId(), claim.id());
|
||||||
|
} catch (IOException | RuntimeException exception) {
|
||||||
|
delivery.rollback();
|
||||||
|
throw exception;
|
||||||
|
}
|
||||||
|
collected++;
|
||||||
|
overflow += delivery.overflowAmount();
|
||||||
|
player.sendMessage(description(claim));
|
||||||
|
}
|
||||||
|
player.sendMessage("Collected " + collected + " quest claim(s).");
|
||||||
|
if (overflow > 0) {
|
||||||
|
player.sendMessage(
|
||||||
|
overflow + " item(s) did not fit and were dropped at your feet, protected for you."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return new ClaimCollectionResult(collected, overflow);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static String description(QuestClaim claim) {
|
||||||
|
if (claim.type() == QuestClaimType.DELIVERED_BLOCKS) {
|
||||||
|
return "Collected delivered blocks from completed quest " + claim.questId() + ".";
|
||||||
|
}
|
||||||
|
String reason = claim.source() == QuestClaimSource.EXPIRATION
|
||||||
|
? "expired" : "cancelled";
|
||||||
|
return "Collected returned reward from " + reason + " quest " + claim.questId() + ".";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.List;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
interface QuestClaimGateway {
|
||||||
|
ClaimCollectionResult collect(Player player) throws IOException;
|
||||||
|
|
||||||
|
default List<QuestClaim> pendingClaims(Player player) {
|
||||||
|
return List.of();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
interface QuestClaimInventory {
|
||||||
|
PreparedClaim prepare(List<EscrowItem> items);
|
||||||
|
|
||||||
|
interface PreparedClaim {
|
||||||
|
Delivery deliver(Player player);
|
||||||
|
}
|
||||||
|
|
||||||
|
interface Delivery {
|
||||||
|
int overflowAmount();
|
||||||
|
void rollback();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
enum QuestClaimSource {
|
||||||
|
COMPLETION,
|
||||||
|
CANCELLATION,
|
||||||
|
EXPIRATION
|
||||||
|
}
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
enum QuestClaimType {
|
||||||
|
DELIVERED_BLOCKS,
|
||||||
|
RETURNED_REWARD
|
||||||
|
}
|
||||||
@@ -16,24 +16,138 @@ final class QuestCommand implements CommandExecutor, TabCompleter {
|
|||||||
private static final List<String> QUANTITIES = List.of("1", "16", "32", "64");
|
private static final List<String> QUANTITIES = List.of("1", "16", "32", "64");
|
||||||
private final QuestCreationGateway creator;
|
private final QuestCreationGateway creator;
|
||||||
private final QuestBrowser browser;
|
private final QuestBrowser browser;
|
||||||
|
private final QuestCompletionGateway completer;
|
||||||
|
private final QuestCancellationGateway canceller;
|
||||||
|
private final QuestClaimGateway claimant;
|
||||||
private final Clock clock;
|
private final Clock clock;
|
||||||
|
private final PlayerCommandSettings playerCommands;
|
||||||
|
|
||||||
QuestCommand(QuestCreationGateway creator, QuestBrowser browser, Clock clock) {
|
QuestCommand(QuestCreationGateway creator, QuestBrowser browser, Clock clock) {
|
||||||
|
this(creator, browser, null, null, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestCommand(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
this(creator, browser, completer, null, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestCommand(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
this(creator, browser, completer, canceller, null, clock);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestCommand(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
QuestClaimGateway claimant,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
this(creator, browser, completer, canceller, claimant, clock, null);
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestCommand(
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
QuestClaimGateway claimant,
|
||||||
|
Clock clock,
|
||||||
|
PlayerCommandSettings playerCommands
|
||||||
|
) {
|
||||||
this.creator = Objects.requireNonNull(creator, "creator");
|
this.creator = Objects.requireNonNull(creator, "creator");
|
||||||
this.browser = Objects.requireNonNull(browser, "browser");
|
this.browser = Objects.requireNonNull(browser, "browser");
|
||||||
|
this.completer = completer;
|
||||||
|
this.canceller = canceller;
|
||||||
|
this.claimant = claimant;
|
||||||
this.clock = Objects.requireNonNull(clock, "clock");
|
this.clock = Objects.requireNonNull(clock, "clock");
|
||||||
|
this.playerCommands = playerCommands;
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public boolean onCommand(
|
public boolean onCommand(
|
||||||
CommandSender sender, Command command, String label, String[] arguments
|
CommandSender sender, Command command, String label, String[] arguments
|
||||||
) {
|
) {
|
||||||
|
if (!playerCommandsEnabled()) {
|
||||||
|
sender.sendMessage(
|
||||||
|
"Player quest commands are disabled. Use a physical quest board instead."
|
||||||
|
);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
if (arguments.length == 0
|
if (arguments.length == 0
|
||||||
|| (arguments.length == 1 && "list".equalsIgnoreCase(arguments[0]))) {
|
|| (arguments.length == 1 && "list".equalsIgnoreCase(arguments[0]))) {
|
||||||
Instant now = clock.instant();
|
Instant now = clock.instant();
|
||||||
sender.sendMessage(QuestListingFormatter.formatAll(browser.activeQuests(now), now));
|
sender.sendMessage(QuestListingFormatter.formatAll(browser.activeQuests(now), now));
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
if (arguments.length == 1 && "claim".equalsIgnoreCase(arguments[0])) {
|
||||||
|
if (!(sender instanceof Player player)) {
|
||||||
|
sender.sendMessage("Only players can collect quest claims.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (claimant == null) {
|
||||||
|
sender.sendMessage("Quest claims are unavailable.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
claimant.collect(player);
|
||||||
|
} catch (IOException | RuntimeException exception) {
|
||||||
|
sender.sendMessage(
|
||||||
|
"Your claim could not be collected safely. It remains pending; please try again."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (arguments.length == 2 && "complete".equalsIgnoreCase(arguments[0])) {
|
||||||
|
if (!(sender instanceof Player player)) {
|
||||||
|
sender.sendMessage("Only players can complete quests with inventory items.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (completer == null) {
|
||||||
|
sender.sendMessage("Quest completion is unavailable.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
completer.complete(player, arguments[1], clock.instant());
|
||||||
|
} catch (IllegalArgumentException | IllegalStateException exception) {
|
||||||
|
sender.sendMessage(exception.getMessage());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
sender.sendMessage(
|
||||||
|
"The quest could not be saved. Your delivered blocks were restored."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (arguments.length == 2 && "cancel".equalsIgnoreCase(arguments[0])) {
|
||||||
|
if (!(sender instanceof Player player)) {
|
||||||
|
sender.sendMessage("Only players can cancel quests.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (canceller == null) {
|
||||||
|
sender.sendMessage("Quest cancellation is unavailable.");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
canceller.cancel(player, arguments[1], clock.instant());
|
||||||
|
} catch (IllegalArgumentException | IllegalStateException exception) {
|
||||||
|
sender.sendMessage(exception.getMessage());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
sender.sendMessage(
|
||||||
|
"The quest could not be saved. It remains active and its reward remains escrowed."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
if (arguments.length != 3 || !"create".equalsIgnoreCase(arguments[0])) {
|
if (arguments.length != 3 || !"create".equalsIgnoreCase(arguments[0])) {
|
||||||
usage(sender);
|
usage(sender);
|
||||||
return true;
|
return true;
|
||||||
@@ -64,11 +178,13 @@ final class QuestCommand implements CommandExecutor, TabCompleter {
|
|||||||
public List<String> onTabComplete(
|
public List<String> onTabComplete(
|
||||||
CommandSender sender, Command command, String alias, String[] arguments
|
CommandSender sender, Command command, String alias, String[] arguments
|
||||||
) {
|
) {
|
||||||
if (!(sender instanceof Player)) {
|
if (!playerCommandsEnabled() || !(sender instanceof Player)) {
|
||||||
return List.of();
|
return List.of();
|
||||||
}
|
}
|
||||||
if (arguments.length == 1) {
|
if (arguments.length == 1) {
|
||||||
return startsWith(List.of("create", "list"), arguments[0]);
|
return startsWith(
|
||||||
|
List.of("create", "list", "complete", "cancel", "claim"), arguments[0]
|
||||||
|
);
|
||||||
}
|
}
|
||||||
if (arguments.length == 2 && "create".equalsIgnoreCase(arguments[0])) {
|
if (arguments.length == 2 && "create".equalsIgnoreCase(arguments[0])) {
|
||||||
return creator.suggestBlockMaterials(arguments[1]);
|
return creator.suggestBlockMaterials(arguments[1]);
|
||||||
@@ -88,6 +204,10 @@ final class QuestCommand implements CommandExecutor, TabCompleter {
|
|||||||
return List.of();
|
return List.of();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private boolean playerCommandsEnabled() {
|
||||||
|
return playerCommands == null || playerCommands.enabled();
|
||||||
|
}
|
||||||
|
|
||||||
private static List<String> startsWith(List<String> candidates, String prefix) {
|
private static List<String> startsWith(List<String> candidates, String prefix) {
|
||||||
String normalized = prefix.toLowerCase(Locale.ROOT);
|
String normalized = prefix.toLowerCase(Locale.ROOT);
|
||||||
return candidates.stream()
|
return candidates.stream()
|
||||||
@@ -96,7 +216,10 @@ final class QuestCommand implements CommandExecutor, TabCompleter {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private static void usage(CommandSender sender) {
|
private static void usage(CommandSender sender) {
|
||||||
sender.sendMessage("Usage: /quests [list] | /quests create <block> <quantity>");
|
sender.sendMessage(
|
||||||
|
"Usage: /quests [list] | /quests create <block> <quantity> | "
|
||||||
|
+ "/quests complete <quest> | /quests cancel <quest> | /quests claim"
|
||||||
|
);
|
||||||
sender.sendMessage("Hold the entire reward stack in your main hand; its exact metadata will be escrowed.");
|
sender.sendMessage("Hold the entire reward stack in your main hand; its exact metadata will be escrowed.");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
record QuestCompletion(Quest quest, QuestClaim claim, List<EscrowItem> reward) {
|
||||||
|
QuestCompletion {
|
||||||
|
reward = List.copyOf(reward);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
final class QuestCompletionController implements QuestCompletionGateway {
|
||||||
|
private final QuestService quests;
|
||||||
|
private final QuestCompletionInventory inventory;
|
||||||
|
private final IssuerNotifier notifier;
|
||||||
|
|
||||||
|
QuestCompletionController(
|
||||||
|
QuestService quests, QuestCompletionInventory inventory, IssuerNotifier notifier
|
||||||
|
) {
|
||||||
|
this.quests = Objects.requireNonNull(quests, "quests");
|
||||||
|
this.inventory = Objects.requireNonNull(inventory, "inventory");
|
||||||
|
this.notifier = Objects.requireNonNull(notifier, "notifier");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestCompletion complete(Player player, String questId, Instant completedAt)
|
||||||
|
throws IOException {
|
||||||
|
Objects.requireNonNull(player, "player");
|
||||||
|
final UUID id;
|
||||||
|
try {
|
||||||
|
id = UUID.fromString(Objects.requireNonNull(questId, "questId"));
|
||||||
|
} catch (IllegalArgumentException exception) {
|
||||||
|
throw new IllegalArgumentException("Quest identifier must be a valid UUID.", exception);
|
||||||
|
}
|
||||||
|
Quest quest = quests.completionCandidate(id, completedAt);
|
||||||
|
QuestCompletionInventory.PreparedReward reward = inventory.prepare(quest.reward());
|
||||||
|
QuestCompletionInventory.RemovedDelivery delivery = inventory.remove(
|
||||||
|
player, quest.requestedMaterial(), quest.requestedAmount()
|
||||||
|
);
|
||||||
|
final QuestCompletion completion;
|
||||||
|
try {
|
||||||
|
completion = quests.complete(id, delivery.items(), completedAt);
|
||||||
|
} catch (IOException | RuntimeException exception) {
|
||||||
|
delivery.rollback();
|
||||||
|
throw exception;
|
||||||
|
}
|
||||||
|
|
||||||
|
int overflow = reward.grantAndDropOverflow(player);
|
||||||
|
player.sendMessage(
|
||||||
|
"Quest " + id + " completed. You received the exact escrowed reward."
|
||||||
|
);
|
||||||
|
if (overflow > 0) {
|
||||||
|
player.sendMessage(
|
||||||
|
overflow + " reward item(s) did not fit and were dropped safely at your feet."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
notifier.notifyIfOnline(completion.quest().issuerId());
|
||||||
|
return completion;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
interface QuestCompletionGateway {
|
||||||
|
QuestCompletion complete(Player player, String questId, Instant completedAt) throws IOException;
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
|
interface QuestCompletionInventory {
|
||||||
|
RemovedDelivery remove(Player player, String material, int amount);
|
||||||
|
|
||||||
|
PreparedReward prepare(List<EscrowItem> reward);
|
||||||
|
|
||||||
|
interface RemovedDelivery {
|
||||||
|
List<EscrowItem> items();
|
||||||
|
void rollback();
|
||||||
|
}
|
||||||
|
|
||||||
|
interface PreparedReward {
|
||||||
|
int grantAndDropOverflow(Player player);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Clock;
|
||||||
|
import java.util.LinkedHashSet;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Set;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
final class QuestExpiryTask implements Runnable {
|
||||||
|
private final QuestService quests;
|
||||||
|
private final IssuerNotifier notifier;
|
||||||
|
private final Clock clock;
|
||||||
|
private final Logger logger;
|
||||||
|
|
||||||
|
QuestExpiryTask(
|
||||||
|
QuestService quests, IssuerNotifier notifier, Clock clock, Logger logger
|
||||||
|
) {
|
||||||
|
this.quests = quests;
|
||||||
|
this.notifier = notifier;
|
||||||
|
this.clock = clock;
|
||||||
|
this.logger = logger;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
final List<QuestClaim> claims;
|
||||||
|
try {
|
||||||
|
claims = quests.expire(clock.instant());
|
||||||
|
} catch (IOException exception) {
|
||||||
|
logger.log(Level.WARNING, "Could not persist expired quests; expiration will be retried", exception);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
Set<java.util.UUID> owners = new LinkedHashSet<>();
|
||||||
|
claims.forEach(claim -> owners.add(claim.ownerId()));
|
||||||
|
owners.forEach(notifier::notifyIfOnline);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -3,20 +3,21 @@ package games.dmg.spigotquestboard;
|
|||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.time.Instant;
|
import java.time.Instant;
|
||||||
import java.time.temporal.ChronoUnit;
|
import java.time.temporal.ChronoUnit;
|
||||||
|
import java.util.ArrayList;
|
||||||
import java.util.LinkedHashMap;
|
import java.util.LinkedHashMap;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.Map;
|
|
||||||
import java.util.Locale;
|
import java.util.Locale;
|
||||||
|
import java.util.Map;
|
||||||
import java.util.Objects;
|
import java.util.Objects;
|
||||||
import java.util.UUID;
|
import java.util.UUID;
|
||||||
|
|
||||||
final class QuestService implements QuestBrowser {
|
final class QuestService implements QuestBrowser {
|
||||||
private final QuestRepository repository;
|
private final QuestRepository repository;
|
||||||
private Map<UUID, Quest> quests;
|
private QuestState state;
|
||||||
|
|
||||||
QuestService(QuestRepository repository) throws IOException {
|
QuestService(QuestRepository repository) throws IOException {
|
||||||
this.repository = Objects.requireNonNull(repository, "repository");
|
this.repository = Objects.requireNonNull(repository, "repository");
|
||||||
quests = new LinkedHashMap<>(repository.load().quests());
|
state = repository.load();
|
||||||
}
|
}
|
||||||
|
|
||||||
synchronized Quest create(
|
synchronized Quest create(
|
||||||
@@ -38,23 +39,211 @@ final class QuestService implements QuestBrowser {
|
|||||||
UUID.randomUUID(), issuerId, issuerName, material, requestedAmount,
|
UUID.randomUUID(), issuerId, issuerName, material, requestedAmount,
|
||||||
reward, createdAt, createdAt.plus(7, ChronoUnit.DAYS)
|
reward, createdAt, createdAt.plus(7, ChronoUnit.DAYS)
|
||||||
);
|
);
|
||||||
Map<UUID, Quest> candidate = new LinkedHashMap<>(quests);
|
Map<UUID, Quest> quests = new LinkedHashMap<>(state.quests());
|
||||||
candidate.put(quest.id(), quest);
|
quests.put(quest.id(), quest);
|
||||||
repository.save(new QuestState(candidate));
|
save(new QuestState(quests, state.claims(), state.notifications()));
|
||||||
quests = Map.copyOf(candidate);
|
|
||||||
return quest;
|
return quest;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
synchronized Quest completionCandidate(UUID questId, Instant now) {
|
||||||
|
Objects.requireNonNull(questId, "questId");
|
||||||
|
Objects.requireNonNull(now, "now");
|
||||||
|
Quest quest = state.quests().get(questId);
|
||||||
|
if (quest == null) {
|
||||||
|
throw new IllegalArgumentException("Quest not found: " + questId);
|
||||||
|
}
|
||||||
|
if (quest.status() != QuestStatus.ACTIVE || !now.isBefore(quest.expiresAt())) {
|
||||||
|
throw new IllegalStateException("That quest is no longer active or has expired.");
|
||||||
|
}
|
||||||
|
return quest;
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized QuestCompletion complete(
|
||||||
|
UUID questId, EscrowItem delivered, Instant completedAt
|
||||||
|
) throws IOException {
|
||||||
|
return complete(questId, List.of(delivered), completedAt);
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized QuestCompletion complete(
|
||||||
|
UUID questId, List<EscrowItem> delivered, Instant completedAt
|
||||||
|
) throws IOException {
|
||||||
|
Quest active = completionCandidate(questId, completedAt);
|
||||||
|
List<EscrowItem> delivery = List.copyOf(Objects.requireNonNull(delivered, "delivered"));
|
||||||
|
if (delivery.isEmpty()
|
||||||
|
|| delivery.stream().anyMatch(item -> !item.material().equals(active.requestedMaterial()))
|
||||||
|
|| delivery.stream().mapToInt(EscrowItem::amount).sum() != active.requestedAmount()) {
|
||||||
|
throw new IllegalArgumentException(
|
||||||
|
"Delivery must contain exactly " + active.requestedAmount() + " "
|
||||||
|
+ active.requestedMaterial() + "."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Quest completed = new Quest(
|
||||||
|
active.id(), active.issuerId(), active.issuerName(), active.requestedMaterial(),
|
||||||
|
active.requestedAmount(), active.reward(), active.createdAt(), active.expiresAt(),
|
||||||
|
QuestStatus.COMPLETED
|
||||||
|
);
|
||||||
|
QuestClaim claim = new QuestClaim(
|
||||||
|
UUID.randomUUID(), active.id(), active.issuerId(), delivery, completedAt,
|
||||||
|
QuestClaimSource.COMPLETION
|
||||||
|
);
|
||||||
|
IssuerNotification notification = new IssuerNotification(
|
||||||
|
UUID.randomUUID(), active.id(), active.issuerId(),
|
||||||
|
"Quest " + active.id() + " was completed. Your delivered "
|
||||||
|
+ active.requestedMaterial() + " blocks can be claimed at a quest board.",
|
||||||
|
completedAt
|
||||||
|
);
|
||||||
|
|
||||||
|
Map<UUID, Quest> quests = new LinkedHashMap<>(state.quests());
|
||||||
|
quests.put(active.id(), completed);
|
||||||
|
Map<UUID, List<QuestClaim>> claims = new LinkedHashMap<>(state.claims());
|
||||||
|
List<QuestClaim> ownerClaims = new ArrayList<>(
|
||||||
|
claims.getOrDefault(active.issuerId(), List.of())
|
||||||
|
);
|
||||||
|
ownerClaims.add(claim);
|
||||||
|
claims.put(active.issuerId(), ownerClaims);
|
||||||
|
Map<UUID, IssuerNotification> notifications = new LinkedHashMap<>(state.notifications());
|
||||||
|
notifications.put(notification.id(), notification);
|
||||||
|
save(new QuestState(quests, claims, notifications));
|
||||||
|
return new QuestCompletion(completed, claim, completed.reward());
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized QuestClaim cancel(UUID questId, UUID issuerId, Instant cancelledAt)
|
||||||
|
throws IOException {
|
||||||
|
Objects.requireNonNull(questId, "questId");
|
||||||
|
Objects.requireNonNull(issuerId, "issuerId");
|
||||||
|
Objects.requireNonNull(cancelledAt, "cancelledAt");
|
||||||
|
Quest active = state.quests().get(questId);
|
||||||
|
if (active == null) {
|
||||||
|
throw new IllegalArgumentException("Quest not found: " + questId);
|
||||||
|
}
|
||||||
|
if (!active.issuerId().equals(issuerId)) {
|
||||||
|
throw new IllegalArgumentException("Only the quest issuer can cancel this quest.");
|
||||||
|
}
|
||||||
|
if (active.status() != QuestStatus.ACTIVE || !cancelledAt.isBefore(active.expiresAt())) {
|
||||||
|
throw new IllegalStateException("That quest is no longer active or has expired.");
|
||||||
|
}
|
||||||
|
|
||||||
|
Quest cancelled = new Quest(
|
||||||
|
active.id(), active.issuerId(), active.issuerName(), active.requestedMaterial(),
|
||||||
|
active.requestedAmount(), active.reward(), active.createdAt(), active.expiresAt(),
|
||||||
|
QuestStatus.CANCELLED
|
||||||
|
);
|
||||||
|
QuestClaim claim = new QuestClaim(
|
||||||
|
UUID.randomUUID(), active.id(), active.issuerId(), active.reward(), cancelledAt,
|
||||||
|
QuestClaimSource.CANCELLATION
|
||||||
|
);
|
||||||
|
Map<UUID, Quest> quests = new LinkedHashMap<>(state.quests());
|
||||||
|
quests.put(active.id(), cancelled);
|
||||||
|
Map<UUID, List<QuestClaim>> claims = new LinkedHashMap<>(state.claims());
|
||||||
|
List<QuestClaim> ownerClaims = new ArrayList<>(
|
||||||
|
claims.getOrDefault(active.issuerId(), List.of())
|
||||||
|
);
|
||||||
|
ownerClaims.add(claim);
|
||||||
|
claims.put(active.issuerId(), ownerClaims);
|
||||||
|
save(new QuestState(quests, claims, state.notifications()));
|
||||||
|
return claim;
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized List<QuestClaim> expire(Instant now) throws IOException {
|
||||||
|
Objects.requireNonNull(now, "now");
|
||||||
|
Map<UUID, Quest> quests = new LinkedHashMap<>(state.quests());
|
||||||
|
Map<UUID, List<QuestClaim>> claims = mutableClaims(state.claims());
|
||||||
|
Map<UUID, IssuerNotification> notifications = new LinkedHashMap<>(state.notifications());
|
||||||
|
List<QuestClaim> expiredClaims = new ArrayList<>();
|
||||||
|
|
||||||
|
for (Quest active : state.quests().values()) {
|
||||||
|
if (active.status() != QuestStatus.ACTIVE || active.expiresAt().isAfter(now)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
Quest expired = new Quest(
|
||||||
|
active.id(), active.issuerId(), active.issuerName(), active.requestedMaterial(),
|
||||||
|
active.requestedAmount(), active.reward(), active.createdAt(), active.expiresAt(),
|
||||||
|
QuestStatus.EXPIRED
|
||||||
|
);
|
||||||
|
QuestClaim claim = new QuestClaim(
|
||||||
|
UUID.randomUUID(), active.id(), active.issuerId(), active.reward(), active.expiresAt(),
|
||||||
|
QuestClaimSource.EXPIRATION
|
||||||
|
);
|
||||||
|
IssuerNotification notification = new IssuerNotification(
|
||||||
|
UUID.randomUUID(), active.id(), active.issuerId(),
|
||||||
|
"Quest " + active.id() + " expired. Your returned reward can be claimed "
|
||||||
|
+ "at any quest board or with /quests claim.",
|
||||||
|
active.expiresAt()
|
||||||
|
);
|
||||||
|
quests.put(active.id(), expired);
|
||||||
|
claims.computeIfAbsent(active.issuerId(), ignored -> new ArrayList<>()).add(claim);
|
||||||
|
notifications.put(notification.id(), notification);
|
||||||
|
expiredClaims.add(claim);
|
||||||
|
}
|
||||||
|
if (!expiredClaims.isEmpty()) {
|
||||||
|
save(new QuestState(quests, claims, notifications));
|
||||||
|
}
|
||||||
|
return List.copyOf(expiredClaims);
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized List<QuestClaim> claimsFor(UUID ownerId) {
|
||||||
|
Objects.requireNonNull(ownerId, "ownerId");
|
||||||
|
return state.claims().getOrDefault(ownerId, List.of());
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized void acknowledgeClaim(UUID ownerId, UUID claimId) throws IOException {
|
||||||
|
Objects.requireNonNull(ownerId, "ownerId");
|
||||||
|
Objects.requireNonNull(claimId, "claimId");
|
||||||
|
List<QuestClaim> existing = state.claims().getOrDefault(ownerId, List.of());
|
||||||
|
if (existing.stream().noneMatch(claim -> claim.id().equals(claimId))) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
Map<UUID, List<QuestClaim>> claims = mutableClaims(state.claims());
|
||||||
|
List<QuestClaim> remaining = new ArrayList<>(claims.get(ownerId));
|
||||||
|
remaining.removeIf(claim -> claim.id().equals(claimId));
|
||||||
|
if (remaining.isEmpty()) {
|
||||||
|
claims.remove(ownerId);
|
||||||
|
} else {
|
||||||
|
claims.put(ownerId, remaining);
|
||||||
|
}
|
||||||
|
save(new QuestState(state.quests(), claims, state.notifications()));
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized List<IssuerNotification> pendingNotifications(UUID recipientId) {
|
||||||
|
Objects.requireNonNull(recipientId, "recipientId");
|
||||||
|
return state.notifications().values().stream()
|
||||||
|
.filter(notification -> notification.recipientId().equals(recipientId))
|
||||||
|
.toList();
|
||||||
|
}
|
||||||
|
|
||||||
|
synchronized void markNotificationDelivered(UUID notificationId) throws IOException {
|
||||||
|
if (!state.notifications().containsKey(notificationId)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
Map<UUID, IssuerNotification> notifications = new LinkedHashMap<>(state.notifications());
|
||||||
|
notifications.remove(notificationId);
|
||||||
|
save(new QuestState(state.quests(), state.claims(), notifications));
|
||||||
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public synchronized List<Quest> activeQuests(Instant now) {
|
public synchronized List<Quest> activeQuests(Instant now) {
|
||||||
Objects.requireNonNull(now, "now");
|
Objects.requireNonNull(now, "now");
|
||||||
return quests.values().stream()
|
return state.quests().values().stream()
|
||||||
.filter(quest -> quest.status() == QuestStatus.ACTIVE)
|
.filter(quest -> quest.status() == QuestStatus.ACTIVE)
|
||||||
.filter(quest -> now.isBefore(quest.expiresAt()))
|
.filter(quest -> now.isBefore(quest.expiresAt()))
|
||||||
.toList();
|
.toList();
|
||||||
}
|
}
|
||||||
|
|
||||||
synchronized QuestState state() {
|
synchronized QuestState state() {
|
||||||
return new QuestState(quests);
|
return state;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Map<UUID, List<QuestClaim>> mutableClaims(
|
||||||
|
Map<UUID, List<QuestClaim>> source
|
||||||
|
) {
|
||||||
|
Map<UUID, List<QuestClaim>> copy = new LinkedHashMap<>();
|
||||||
|
source.forEach((owner, claims) -> copy.put(owner, new ArrayList<>(claims)));
|
||||||
|
return copy;
|
||||||
|
}
|
||||||
|
|
||||||
|
private void save(QuestState candidate) throws IOException {
|
||||||
|
repository.save(candidate);
|
||||||
|
state = candidate;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,10 +1,16 @@
|
|||||||
package games.dmg.spigotquestboard;
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.List;
|
||||||
import java.util.Map;
|
import java.util.Map;
|
||||||
import java.util.Objects;
|
import java.util.Objects;
|
||||||
import java.util.UUID;
|
import java.util.UUID;
|
||||||
|
|
||||||
record QuestState(Map<UUID, Quest> quests) {
|
record QuestState(
|
||||||
|
Map<UUID, Quest> quests,
|
||||||
|
Map<UUID, List<QuestClaim>> claims,
|
||||||
|
Map<UUID, IssuerNotification> notifications
|
||||||
|
) {
|
||||||
QuestState {
|
QuestState {
|
||||||
quests = Map.copyOf(Objects.requireNonNull(quests, "quests"));
|
quests = Map.copyOf(Objects.requireNonNull(quests, "quests"));
|
||||||
for (Map.Entry<UUID, Quest> entry : quests.entrySet()) {
|
for (Map.Entry<UUID, Quest> entry : quests.entrySet()) {
|
||||||
@@ -12,9 +18,29 @@ record QuestState(Map<UUID, Quest> quests) {
|
|||||||
throw new IllegalArgumentException("Quest map key does not match quest id");
|
throw new IllegalArgumentException("Quest map key does not match quest id");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
Map<UUID, List<QuestClaim>> immutableClaims = new LinkedHashMap<>();
|
||||||
|
for (Map.Entry<UUID, List<QuestClaim>> entry
|
||||||
|
: Objects.requireNonNull(claims, "claims").entrySet()) {
|
||||||
|
List<QuestClaim> ownerClaims = List.copyOf(entry.getValue());
|
||||||
|
if (ownerClaims.stream().anyMatch(claim -> !claim.ownerId().equals(entry.getKey()))) {
|
||||||
|
throw new IllegalArgumentException("Claim map key does not match owner id");
|
||||||
|
}
|
||||||
|
immutableClaims.put(entry.getKey(), ownerClaims);
|
||||||
|
}
|
||||||
|
claims = Map.copyOf(immutableClaims);
|
||||||
|
notifications = Map.copyOf(Objects.requireNonNull(notifications, "notifications"));
|
||||||
|
for (Map.Entry<UUID, IssuerNotification> entry : notifications.entrySet()) {
|
||||||
|
if (!entry.getKey().equals(entry.getValue().id())) {
|
||||||
|
throw new IllegalArgumentException("Notification map key does not match id");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestState(Map<UUID, Quest> quests) {
|
||||||
|
this(quests, Map.of(), Map.of());
|
||||||
}
|
}
|
||||||
|
|
||||||
static QuestState empty() {
|
static QuestState empty() {
|
||||||
return new QuestState(Map.of());
|
return new QuestState(Map.of(), Map.of(), Map.of());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -12,6 +12,7 @@ public final class SpigotQuestBoardPlugin extends JavaPlugin {
|
|||||||
public void onEnable() {
|
public void onEnable() {
|
||||||
final BoardRegistry boards;
|
final BoardRegistry boards;
|
||||||
final QuestService quests;
|
final QuestService quests;
|
||||||
|
final PlayerCommandSettings playerCommands;
|
||||||
try {
|
try {
|
||||||
boards = new BoardRegistry(new YamlBoardRepository(
|
boards = new BoardRegistry(new YamlBoardRepository(
|
||||||
getDataFolder().toPath().resolve("boards.yml")
|
getDataFolder().toPath().resolve("boards.yml")
|
||||||
@@ -19,33 +20,79 @@ public final class SpigotQuestBoardPlugin extends JavaPlugin {
|
|||||||
quests = new QuestService(new YamlQuestRepository(
|
quests = new QuestService(new YamlQuestRepository(
|
||||||
getDataFolder().toPath().resolve("quests.yml")
|
getDataFolder().toPath().resolve("quests.yml")
|
||||||
));
|
));
|
||||||
|
playerCommands = new PlayerCommandSettings(
|
||||||
|
new YamlPlayerCommandSettingsRepository(
|
||||||
|
getDataFolder().toPath().resolve("settings.yml")
|
||||||
|
)
|
||||||
|
);
|
||||||
} catch (IOException exception) {
|
} catch (IOException exception) {
|
||||||
getLogger().log(Level.SEVERE, "Could not load quest board state", exception);
|
getLogger().log(Level.SEVERE, "Could not load plugin state", exception);
|
||||||
getServer().getPluginManager().disablePlugin(this);
|
getServer().getPluginManager().disablePlugin(this);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
QuestAdminCommand admin = new QuestAdminCommand(boards);
|
|
||||||
command("questadmin").setExecutor(admin);
|
|
||||||
|
|
||||||
QuestCreationGateway creator = new QuestCreationController(
|
QuestCreationGateway creator = new QuestCreationController(
|
||||||
quests, new BukkitBlockMaterialCatalog(), new BukkitHeldRewardInventory()
|
quests, new BukkitBlockMaterialCatalog(), new BukkitHeldRewardInventory()
|
||||||
);
|
);
|
||||||
QuestCommand questCommand = new QuestCommand(creator, quests, Clock.systemUTC());
|
Clock clock = Clock.systemUTC();
|
||||||
command("quests").setExecutor(questCommand);
|
BukkitIssuerNotifier notifier = new BukkitIssuerNotifier(
|
||||||
command("quests").setTabCompleter(questCommand);
|
quests, getServer(), getLogger()
|
||||||
|
);
|
||||||
|
QuestCompletionGateway completer = new QuestCompletionController(
|
||||||
|
quests, new BukkitQuestCompletionInventory(), notifier
|
||||||
|
);
|
||||||
|
QuestCancellationGateway canceller = new QuestCancellationController(quests);
|
||||||
|
QuestClaimGateway claimant = new QuestClaimController(
|
||||||
|
quests, new BukkitQuestClaimInventory()
|
||||||
|
);
|
||||||
|
CommandHandlers handlers = commandHandlers(
|
||||||
|
boards, playerCommands, creator, quests, completer, canceller, claimant, clock
|
||||||
|
);
|
||||||
|
command("questadmin").setExecutor(handlers.admin());
|
||||||
|
command("questadmin").setTabCompleter(handlers.admin());
|
||||||
|
command("quests").setExecutor(handlers.quests());
|
||||||
|
command("quests").setTabCompleter(handlers.quests());
|
||||||
|
getServer().getPluginManager().registerEvents(notifier, this);
|
||||||
getServer().getPluginManager().registerEvents(
|
getServer().getPluginManager().registerEvents(
|
||||||
new QuestBoardInteractionListener(
|
new QuestBoardInteractionListener(
|
||||||
boards, new QuestBoardDialogUi(creator, quests, Clock.systemUTC())
|
boards, new QuestBoardDialogUi(
|
||||||
|
creator, quests, completer, canceller, claimant, clock
|
||||||
|
)
|
||||||
),
|
),
|
||||||
this
|
this
|
||||||
);
|
);
|
||||||
|
getServer().getScheduler().runTaskTimer(
|
||||||
|
this,
|
||||||
|
new QuestExpiryTask(quests, notifier, clock, getLogger()),
|
||||||
|
0L,
|
||||||
|
20L
|
||||||
|
);
|
||||||
getLogger().info(
|
getLogger().info(
|
||||||
"Spigot Quest Board enabled with " + boards.size() + " boards and "
|
"Spigot Quest Board enabled with " + boards.size() + " boards and "
|
||||||
+ quests.state().quests().size() + " quests."
|
+ quests.state().quests().size() + " quests."
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
static CommandHandlers commandHandlers(
|
||||||
|
BoardRegistry boards,
|
||||||
|
PlayerCommandSettings playerCommands,
|
||||||
|
QuestCreationGateway creator,
|
||||||
|
QuestBrowser browser,
|
||||||
|
QuestCompletionGateway completer,
|
||||||
|
QuestCancellationGateway canceller,
|
||||||
|
QuestClaimGateway claimant,
|
||||||
|
Clock clock
|
||||||
|
) {
|
||||||
|
return new CommandHandlers(
|
||||||
|
new QuestAdminCommand(boards, playerCommands),
|
||||||
|
new QuestCommand(
|
||||||
|
creator, browser, completer, canceller, claimant, clock, playerCommands
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
record CommandHandlers(QuestAdminCommand admin, QuestCommand quests) { }
|
||||||
|
|
||||||
private PluginCommand command(String name) {
|
private PluginCommand command(String name) {
|
||||||
return Objects.requireNonNull(getCommand(name), "Missing command metadata for " + name);
|
return Objects.requireNonNull(getCommand(name), "Missing command metadata for " + name);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,53 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.nio.file.AtomicMoveNotSupportedException;
|
||||||
|
import java.nio.file.Files;
|
||||||
|
import java.nio.file.Path;
|
||||||
|
import java.nio.file.StandardCopyOption;
|
||||||
|
import java.util.Objects;
|
||||||
|
import org.bukkit.configuration.InvalidConfigurationException;
|
||||||
|
import org.bukkit.configuration.file.YamlConfiguration;
|
||||||
|
|
||||||
|
final class YamlPlayerCommandSettingsRepository implements PlayerCommandSettingsRepository {
|
||||||
|
private static final String ENABLED_PATH = "player-commands.enabled";
|
||||||
|
private final Path path;
|
||||||
|
|
||||||
|
YamlPlayerCommandSettingsRepository(Path path) {
|
||||||
|
this.path = Objects.requireNonNull(path, "path");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean loadEnabled() throws IOException {
|
||||||
|
if (!Files.exists(path)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
YamlConfiguration yaml = new YamlConfiguration();
|
||||||
|
try {
|
||||||
|
yaml.load(path.toFile());
|
||||||
|
} catch (InvalidConfigurationException exception) {
|
||||||
|
throw new IOException("Invalid player command settings", exception);
|
||||||
|
}
|
||||||
|
return yaml.getBoolean(ENABLED_PATH, false);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void saveEnabled(boolean enabled) throws IOException {
|
||||||
|
YamlConfiguration yaml = new YamlConfiguration();
|
||||||
|
yaml.set(ENABLED_PATH, enabled);
|
||||||
|
Path parent = path.toAbsolutePath().getParent();
|
||||||
|
Files.createDirectories(parent);
|
||||||
|
Path temporary = Files.createTempFile(parent, path.getFileName().toString(), ".tmp");
|
||||||
|
try {
|
||||||
|
yaml.save(temporary.toFile());
|
||||||
|
try {
|
||||||
|
Files.move(temporary, path, StandardCopyOption.REPLACE_EXISTING,
|
||||||
|
StandardCopyOption.ATOMIC_MOVE);
|
||||||
|
} catch (AtomicMoveNotSupportedException exception) {
|
||||||
|
Files.move(temporary, path, StandardCopyOption.REPLACE_EXISTING);
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
Files.deleteIfExists(temporary);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -34,6 +34,8 @@ final class YamlQuestRepository implements QuestRepository {
|
|||||||
throw new IOException("Invalid quest state", exception);
|
throw new IOException("Invalid quest state", exception);
|
||||||
}
|
}
|
||||||
Map<UUID, Quest> quests = new LinkedHashMap<>();
|
Map<UUID, Quest> quests = new LinkedHashMap<>();
|
||||||
|
Map<UUID, List<QuestClaim>> claims = new LinkedHashMap<>();
|
||||||
|
Map<UUID, IssuerNotification> notifications = new LinkedHashMap<>();
|
||||||
try {
|
try {
|
||||||
for (Map<?, ?> entry : yaml.getMapList("quests")) {
|
for (Map<?, ?> entry : yaml.getMapList("quests")) {
|
||||||
UUID id = UUID.fromString(requiredString(entry, "id"));
|
UUID id = UUID.fromString(requiredString(entry, "id"));
|
||||||
@@ -43,7 +45,7 @@ final class YamlQuestRepository implements QuestRepository {
|
|||||||
requiredString(entry, "issuer-name"),
|
requiredString(entry, "issuer-name"),
|
||||||
requiredString(entry, "requested-material"),
|
requiredString(entry, "requested-material"),
|
||||||
requiredInteger(entry, "requested-amount"),
|
requiredInteger(entry, "requested-amount"),
|
||||||
readRewards(entry.get("reward")),
|
readItems(entry.get("reward"), "reward"),
|
||||||
Instant.parse(requiredString(entry, "created-at")),
|
Instant.parse(requiredString(entry, "created-at")),
|
||||||
Instant.parse(requiredString(entry, "expires-at")),
|
Instant.parse(requiredString(entry, "expires-at")),
|
||||||
readStatus(entry.get("status"))
|
readStatus(entry.get("status"))
|
||||||
@@ -52,10 +54,37 @@ final class YamlQuestRepository implements QuestRepository {
|
|||||||
throw new IllegalArgumentException("Duplicate quest id: " + id);
|
throw new IllegalArgumentException("Duplicate quest id: " + id);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
for (Map<?, ?> entry : yaml.getMapList("claims")) {
|
||||||
|
QuestClaim claim = new QuestClaim(
|
||||||
|
UUID.fromString(requiredString(entry, "id")),
|
||||||
|
UUID.fromString(requiredString(entry, "quest-id")),
|
||||||
|
UUID.fromString(requiredString(entry, "owner-id")),
|
||||||
|
readItems(entry.get("items"), "claim items"),
|
||||||
|
Instant.parse(requiredString(entry, "created-at")),
|
||||||
|
readClaimSource(entry.get("source"), quests.get(
|
||||||
|
UUID.fromString(requiredString(entry, "quest-id"))
|
||||||
|
))
|
||||||
|
);
|
||||||
|
claims.computeIfAbsent(claim.ownerId(), ignored -> new ArrayList<>()).add(claim);
|
||||||
|
}
|
||||||
|
for (Map<?, ?> entry : yaml.getMapList("notifications")) {
|
||||||
|
IssuerNotification notification = new IssuerNotification(
|
||||||
|
UUID.fromString(requiredString(entry, "id")),
|
||||||
|
UUID.fromString(requiredString(entry, "quest-id")),
|
||||||
|
UUID.fromString(requiredString(entry, "recipient-id")),
|
||||||
|
requiredString(entry, "message"),
|
||||||
|
Instant.parse(requiredString(entry, "created-at"))
|
||||||
|
);
|
||||||
|
if (notifications.put(notification.id(), notification) != null) {
|
||||||
|
throw new IllegalArgumentException(
|
||||||
|
"Duplicate notification id: " + notification.id()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
} catch (IllegalArgumentException | DateTimeParseException exception) {
|
} catch (IllegalArgumentException | DateTimeParseException exception) {
|
||||||
throw new IOException("Invalid quest record", exception);
|
throw new IOException("Invalid quest record", exception);
|
||||||
}
|
}
|
||||||
return new QuestState(quests);
|
return new QuestState(quests, claims, notifications);
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
@@ -72,20 +101,37 @@ final class YamlQuestRepository implements QuestRepository {
|
|||||||
serialized.put("created-at", quest.createdAt().toString());
|
serialized.put("created-at", quest.createdAt().toString());
|
||||||
serialized.put("expires-at", quest.expiresAt().toString());
|
serialized.put("expires-at", quest.expiresAt().toString());
|
||||||
serialized.put("status", quest.status().name());
|
serialized.put("status", quest.status().name());
|
||||||
List<Map<String, Object>> rewards = new ArrayList<>();
|
serialized.put("reward", writeItems(quest.reward()));
|
||||||
for (EscrowItem reward : quest.reward()) {
|
|
||||||
Map<String, Object> serializedReward = new LinkedHashMap<>();
|
|
||||||
serializedReward.put("material", reward.material());
|
|
||||||
serializedReward.put("amount", reward.amount());
|
|
||||||
if (reward.serializedItem() != null) {
|
|
||||||
serializedReward.put("item-data", reward.serializedItem());
|
|
||||||
}
|
|
||||||
rewards.add(serializedReward);
|
|
||||||
}
|
|
||||||
serialized.put("reward", rewards);
|
|
||||||
serializedQuests.add(serialized);
|
serializedQuests.add(serialized);
|
||||||
}
|
}
|
||||||
yaml.set("quests", serializedQuests);
|
yaml.set("quests", serializedQuests);
|
||||||
|
|
||||||
|
List<Map<String, Object>> serializedClaims = new ArrayList<>();
|
||||||
|
for (List<QuestClaim> ownerClaims : state.claims().values()) {
|
||||||
|
for (QuestClaim claim : ownerClaims) {
|
||||||
|
Map<String, Object> serialized = new LinkedHashMap<>();
|
||||||
|
serialized.put("id", claim.id().toString());
|
||||||
|
serialized.put("quest-id", claim.questId().toString());
|
||||||
|
serialized.put("owner-id", claim.ownerId().toString());
|
||||||
|
serialized.put("created-at", claim.createdAt().toString());
|
||||||
|
serialized.put("source", claim.source().name());
|
||||||
|
serialized.put("items", writeItems(claim.items()));
|
||||||
|
serializedClaims.add(serialized);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
yaml.set("claims", serializedClaims);
|
||||||
|
|
||||||
|
List<Map<String, Object>> serializedNotifications = new ArrayList<>();
|
||||||
|
for (IssuerNotification notification : state.notifications().values()) {
|
||||||
|
Map<String, Object> serialized = new LinkedHashMap<>();
|
||||||
|
serialized.put("id", notification.id().toString());
|
||||||
|
serialized.put("quest-id", notification.questId().toString());
|
||||||
|
serialized.put("recipient-id", notification.recipientId().toString());
|
||||||
|
serialized.put("message", notification.message());
|
||||||
|
serialized.put("created-at", notification.createdAt().toString());
|
||||||
|
serializedNotifications.add(serialized);
|
||||||
|
}
|
||||||
|
yaml.set("notifications", serializedNotifications);
|
||||||
writeAtomically(yaml);
|
writeAtomically(yaml);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -106,24 +152,52 @@ final class YamlQuestRepository implements QuestRepository {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private static List<EscrowItem> readRewards(Object value) {
|
private static List<EscrowItem> readItems(Object value, String description) {
|
||||||
if (!(value instanceof List<?> entries) || entries.isEmpty()) {
|
if (!(value instanceof List<?> entries) || entries.isEmpty()) {
|
||||||
throw new IllegalArgumentException("Missing reward");
|
throw new IllegalArgumentException("Missing " + description);
|
||||||
}
|
}
|
||||||
List<EscrowItem> rewards = new ArrayList<>();
|
List<EscrowItem> items = new ArrayList<>();
|
||||||
for (Object rawEntry : entries) {
|
for (Object rawEntry : entries) {
|
||||||
if (!(rawEntry instanceof Map<?, ?> entry)) {
|
if (!(rawEntry instanceof Map<?, ?> entry)) {
|
||||||
throw new IllegalArgumentException("Invalid reward");
|
throw new IllegalArgumentException("Invalid " + description);
|
||||||
}
|
}
|
||||||
Object data = entry.get("item-data");
|
Object data = entry.get("item-data");
|
||||||
if (data != null && !(data instanceof String)) {
|
if (data != null && !(data instanceof String)) {
|
||||||
throw new IllegalArgumentException("Invalid item-data");
|
throw new IllegalArgumentException("Invalid item-data");
|
||||||
}
|
}
|
||||||
rewards.add(new EscrowItem(
|
items.add(new EscrowItem(
|
||||||
requiredString(entry, "material"), requiredInteger(entry, "amount"), (String) data
|
requiredString(entry, "material"), requiredInteger(entry, "amount"), (String) data
|
||||||
));
|
));
|
||||||
}
|
}
|
||||||
return rewards;
|
return items;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static List<Map<String, Object>> writeItems(List<EscrowItem> items) {
|
||||||
|
List<Map<String, Object>> serializedItems = new ArrayList<>();
|
||||||
|
for (EscrowItem item : items) {
|
||||||
|
Map<String, Object> serialized = new LinkedHashMap<>();
|
||||||
|
serialized.put("material", item.material());
|
||||||
|
serialized.put("amount", item.amount());
|
||||||
|
if (item.serializedItem() != null) {
|
||||||
|
serialized.put("item-data", item.serializedItem());
|
||||||
|
}
|
||||||
|
serializedItems.add(serialized);
|
||||||
|
}
|
||||||
|
return serializedItems;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static QuestClaimSource readClaimSource(Object value, Quest quest) {
|
||||||
|
if (value instanceof String source) {
|
||||||
|
return QuestClaimSource.valueOf(source);
|
||||||
|
}
|
||||||
|
if (value != null) {
|
||||||
|
throw new IllegalArgumentException("Invalid claim source");
|
||||||
|
}
|
||||||
|
if (quest == null || quest.status() == QuestStatus.COMPLETED) {
|
||||||
|
return QuestClaimSource.COMPLETION;
|
||||||
|
}
|
||||||
|
return quest.status() == QuestStatus.EXPIRED
|
||||||
|
? QuestClaimSource.EXPIRATION : QuestClaimSource.CANCELLATION;
|
||||||
}
|
}
|
||||||
|
|
||||||
private static QuestStatus readStatus(Object value) {
|
private static QuestStatus readStatus(Object value) {
|
||||||
|
|||||||
@@ -0,0 +1,109 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
import static org.mockito.ArgumentMatchers.contains;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
import org.bukkit.Server;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class BukkitIssuerNotifierTest {
|
||||||
|
@Test
|
||||||
|
void onlineIssuerIsNotifiedImmediatelyAndDurablePendingStateIsCleared() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = completedService(repository);
|
||||||
|
UUID issuer = service.state().notifications().values().iterator().next().recipientId();
|
||||||
|
Server server = mock(Server.class);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(server.getPlayer(issuer)).thenReturn(player);
|
||||||
|
when(player.isOnline()).thenReturn(true);
|
||||||
|
when(player.getUniqueId()).thenReturn(issuer);
|
||||||
|
BukkitIssuerNotifier notifier = new BukkitIssuerNotifier(
|
||||||
|
service, server, Logger.getAnonymousLogger()
|
||||||
|
);
|
||||||
|
|
||||||
|
notifier.notifyIfOnline(issuer);
|
||||||
|
|
||||||
|
verify(player).sendMessage(contains("can be claimed at a quest board"));
|
||||||
|
assertTrue(service.state().notifications().isEmpty());
|
||||||
|
assertTrue(repository.state.notifications().isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void failedNotificationAcknowledgementRemainsPendingForRetry() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = completedService(repository);
|
||||||
|
IssuerNotification notification = service.state().notifications().values().iterator().next();
|
||||||
|
Server server = mock(Server.class);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(server.getPlayer(notification.recipientId())).thenReturn(player);
|
||||||
|
when(player.isOnline()).thenReturn(true);
|
||||||
|
when(player.getUniqueId()).thenReturn(notification.recipientId());
|
||||||
|
BukkitIssuerNotifier notifier = new BukkitIssuerNotifier(
|
||||||
|
service, server, Logger.getAnonymousLogger()
|
||||||
|
);
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
notifier.notifyIfOnline(notification.recipientId());
|
||||||
|
assertEquals(1, service.pendingNotifications(notification.recipientId()).size());
|
||||||
|
|
||||||
|
repository.fail = false;
|
||||||
|
notifier.notifyIfOnline(notification.recipientId());
|
||||||
|
assertTrue(service.pendingNotifications(notification.recipientId()).isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void offlineNotificationRemainsDurableUntilNextLogin() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = completedService(repository);
|
||||||
|
IssuerNotification notification = service.state().notifications().values().iterator().next();
|
||||||
|
Server server = mock(Server.class);
|
||||||
|
when(server.getPlayer(notification.recipientId())).thenReturn(null);
|
||||||
|
BukkitIssuerNotifier notifier = new BukkitIssuerNotifier(
|
||||||
|
service, server, Logger.getAnonymousLogger()
|
||||||
|
);
|
||||||
|
|
||||||
|
notifier.notifyIfOnline(notification.recipientId());
|
||||||
|
assertEquals(1, service.state().notifications().size());
|
||||||
|
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(player.getUniqueId()).thenReturn(notification.recipientId());
|
||||||
|
notifier.deliver(player);
|
||||||
|
|
||||||
|
verify(player).sendMessage(notification.message());
|
||||||
|
assertTrue(service.state().notifications().isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static QuestService completedService(Repository repository) throws Exception {
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = service.create(
|
||||||
|
UUID.randomUUID(), "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 1, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
return service;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override
|
||||||
|
public void save(QuestState candidate) throws java.io.IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new java.io.IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,94 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.mockito.ArgumentMatchers.any;
|
||||||
|
import static org.mockito.Mockito.doThrow;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.Location;
|
||||||
|
import org.bukkit.World;
|
||||||
|
import org.bukkit.entity.Item;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.bukkit.inventory.ItemStack;
|
||||||
|
import org.bukkit.inventory.PlayerInventory;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class BukkitQuestClaimInventoryTest {
|
||||||
|
@Test
|
||||||
|
void inventoryOverflowIsDroppedAtFeetWithOwnerProtection() {
|
||||||
|
UUID owner = UUID.randomUUID();
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
PlayerInventory inventory = mock(PlayerInventory.class);
|
||||||
|
World world = mock(World.class);
|
||||||
|
Location feet = mock(Location.class);
|
||||||
|
Item dropped = mock(Item.class);
|
||||||
|
ItemStack requested = mock(ItemStack.class);
|
||||||
|
ItemStack requestedCopy = mock(ItemStack.class);
|
||||||
|
ItemStack leftover = mock(ItemStack.class);
|
||||||
|
ItemStack leftoverCopy = mock(ItemStack.class);
|
||||||
|
when(requested.clone()).thenReturn(requestedCopy);
|
||||||
|
when(leftover.clone()).thenReturn(leftoverCopy);
|
||||||
|
when(leftover.getAmount()).thenReturn(2);
|
||||||
|
when(player.getUniqueId()).thenReturn(owner);
|
||||||
|
when(player.getInventory()).thenReturn(inventory);
|
||||||
|
when(player.getWorld()).thenReturn(world);
|
||||||
|
when(player.getLocation()).thenReturn(feet);
|
||||||
|
when(inventory.getStorageContents()).thenReturn(new ItemStack[36]);
|
||||||
|
HashMap<Integer, ItemStack> leftovers = new HashMap<>();
|
||||||
|
leftovers.put(0, leftover);
|
||||||
|
when(inventory.addItem(any(ItemStack.class))).thenReturn(leftovers);
|
||||||
|
when(world.dropItem(any(Location.class), any(ItemStack.class))).thenReturn(dropped);
|
||||||
|
|
||||||
|
QuestClaimInventory.Delivery delivery = BukkitQuestClaimInventory.deliver(
|
||||||
|
player, List.of(requested)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(2, delivery.overflowAmount());
|
||||||
|
verify(world).dropItem(feet, leftoverCopy);
|
||||||
|
verify(dropped).setOwner(owner);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void ownerProtectionFailureRestoresInventoryAndRemovesPartialDrop() {
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
PlayerInventory inventory = mock(PlayerInventory.class);
|
||||||
|
World world = mock(World.class);
|
||||||
|
Location feet = mock(Location.class);
|
||||||
|
Item dropped = mock(Item.class);
|
||||||
|
ItemStack requested = mock(ItemStack.class);
|
||||||
|
ItemStack requestedCopy = mock(ItemStack.class);
|
||||||
|
ItemStack leftover = mock(ItemStack.class);
|
||||||
|
ItemStack leftoverCopy = mock(ItemStack.class);
|
||||||
|
ItemStack existing = mock(ItemStack.class);
|
||||||
|
ItemStack existingCopy = mock(ItemStack.class);
|
||||||
|
when(requested.clone()).thenReturn(requestedCopy);
|
||||||
|
when(leftover.clone()).thenReturn(leftoverCopy);
|
||||||
|
when(existing.clone()).thenReturn(existingCopy);
|
||||||
|
when(existingCopy.clone()).thenReturn(existingCopy);
|
||||||
|
ItemStack[] original = new ItemStack[] {existing};
|
||||||
|
when(player.getInventory()).thenReturn(inventory);
|
||||||
|
when(player.getWorld()).thenReturn(world);
|
||||||
|
when(player.getLocation()).thenReturn(feet);
|
||||||
|
when(player.getUniqueId()).thenReturn(UUID.randomUUID());
|
||||||
|
when(inventory.getStorageContents()).thenReturn(original);
|
||||||
|
HashMap<Integer, ItemStack> leftovers = new HashMap<>();
|
||||||
|
leftovers.put(0, leftover);
|
||||||
|
when(inventory.addItem(requestedCopy)).thenReturn(leftovers);
|
||||||
|
when(world.dropItem(any(Location.class), any(ItemStack.class))).thenReturn(dropped);
|
||||||
|
doThrow(new IllegalStateException("owner rejected")).when(dropped).setOwner(any());
|
||||||
|
|
||||||
|
assertThrows(
|
||||||
|
IllegalStateException.class,
|
||||||
|
() -> BukkitQuestClaimInventory.deliver(player, List.of(requested))
|
||||||
|
);
|
||||||
|
|
||||||
|
verify(inventory).setStorageContents(any(ItemStack[].class));
|
||||||
|
verify(dropped).remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,52 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.nio.file.Path;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.junit.jupiter.api.io.TempDir;
|
||||||
|
|
||||||
|
final class PlayerCommandSettingsTest {
|
||||||
|
@TempDir Path temporaryDirectory;
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void defaultsDisabledAndPersistsEnabledState() throws Exception {
|
||||||
|
Path path = temporaryDirectory.resolve("settings.yml");
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new YamlPlayerCommandSettingsRepository(path)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertFalse(settings.enabled());
|
||||||
|
settings.setEnabled(true);
|
||||||
|
|
||||||
|
PlayerCommandSettings reloaded = new PlayerCommandSettings(
|
||||||
|
new YamlPlayerCommandSettingsRepository(path)
|
||||||
|
);
|
||||||
|
assertTrue(reloaded.enabled());
|
||||||
|
|
||||||
|
reloaded.setEnabled(false);
|
||||||
|
|
||||||
|
assertFalse(new PlayerCommandSettings(
|
||||||
|
new YamlPlayerCommandSettingsRepository(path)
|
||||||
|
).enabled());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void persistenceFailureLeavesPriorState() throws Exception {
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new PlayerCommandSettingsRepository() {
|
||||||
|
@Override public boolean loadEnabled() { return false; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) throws IOException {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
assertThrows(IOException.class, () -> settings.setEnabled(true));
|
||||||
|
|
||||||
|
assertFalse(settings.enabled());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.time.Clock;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Set;
|
||||||
|
import org.bukkit.command.Command;
|
||||||
|
import org.bukkit.command.CommandSender;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class PluginCommandWiringTest {
|
||||||
|
@Test
|
||||||
|
void adminAndPlayerCommandsShareThePersistedSetting() throws Exception {
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new PlayerCommandSettingsRepository() {
|
||||||
|
private boolean enabled;
|
||||||
|
@Override public boolean loadEnabled() { return enabled; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) { this.enabled = enabled; }
|
||||||
|
}
|
||||||
|
);
|
||||||
|
BoardRepository boards = new BoardRepository() {
|
||||||
|
@Override public BoardState load() { return new BoardState(Set.of()); }
|
||||||
|
@Override public void save(BoardState state) { }
|
||||||
|
};
|
||||||
|
QuestBrowser browser = mock(QuestBrowser.class);
|
||||||
|
when(browser.activeQuests(org.mockito.ArgumentMatchers.any())).thenReturn(List.of());
|
||||||
|
SpigotQuestBoardPlugin.CommandHandlers handlers =
|
||||||
|
SpigotQuestBoardPlugin.commandHandlers(
|
||||||
|
new BoardRegistry(boards), settings, mock(QuestCreationGateway.class), browser,
|
||||||
|
null, null, null, Clock.systemUTC()
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
CommandSender admin = mock(CommandSender.class);
|
||||||
|
when(admin.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
||||||
|
Command command = mock(Command.class);
|
||||||
|
|
||||||
|
assertTrue(handlers.quests().onCommand(
|
||||||
|
player, command, "quests", new String[] {"list"}
|
||||||
|
));
|
||||||
|
verify(player).sendMessage(
|
||||||
|
"Player quest commands are disabled. Use a physical quest board instead."
|
||||||
|
);
|
||||||
|
|
||||||
|
handlers.admin().onCommand(
|
||||||
|
admin, command, "questadmin", new String[] {"commands", "enable"}
|
||||||
|
);
|
||||||
|
handlers.quests().onCommand(player, command, "quests", new String[] {"list"});
|
||||||
|
|
||||||
|
verify(browser).activeQuests(org.mockito.ArgumentMatchers.any());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,6 @@
|
|||||||
package games.dmg.spigotquestboard;
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
import static org.mockito.Mockito.mock;
|
import static org.mockito.Mockito.mock;
|
||||||
@@ -7,6 +8,8 @@ import static org.mockito.Mockito.never;
|
|||||||
import static org.mockito.Mockito.verify;
|
import static org.mockito.Mockito.verify;
|
||||||
import static org.mockito.Mockito.when;
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.List;
|
||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
import java.util.UUID;
|
import java.util.UUID;
|
||||||
import org.bukkit.World;
|
import org.bukkit.World;
|
||||||
@@ -20,7 +23,10 @@ final class QuestAdminCommandTest {
|
|||||||
@Test
|
@Test
|
||||||
void unauthorizedSenderCannotCreateBoard() throws Exception {
|
void unauthorizedSenderCannotCreateBoard() throws Exception {
|
||||||
MemoryBoardRepository repository = new MemoryBoardRepository();
|
MemoryBoardRepository repository = new MemoryBoardRepository();
|
||||||
QuestAdminCommand executor = new QuestAdminCommand(new BoardRegistry(repository));
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(repository),
|
||||||
|
new PlayerCommandSettings(new MemoryPlayerCommandSettingsRepository())
|
||||||
|
);
|
||||||
Player player = mock(Player.class);
|
Player player = mock(Player.class);
|
||||||
when(player.hasPermission("spigotquestboard.admin")).thenReturn(false);
|
when(player.hasPermission("spigotquestboard.admin")).thenReturn(false);
|
||||||
|
|
||||||
@@ -30,10 +36,111 @@ final class QuestAdminCommandTest {
|
|||||||
assertTrue(repository.state.boards().isEmpty());
|
assertTrue(repository.state.boards().isEmpty());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void authorizedSenderCanEnableAndDisablePlayerCommands() throws Exception {
|
||||||
|
MemoryPlayerCommandSettingsRepository settingsRepository =
|
||||||
|
new MemoryPlayerCommandSettingsRepository();
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(settingsRepository);
|
||||||
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(new MemoryBoardRepository()), settings
|
||||||
|
);
|
||||||
|
CommandSender sender = mock(CommandSender.class);
|
||||||
|
when(sender.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
||||||
|
|
||||||
|
assertTrue(executor.onCommand(
|
||||||
|
sender, mock(Command.class), "questadmin", new String[] {"commands", "enable"}
|
||||||
|
));
|
||||||
|
assertTrue(settings.enabled());
|
||||||
|
assertTrue(executor.onCommand(
|
||||||
|
sender, mock(Command.class), "questadmin", new String[] {"commands", "disable"}
|
||||||
|
));
|
||||||
|
|
||||||
|
assertFalse(settings.enabled());
|
||||||
|
verify(sender).sendMessage("Player quest commands enabled.");
|
||||||
|
verify(sender).sendMessage("Player quest commands disabled.");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void unauthorizedSenderCannotChangePlayerCommands() throws Exception {
|
||||||
|
MemoryPlayerCommandSettingsRepository repository =
|
||||||
|
new MemoryPlayerCommandSettingsRepository();
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(repository);
|
||||||
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(new MemoryBoardRepository()), settings
|
||||||
|
);
|
||||||
|
CommandSender sender = mock(CommandSender.class);
|
||||||
|
when(sender.hasPermission("spigotquestboard.admin")).thenReturn(false);
|
||||||
|
|
||||||
|
executor.onCommand(
|
||||||
|
sender, mock(Command.class), "questadmin", new String[] {"commands", "enable"}
|
||||||
|
);
|
||||||
|
|
||||||
|
assertFalse(settings.enabled());
|
||||||
|
assertEquals(0, repository.saves);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void settingsPersistenceFailureIsReportedAndLeavesPriorState() throws Exception {
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new PlayerCommandSettingsRepository() {
|
||||||
|
@Override public boolean loadEnabled() { return false; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) throws IOException {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
);
|
||||||
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(new MemoryBoardRepository()), settings
|
||||||
|
);
|
||||||
|
CommandSender sender = mock(CommandSender.class);
|
||||||
|
when(sender.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
||||||
|
|
||||||
|
executor.onCommand(
|
||||||
|
sender, mock(Command.class), "questadmin", new String[] {"commands", "enable"}
|
||||||
|
);
|
||||||
|
|
||||||
|
assertFalse(settings.enabled());
|
||||||
|
verify(sender).sendMessage(
|
||||||
|
"Player command setting could not be saved. Player quest commands remain disabled."
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void autocompleteIsPermissionAwareAndContextual() throws Exception {
|
||||||
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(new MemoryBoardRepository()),
|
||||||
|
new PlayerCommandSettings(new MemoryPlayerCommandSettingsRepository())
|
||||||
|
);
|
||||||
|
CommandSender authorized = mock(CommandSender.class);
|
||||||
|
when(authorized.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
||||||
|
CommandSender unauthorized = mock(CommandSender.class);
|
||||||
|
when(unauthorized.hasPermission("spigotquestboard.admin")).thenReturn(false);
|
||||||
|
Command command = mock(Command.class);
|
||||||
|
|
||||||
|
assertEquals(List.of("commands"), executor.onTabComplete(
|
||||||
|
authorized, command, "questadmin", new String[] {"com"}
|
||||||
|
));
|
||||||
|
assertEquals(List.of("enable"), executor.onTabComplete(
|
||||||
|
authorized, command, "questadmin", new String[] {"commands", "en"}
|
||||||
|
));
|
||||||
|
assertEquals(List.of("disable"), executor.onTabComplete(
|
||||||
|
authorized, command, "questadmin", new String[] {"commands", "di"}
|
||||||
|
));
|
||||||
|
assertTrue(executor.onTabComplete(
|
||||||
|
authorized, command, "questadmin", new String[] {"createboard", ""}
|
||||||
|
).isEmpty());
|
||||||
|
assertTrue(executor.onTabComplete(
|
||||||
|
unauthorized, command, "questadmin", new String[] {""}
|
||||||
|
).isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void registersTargetedPhysicalBlock() throws Exception {
|
void registersTargetedPhysicalBlock() throws Exception {
|
||||||
MemoryBoardRepository repository = new MemoryBoardRepository();
|
MemoryBoardRepository repository = new MemoryBoardRepository();
|
||||||
QuestAdminCommand executor = new QuestAdminCommand(new BoardRegistry(repository));
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(repository),
|
||||||
|
new PlayerCommandSettings(new MemoryPlayerCommandSettingsRepository())
|
||||||
|
);
|
||||||
Player player = mock(Player.class);
|
Player player = mock(Player.class);
|
||||||
Block block = mock(Block.class);
|
Block block = mock(Block.class);
|
||||||
World world = mock(World.class);
|
World world = mock(World.class);
|
||||||
@@ -57,7 +164,10 @@ final class QuestAdminCommandTest {
|
|||||||
@Test
|
@Test
|
||||||
void consoleAndMissingTargetDoNotChangeState() throws Exception {
|
void consoleAndMissingTargetDoNotChangeState() throws Exception {
|
||||||
MemoryBoardRepository repository = new MemoryBoardRepository();
|
MemoryBoardRepository repository = new MemoryBoardRepository();
|
||||||
QuestAdminCommand executor = new QuestAdminCommand(new BoardRegistry(repository));
|
QuestAdminCommand executor = new QuestAdminCommand(
|
||||||
|
new BoardRegistry(repository),
|
||||||
|
new PlayerCommandSettings(new MemoryPlayerCommandSettingsRepository())
|
||||||
|
);
|
||||||
CommandSender console = mock(CommandSender.class);
|
CommandSender console = mock(CommandSender.class);
|
||||||
when(console.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
when(console.hasPermission("spigotquestboard.admin")).thenReturn(true);
|
||||||
assertTrue(executor.onCommand(console, mock(Command.class), "questadmin", new String[] {"createboard"}));
|
assertTrue(executor.onCommand(console, mock(Command.class), "questadmin", new String[] {"createboard"}));
|
||||||
@@ -70,6 +180,18 @@ final class QuestAdminCommandTest {
|
|||||||
assertTrue(repository.state.boards().isEmpty());
|
assertTrue(repository.state.boards().isEmpty());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private static final class MemoryPlayerCommandSettingsRepository
|
||||||
|
implements PlayerCommandSettingsRepository {
|
||||||
|
private boolean enabled;
|
||||||
|
private int saves;
|
||||||
|
|
||||||
|
@Override public boolean loadEnabled() { return enabled; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) {
|
||||||
|
this.enabled = enabled;
|
||||||
|
saves++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private static final class MemoryBoardRepository implements BoardRepository {
|
private static final class MemoryBoardRepository implements BoardRepository {
|
||||||
private BoardState state = new BoardState(Set.of());
|
private BoardState state = new BoardState(Set.of());
|
||||||
@Override public BoardState load() { return state; }
|
@Override public BoardState load() { return state; }
|
||||||
|
|||||||
@@ -16,6 +16,42 @@ import org.junit.jupiter.api.Test;
|
|||||||
final class QuestBoardDialogUiTest {
|
final class QuestBoardDialogUiTest {
|
||||||
private static final Instant NOW = Instant.parse("2026-09-05T03:00:00Z");
|
private static final Instant NOW = Instant.parse("2026-09-05T03:00:00Z");
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void disabledPlayerCommandsDoNotGateBoardUiGateways() throws Exception {
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new PlayerCommandSettingsRepository() {
|
||||||
|
@Override public boolean loadEnabled() { return false; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) { }
|
||||||
|
}
|
||||||
|
);
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
RecordingCompleter completer = new RecordingCompleter();
|
||||||
|
RecordingCanceller canceller = new RecordingCanceller();
|
||||||
|
java.util.concurrent.atomic.AtomicReference<Player> claimantPlayer =
|
||||||
|
new java.util.concurrent.atomic.AtomicReference<>();
|
||||||
|
QuestClaimGateway claimant = player -> {
|
||||||
|
claimantPlayer.set(player);
|
||||||
|
return new ClaimCollectionResult(0, 0);
|
||||||
|
};
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(creator.quest(NOW)), completer, canceller, claimant,
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
|
||||||
|
ui.listingText();
|
||||||
|
ui.submit(player, "stone", "1");
|
||||||
|
ui.submitCompletion(player, "complete-id");
|
||||||
|
ui.submitCancellation(player, "cancel-id");
|
||||||
|
ui.submitClaim(player);
|
||||||
|
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(settings.enabled());
|
||||||
|
assertEquals("stone", creator.material);
|
||||||
|
assertEquals(player, completer.player);
|
||||||
|
assertEquals(player, canceller.player);
|
||||||
|
assertEquals(player, claimantPlayer.get());
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void dialogSubmissionUsesEquivalentCreationFlow() {
|
void dialogSubmissionUsesEquivalentCreationFlow() {
|
||||||
RecordingCreator creator = new RecordingCreator(false);
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
@@ -35,6 +71,119 @@ final class QuestBoardDialogUiTest {
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void completionActionUsesEquivalentCompletionFlow() {
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
RecordingCompleter completer = new RecordingCompleter();
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(), completer, Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
String id = UUID.randomUUID().toString();
|
||||||
|
|
||||||
|
ui.submitCompletion(player, id);
|
||||||
|
|
||||||
|
assertEquals(player, completer.player);
|
||||||
|
assertEquals(id, completer.questId);
|
||||||
|
assertEquals(NOW, completer.completedAt);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void claimActionUsesEquivalentCollectionFlowAtABoard() {
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
java.util.concurrent.atomic.AtomicReference<Player> claimantPlayer =
|
||||||
|
new java.util.concurrent.atomic.AtomicReference<>();
|
||||||
|
QuestClaimGateway claimant = player -> {
|
||||||
|
claimantPlayer.set(player);
|
||||||
|
return new ClaimCollectionResult(1, 0);
|
||||||
|
};
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(), null, null, claimant,
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
|
||||||
|
ui.submitClaim(player);
|
||||||
|
|
||||||
|
assertEquals(player, claimantPlayer.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void cancellationActionUsesEquivalentCancellationFlow() {
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
RecordingCanceller canceller = new RecordingCanceller();
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(), null, canceller, Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
String id = UUID.randomUUID().toString();
|
||||||
|
|
||||||
|
ui.submitCancellation(player, id);
|
||||||
|
|
||||||
|
assertEquals(player, canceller.player);
|
||||||
|
assertEquals(id, canceller.questId);
|
||||||
|
assertEquals(NOW, canceller.cancelledAt);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void boardListingDistinguishesDeliveredBlocksFromReturnedRewards() {
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
UUID owner = UUID.randomUUID();
|
||||||
|
org.mockito.Mockito.when(player.getUniqueId()).thenReturn(owner);
|
||||||
|
QuestClaimGateway claimant = new QuestClaimGateway() {
|
||||||
|
@Override
|
||||||
|
public ClaimCollectionResult collect(Player ignored) {
|
||||||
|
return new ClaimCollectionResult(0, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public List<QuestClaim> pendingClaims(Player ignored) {
|
||||||
|
return List.of(
|
||||||
|
new QuestClaim(
|
||||||
|
UUID.randomUUID(), UUID.randomUUID(), owner,
|
||||||
|
List.of(new EscrowItem("STONE", 2, null)), NOW,
|
||||||
|
QuestClaimSource.COMPLETION
|
||||||
|
),
|
||||||
|
new QuestClaim(
|
||||||
|
UUID.randomUUID(), UUID.randomUUID(), owner,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), NOW,
|
||||||
|
QuestClaimSource.EXPIRATION
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(), null, null, claimant,
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
|
||||||
|
String listing = ui.claimListingText(player);
|
||||||
|
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(listing.contains("DELIVERED BLOCKS — 2 STONE"));
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(
|
||||||
|
listing.contains("RETURNED REWARD (EXPIRATION) — 1 DIAMOND")
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void boardOnlyOffersCancellationActionsForPlayersOwnedActiveQuests() {
|
||||||
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
|
Quest owned = creator.quest(NOW);
|
||||||
|
Quest other = new Quest(
|
||||||
|
UUID.randomUUID(), UUID.randomUUID(), "Other", "DIRT", 1,
|
||||||
|
List.of(new EscrowItem("COAL", 1, null)), NOW, NOW.plusSeconds(604800)
|
||||||
|
);
|
||||||
|
QuestBoardDialogUi ui = new QuestBoardDialogUi(
|
||||||
|
creator, now -> List.of(owned, other), null, new RecordingCanceller(),
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player issuer = mock(Player.class);
|
||||||
|
org.mockito.Mockito.when(issuer.getUniqueId()).thenReturn(owned.issuerId());
|
||||||
|
|
||||||
|
assertEquals(List.of(owned.id().toString()), ui.cancellableQuestIds(issuer));
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void everyOpeningBuildsAListingFromTheCurrentActiveQuests() {
|
void everyOpeningBuildsAListingFromTheCurrentActiveQuests() {
|
||||||
RecordingCreator creator = new RecordingCreator(false);
|
RecordingCreator creator = new RecordingCreator(false);
|
||||||
@@ -60,6 +209,34 @@ final class QuestBoardDialogUiTest {
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private static final class RecordingCanceller implements QuestCancellationGateway {
|
||||||
|
private Player player;
|
||||||
|
private String questId;
|
||||||
|
private Instant cancelledAt;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestClaim cancel(Player cancellingPlayer, String id, Instant instant) {
|
||||||
|
player = cancellingPlayer;
|
||||||
|
questId = id;
|
||||||
|
cancelledAt = instant;
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class RecordingCompleter implements QuestCompletionGateway {
|
||||||
|
private Player player;
|
||||||
|
private String questId;
|
||||||
|
private Instant completedAt;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestCompletion complete(Player completingPlayer, String id, Instant instant) {
|
||||||
|
player = completingPlayer;
|
||||||
|
questId = id;
|
||||||
|
completedAt = instant;
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private static final class RecordingCreator implements QuestCreationGateway {
|
private static final class RecordingCreator implements QuestCreationGateway {
|
||||||
private final boolean fail;
|
private final boolean fail;
|
||||||
private String material;
|
private String material;
|
||||||
|
|||||||
@@ -0,0 +1,58 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.mockito.ArgumentMatchers.contains;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestCancellationControllerTest {
|
||||||
|
@Test
|
||||||
|
void cancelsAsPlayerIdentityAndCreatesClaimWithoutInventorySettlement() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = service.create(
|
||||||
|
issuer, "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 2, "exact-data")), Instant.EPOCH
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(player.getUniqueId()).thenReturn(issuer);
|
||||||
|
|
||||||
|
QuestClaim claim = new QuestCancellationController(service).cancel(
|
||||||
|
player, quest.id().toString(), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(quest.reward(), claim.items());
|
||||||
|
assertEquals(List.of(claim), service.state().claims().get(issuer));
|
||||||
|
verify(player).sendMessage(contains("claim"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void rejectsMalformedQuestIdentifier() throws Exception {
|
||||||
|
QuestCancellationController controller = new QuestCancellationController(
|
||||||
|
new QuestService(new Repository())
|
||||||
|
);
|
||||||
|
|
||||||
|
IllegalArgumentException exception = assertThrows(
|
||||||
|
IllegalArgumentException.class,
|
||||||
|
() -> controller.cancel(mock(Player.class), "not-a-uuid", Instant.EPOCH)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals("Quest identifier must be a valid UUID.", exception.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override public void save(QuestState candidate) throws IOException { state = candidate; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,159 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.concurrent.CountDownLatch;
|
||||||
|
import java.util.concurrent.ExecutorService;
|
||||||
|
import java.util.concurrent.Executors;
|
||||||
|
import java.util.concurrent.Future;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestCancellationServiceTest {
|
||||||
|
@Test
|
||||||
|
void onlyIssuerCanCancelAndExactRewardBecomesClaim() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
EscrowItem reward = new EscrowItem("DIAMOND", 3, "exact-item-data");
|
||||||
|
Quest quest = service.create(
|
||||||
|
issuer, "Issuer", "STONE", 64, List.of(reward), Instant.EPOCH
|
||||||
|
);
|
||||||
|
|
||||||
|
assertThrows(IllegalArgumentException.class, () -> service.cancel(
|
||||||
|
quest.id(), UUID.randomUUID(), Instant.EPOCH.plusSeconds(1)
|
||||||
|
));
|
||||||
|
QuestClaim claim = service.cancel(
|
||||||
|
quest.id(), issuer, Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(QuestStatus.CANCELLED, service.state().quests().get(quest.id()).status());
|
||||||
|
assertEquals(List.of(reward), claim.items());
|
||||||
|
assertEquals(List.of(claim), service.state().claims().get(issuer));
|
||||||
|
assertTrue(service.activeQuests(Instant.EPOCH.plusSeconds(1)).isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void completedCancelledAndExpiredQuestsCannotBeCancelled() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest completed = quest(service, issuer);
|
||||||
|
service.complete(
|
||||||
|
completed.id(), new EscrowItem("STONE", 1, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
Quest cancelled = quest(service, issuer);
|
||||||
|
service.cancel(cancelled.id(), issuer, Instant.EPOCH.plusSeconds(1));
|
||||||
|
Quest expired = quest(service, issuer);
|
||||||
|
|
||||||
|
assertThrows(IllegalStateException.class, () -> service.cancel(
|
||||||
|
completed.id(), issuer, Instant.EPOCH.plusSeconds(2)
|
||||||
|
));
|
||||||
|
assertThrows(IllegalStateException.class, () -> service.cancel(
|
||||||
|
cancelled.id(), issuer, Instant.EPOCH.plusSeconds(2)
|
||||||
|
));
|
||||||
|
assertThrows(IllegalStateException.class, () -> service.cancel(
|
||||||
|
expired.id(), issuer, expired.expiresAt()
|
||||||
|
));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void persistenceFailureLeavesQuestActiveAndRewardEscrowed() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = quest(service, issuer);
|
||||||
|
QuestState before = service.state();
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
assertThrows(IOException.class, () -> service.cancel(
|
||||||
|
quest.id(), issuer, Instant.EPOCH.plusSeconds(1)
|
||||||
|
));
|
||||||
|
|
||||||
|
assertEquals(before, service.state());
|
||||||
|
assertEquals(before, repository.state);
|
||||||
|
assertEquals(QuestStatus.ACTIVE, service.state().quests().get(quest.id()).status());
|
||||||
|
assertTrue(service.state().claims().isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void simultaneousCancellationAndCompletionSettleEscrowExactlyOnce() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = quest(service, issuer);
|
||||||
|
CountDownLatch start = new CountDownLatch(1);
|
||||||
|
try (ExecutorService executor = Executors.newFixedThreadPool(2)) {
|
||||||
|
List<Future<Boolean>> attempts = new ArrayList<>();
|
||||||
|
attempts.add(executor.submit(() -> {
|
||||||
|
start.await();
|
||||||
|
try {
|
||||||
|
service.cancel(quest.id(), issuer, Instant.EPOCH.plusSeconds(1));
|
||||||
|
return true;
|
||||||
|
} catch (IllegalStateException exception) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
attempts.add(executor.submit(() -> {
|
||||||
|
start.await();
|
||||||
|
try {
|
||||||
|
service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 1, null),
|
||||||
|
Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
return true;
|
||||||
|
} catch (IllegalStateException exception) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
start.countDown();
|
||||||
|
assertEquals(1, attempts.stream().filter(attempt -> {
|
||||||
|
try {
|
||||||
|
return attempt.get();
|
||||||
|
} catch (Exception exception) {
|
||||||
|
throw new AssertionError(exception);
|
||||||
|
}
|
||||||
|
}).count());
|
||||||
|
}
|
||||||
|
|
||||||
|
QuestStatus status = service.state().quests().get(quest.id()).status();
|
||||||
|
assertTrue(status == QuestStatus.CANCELLED || status == QuestStatus.COMPLETED);
|
||||||
|
assertEquals(1, service.state().claims().get(issuer).size());
|
||||||
|
QuestClaim settlement = service.state().claims().get(issuer).getFirst();
|
||||||
|
if (status == QuestStatus.CANCELLED) {
|
||||||
|
assertEquals(quest.reward(), settlement.items());
|
||||||
|
assertTrue(service.state().notifications().isEmpty());
|
||||||
|
} else {
|
||||||
|
assertEquals(List.of(new EscrowItem("STONE", 1, null)), settlement.items());
|
||||||
|
assertEquals(1, service.state().notifications().size());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Quest quest(QuestService service, UUID issuer) throws IOException {
|
||||||
|
return service.create(
|
||||||
|
issuer, "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 2, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void save(QuestState candidate) throws IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,133 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
import static org.mockito.ArgumentMatchers.contains;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestClaimControllerTest {
|
||||||
|
@Test
|
||||||
|
void collectsEveryClaimAndClearlyDistinguishesItemsAndOverflow() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = serviceWithAllClaimSources(repository);
|
||||||
|
UUID issuer = service.state().claims().keySet().iterator().next();
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(player.getUniqueId()).thenReturn(issuer);
|
||||||
|
RecordingInventory inventory = new RecordingInventory(2);
|
||||||
|
|
||||||
|
ClaimCollectionResult result = new QuestClaimController(service, inventory).collect(player);
|
||||||
|
|
||||||
|
assertEquals(new ClaimCollectionResult(3, 6), result);
|
||||||
|
assertTrue(service.claimsFor(issuer).isEmpty());
|
||||||
|
verify(player).sendMessage(contains("delivered blocks from completed quest"));
|
||||||
|
verify(player).sendMessage(contains("returned reward from cancelled quest"));
|
||||||
|
verify(player).sendMessage(contains("returned reward from expired quest"));
|
||||||
|
verify(player).sendMessage(contains("dropped at your feet, protected for you"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void deliveryFailureLeavesClaimPendingForRetry() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = expiredService(repository);
|
||||||
|
UUID issuer = service.state().claims().keySet().iterator().next();
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(player.getUniqueId()).thenReturn(issuer);
|
||||||
|
QuestClaimInventory inventory = items -> ignored -> {
|
||||||
|
throw new IllegalStateException("world rejected drop");
|
||||||
|
};
|
||||||
|
|
||||||
|
assertThrows(
|
||||||
|
IllegalStateException.class,
|
||||||
|
() -> new QuestClaimController(service, inventory).collect(player)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(1, service.claimsFor(issuer).size());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void acknowledgementFailureRollsBackDeliveryAndLeavesClaimPending() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = expiredService(repository);
|
||||||
|
UUID issuer = service.state().claims().keySet().iterator().next();
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
when(player.getUniqueId()).thenReturn(issuer);
|
||||||
|
RecordingInventory inventory = new RecordingInventory(0);
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
assertThrows(
|
||||||
|
IOException.class,
|
||||||
|
() -> new QuestClaimController(service, inventory).collect(player)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(1, inventory.rollbacks);
|
||||||
|
assertEquals(1, service.claimsFor(issuer).size());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static QuestService serviceWithAllClaimSources(Repository repository) throws Exception {
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest completed = create(service, issuer, "STONE");
|
||||||
|
Quest cancelled = create(service, issuer, "DIRT");
|
||||||
|
Quest expired = create(service, issuer, "SAND");
|
||||||
|
service.complete(
|
||||||
|
completed.id(), new EscrowItem("STONE", 1, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
service.cancel(cancelled.id(), issuer, Instant.EPOCH.plusSeconds(1));
|
||||||
|
service.expire(expired.expiresAt());
|
||||||
|
return service;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static QuestService expiredService(Repository repository) throws Exception {
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = create(service, UUID.randomUUID(), "STONE");
|
||||||
|
service.expire(quest.expiresAt());
|
||||||
|
return service;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Quest create(QuestService service, UUID issuer, String material)
|
||||||
|
throws IOException {
|
||||||
|
return service.create(
|
||||||
|
issuer, "Issuer", material, 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class RecordingInventory implements QuestClaimInventory {
|
||||||
|
private final int overflow;
|
||||||
|
private int rollbacks;
|
||||||
|
|
||||||
|
private RecordingInventory(int overflow) {
|
||||||
|
this.overflow = overflow;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public PreparedClaim prepare(List<EscrowItem> items) {
|
||||||
|
return player -> new Delivery() {
|
||||||
|
@Override public int overflowAmount() { return overflow; }
|
||||||
|
@Override public void rollback() { rollbacks++; }
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override public void save(QuestState candidate) throws IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -6,6 +6,7 @@ import static org.mockito.ArgumentMatchers.contains;
|
|||||||
import static org.mockito.Mockito.mock;
|
import static org.mockito.Mockito.mock;
|
||||||
import static org.mockito.Mockito.times;
|
import static org.mockito.Mockito.times;
|
||||||
import static org.mockito.Mockito.verify;
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.verifyNoInteractions;
|
||||||
import static org.mockito.Mockito.when;
|
import static org.mockito.Mockito.when;
|
||||||
|
|
||||||
import java.time.Clock;
|
import java.time.Clock;
|
||||||
@@ -20,6 +21,47 @@ import org.junit.jupiter.api.Test;
|
|||||||
final class QuestCommandTest {
|
final class QuestCommandTest {
|
||||||
private static final Instant NOW = Instant.parse("2026-09-05T03:00:00Z");
|
private static final Instant NOW = Instant.parse("2026-09-05T03:00:00Z");
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void disabledSettingGatesEveryPlayerCommandFormAndAutocomplete() throws Exception {
|
||||||
|
QuestCreationGateway creator = mock(QuestCreationGateway.class);
|
||||||
|
QuestBrowser browser = mock(QuestBrowser.class);
|
||||||
|
QuestCompletionGateway completer = mock(QuestCompletionGateway.class);
|
||||||
|
QuestCancellationGateway canceller = mock(QuestCancellationGateway.class);
|
||||||
|
QuestClaimGateway claimant = mock(QuestClaimGateway.class);
|
||||||
|
PlayerCommandSettings settings = new PlayerCommandSettings(
|
||||||
|
new PlayerCommandSettingsRepository() {
|
||||||
|
@Override public boolean loadEnabled() { return false; }
|
||||||
|
@Override public void saveEnabled(boolean enabled) { }
|
||||||
|
}
|
||||||
|
);
|
||||||
|
QuestCommand executor = new QuestCommand(
|
||||||
|
creator, browser, completer, canceller, claimant,
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC), settings
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
Command command = mock(Command.class);
|
||||||
|
List<String[]> forms = List.of(
|
||||||
|
new String[] {},
|
||||||
|
new String[] {"list"},
|
||||||
|
new String[] {"create", "stone", "1"},
|
||||||
|
new String[] {"complete", "quest-id"},
|
||||||
|
new String[] {"cancel", "quest-id"},
|
||||||
|
new String[] {"claim"}
|
||||||
|
);
|
||||||
|
|
||||||
|
for (String[] form : forms) {
|
||||||
|
assertTrue(executor.onCommand(player, command, "quests", form));
|
||||||
|
}
|
||||||
|
|
||||||
|
verify(player, times(forms.size())).sendMessage(
|
||||||
|
"Player quest commands are disabled. Use a physical quest board instead."
|
||||||
|
);
|
||||||
|
assertTrue(executor.onTabComplete(
|
||||||
|
player, command, "quests", new String[] {""}
|
||||||
|
).isEmpty());
|
||||||
|
verifyNoInteractions(creator, browser, completer, canceller, claimant);
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void routesValidatedCreateArgumentsWithCurrentUtcTime() {
|
void routesValidatedCreateArgumentsWithCurrentUtcTime() {
|
||||||
RecordingCreator creator = new RecordingCreator();
|
RecordingCreator creator = new RecordingCreator();
|
||||||
@@ -86,6 +128,66 @@ final class QuestCommandTest {
|
|||||||
verify(player).sendMessage("Quest quantity must be a positive whole number.");
|
verify(player).sendMessage("Quest quantity must be a positive whole number.");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void completeCommandRoutesPlayerAndCurrentTimeToEquivalentGateway() {
|
||||||
|
RecordingCreator creator = new RecordingCreator();
|
||||||
|
RecordingCompleter completer = new RecordingCompleter();
|
||||||
|
QuestCommand executor = new QuestCommand(
|
||||||
|
creator, now -> List.of(), completer, Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
String id = UUID.randomUUID().toString();
|
||||||
|
|
||||||
|
assertTrue(executor.onCommand(
|
||||||
|
player, mock(Command.class), "quests", new String[] {"complete", id}
|
||||||
|
));
|
||||||
|
|
||||||
|
assertEquals(player, completer.player);
|
||||||
|
assertEquals(id, completer.questId);
|
||||||
|
assertEquals(NOW, completer.completedAt);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void claimCommandUsesTheSameCollectionGateway() {
|
||||||
|
RecordingCreator creator = new RecordingCreator();
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
java.util.concurrent.atomic.AtomicReference<Player> claimantPlayer =
|
||||||
|
new java.util.concurrent.atomic.AtomicReference<>();
|
||||||
|
QuestClaimGateway claimant = claimingPlayer -> {
|
||||||
|
claimantPlayer.set(claimingPlayer);
|
||||||
|
return new ClaimCollectionResult(1, 0);
|
||||||
|
};
|
||||||
|
QuestCommand executor = new QuestCommand(
|
||||||
|
creator, now -> List.of(), null, null, claimant,
|
||||||
|
Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertTrue(executor.onCommand(
|
||||||
|
player, mock(Command.class), "quests", new String[] {"claim"}
|
||||||
|
));
|
||||||
|
|
||||||
|
assertEquals(player, claimantPlayer.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void cancelCommandRoutesPlayerAndCurrentTimeToEquivalentGateway() {
|
||||||
|
RecordingCreator creator = new RecordingCreator();
|
||||||
|
RecordingCanceller canceller = new RecordingCanceller();
|
||||||
|
QuestCommand executor = new QuestCommand(
|
||||||
|
creator, now -> List.of(), null, canceller, Clock.fixed(NOW, ZoneOffset.UTC)
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
String id = UUID.randomUUID().toString();
|
||||||
|
|
||||||
|
assertTrue(executor.onCommand(
|
||||||
|
player, mock(Command.class), "quests", new String[] {"cancel", id}
|
||||||
|
));
|
||||||
|
|
||||||
|
assertEquals(player, canceller.player);
|
||||||
|
assertEquals(id, canceller.questId);
|
||||||
|
assertEquals(NOW, canceller.cancelledAt);
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void questIdentifierAutocompleteOnlyUsesActiveAndOwnedQuests() {
|
void questIdentifierAutocompleteOnlyUsesActiveAndOwnedQuests() {
|
||||||
RecordingCreator creator = new RecordingCreator();
|
RecordingCreator creator = new RecordingCreator();
|
||||||
@@ -120,6 +222,10 @@ final class QuestCommandTest {
|
|||||||
executor.onTabComplete(player, command, "quests", new String[] {"cr"}));
|
executor.onTabComplete(player, command, "quests", new String[] {"cr"}));
|
||||||
assertEquals(List.of("list"),
|
assertEquals(List.of("list"),
|
||||||
executor.onTabComplete(player, command, "quests", new String[] {"li"}));
|
executor.onTabComplete(player, command, "quests", new String[] {"li"}));
|
||||||
|
assertEquals(List.of("cancel"),
|
||||||
|
executor.onTabComplete(player, command, "quests", new String[] {"ca"}));
|
||||||
|
assertEquals(List.of("claim"),
|
||||||
|
executor.onTabComplete(player, command, "quests", new String[] {"cl"}));
|
||||||
assertEquals(List.of("STONE", "STONE_BRICKS"), executor.onTabComplete(
|
assertEquals(List.of("STONE", "STONE_BRICKS"), executor.onTabComplete(
|
||||||
player, command, "quests", new String[] {"create", "sto"}
|
player, command, "quests", new String[] {"create", "sto"}
|
||||||
));
|
));
|
||||||
@@ -140,6 +246,34 @@ final class QuestCommandTest {
|
|||||||
return new QuestCommand(creator, browser, Clock.fixed(NOW, ZoneOffset.UTC));
|
return new QuestCommand(creator, browser, Clock.fixed(NOW, ZoneOffset.UTC));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private static final class RecordingCanceller implements QuestCancellationGateway {
|
||||||
|
private Player player;
|
||||||
|
private String questId;
|
||||||
|
private Instant cancelledAt;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestClaim cancel(Player cancellingPlayer, String id, Instant instant) {
|
||||||
|
player = cancellingPlayer;
|
||||||
|
questId = id;
|
||||||
|
cancelledAt = instant;
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class RecordingCompleter implements QuestCompletionGateway {
|
||||||
|
private Player player;
|
||||||
|
private String questId;
|
||||||
|
private Instant completedAt;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public QuestCompletion complete(Player completingPlayer, String id, Instant instant) {
|
||||||
|
player = completingPlayer;
|
||||||
|
questId = id;
|
||||||
|
completedAt = instant;
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private static final class RecordingCreator implements QuestCreationGateway {
|
private static final class RecordingCreator implements QuestCreationGateway {
|
||||||
private Player player;
|
private Player player;
|
||||||
private String material;
|
private String material;
|
||||||
|
|||||||
@@ -0,0 +1,118 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.concurrent.CountDownLatch;
|
||||||
|
import java.util.concurrent.ExecutorService;
|
||||||
|
import java.util.concurrent.Executors;
|
||||||
|
import java.util.concurrent.Future;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestCompletionAtomicityTest {
|
||||||
|
@Test
|
||||||
|
void persistenceFailureChangesNoDurableOrInMemoryState() throws Exception {
|
||||||
|
FailingRepository repository = new FailingRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = service.create(
|
||||||
|
UUID.randomUUID(), "Issuer", "STONE", 2,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
QuestState before = service.state();
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
assertThrows(IOException.class, () -> service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 2, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
));
|
||||||
|
|
||||||
|
assertEquals(before, service.state());
|
||||||
|
assertEquals(before, repository.state);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void rejectsWrongMaterialQuantityExpiredAndAlreadyCompleted() throws Exception {
|
||||||
|
FailingRepository repository = new FailingRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = service.create(
|
||||||
|
UUID.randomUUID(), "Issuer", "STONE", 2,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
|
||||||
|
assertThrows(IllegalArgumentException.class, () -> service.complete(
|
||||||
|
quest.id(), new EscrowItem("DIRT", 2, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
));
|
||||||
|
assertThrows(IllegalArgumentException.class, () -> service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 1, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
));
|
||||||
|
assertThrows(IllegalStateException.class, () -> service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 2, null), quest.expiresAt()
|
||||||
|
));
|
||||||
|
service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 2, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
assertThrows(IllegalStateException.class, () -> service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 2, null), Instant.EPOCH.plusSeconds(2)
|
||||||
|
));
|
||||||
|
assertTrue(service.activeQuests(Instant.EPOCH.plusSeconds(2)).isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void simultaneousAttemptsSettleExactlyOnce() throws Exception {
|
||||||
|
FailingRepository repository = new FailingRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = service.create(
|
||||||
|
issuer, "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
CountDownLatch start = new CountDownLatch(1);
|
||||||
|
try (ExecutorService executor = Executors.newFixedThreadPool(2)) {
|
||||||
|
List<Future<Boolean>> attempts = new ArrayList<>();
|
||||||
|
for (int index = 0; index < 2; index++) {
|
||||||
|
attempts.add(executor.submit(() -> {
|
||||||
|
start.await();
|
||||||
|
try {
|
||||||
|
service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 1, null),
|
||||||
|
Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
return true;
|
||||||
|
} catch (IllegalStateException exception) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
start.countDown();
|
||||||
|
assertEquals(1, attempts.stream().filter(attempt -> {
|
||||||
|
try {
|
||||||
|
return attempt.get();
|
||||||
|
} catch (Exception exception) {
|
||||||
|
throw new AssertionError(exception);
|
||||||
|
}
|
||||||
|
}).count());
|
||||||
|
}
|
||||||
|
assertEquals(1, service.state().claims().get(issuer).size());
|
||||||
|
assertEquals(1, service.state().notifications().size());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class FailingRepository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void save(QuestState candidate) throws IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,142 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
import static org.mockito.ArgumentMatchers.contains;
|
||||||
|
import static org.mockito.Mockito.mock;
|
||||||
|
import static org.mockito.Mockito.never;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.bukkit.entity.Player;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestCompletionControllerTest {
|
||||||
|
@Test
|
||||||
|
void removesExactDeliverySettlesRewardReportsOverflowAndNotifies() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = quest(service, issuer);
|
||||||
|
Inventory inventory = new Inventory();
|
||||||
|
inventory.overflow = 2;
|
||||||
|
RecordingNotifier notifier = new RecordingNotifier();
|
||||||
|
QuestCompletionController controller = new QuestCompletionController(
|
||||||
|
service, inventory, notifier
|
||||||
|
);
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
|
||||||
|
controller.complete(player, quest.id().toString(), Instant.EPOCH.plusSeconds(1));
|
||||||
|
|
||||||
|
assertEquals("STONE", inventory.material);
|
||||||
|
assertEquals(3, inventory.amount);
|
||||||
|
assertTrue(inventory.granted);
|
||||||
|
assertFalse(inventory.rolledBack);
|
||||||
|
assertEquals(issuer, notifier.issuer);
|
||||||
|
assertEquals(
|
||||||
|
List.of(new EscrowItem("STONE", 3, null)),
|
||||||
|
service.state().claims().get(issuer).getFirst().items()
|
||||||
|
);
|
||||||
|
verify(player).sendMessage(contains("exact escrowed reward"));
|
||||||
|
verify(player).sendMessage(contains("dropped safely at your feet"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void inventoryValidationFailureConsumesAndReleasesNothing() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = quest(service, UUID.randomUUID());
|
||||||
|
Inventory inventory = new Inventory();
|
||||||
|
inventory.insufficient = true;
|
||||||
|
Player player = mock(Player.class);
|
||||||
|
|
||||||
|
assertThrows(IllegalArgumentException.class, () -> new QuestCompletionController(
|
||||||
|
service, inventory, ignored -> { }
|
||||||
|
).complete(player, quest.id().toString(), Instant.EPOCH.plusSeconds(1)));
|
||||||
|
|
||||||
|
assertFalse(inventory.granted);
|
||||||
|
assertEquals(QuestStatus.ACTIVE, service.state().quests().get(quest.id()).status());
|
||||||
|
assertTrue(service.state().claims().isEmpty());
|
||||||
|
verify(player, never()).sendMessage(contains("completed"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void persistenceFailureRollsBackDeliveryAndDoesNotGrantReward() throws Exception {
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = quest(service, UUID.randomUUID());
|
||||||
|
Inventory inventory = new Inventory();
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
assertThrows(IOException.class, () -> new QuestCompletionController(
|
||||||
|
service, inventory, ignored -> { }
|
||||||
|
).complete(mock(Player.class), quest.id().toString(), Instant.EPOCH.plusSeconds(1)));
|
||||||
|
|
||||||
|
assertTrue(inventory.rolledBack);
|
||||||
|
assertFalse(inventory.granted);
|
||||||
|
assertEquals(QuestStatus.ACTIVE, service.state().quests().get(quest.id()).status());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Quest quest(QuestService service, UUID issuer) throws IOException {
|
||||||
|
return service.create(
|
||||||
|
issuer, "Issuer", "STONE", 3,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 2, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Inventory implements QuestCompletionInventory {
|
||||||
|
private String material;
|
||||||
|
private int amount;
|
||||||
|
private boolean insufficient;
|
||||||
|
private boolean rolledBack;
|
||||||
|
private boolean granted;
|
||||||
|
private int overflow;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public RemovedDelivery remove(Player player, String requestedMaterial, int requestedAmount) {
|
||||||
|
material = requestedMaterial;
|
||||||
|
amount = requestedAmount;
|
||||||
|
if (insufficient) {
|
||||||
|
throw new IllegalArgumentException("not enough blocks");
|
||||||
|
}
|
||||||
|
return new RemovedDelivery() {
|
||||||
|
@Override
|
||||||
|
public List<EscrowItem> items() {
|
||||||
|
return List.of(new EscrowItem(requestedMaterial, requestedAmount, null));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override public void rollback() { rolledBack = true; }
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public PreparedReward prepare(List<EscrowItem> reward) {
|
||||||
|
return player -> {
|
||||||
|
granted = true;
|
||||||
|
return overflow;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class RecordingNotifier implements IssuerNotifier {
|
||||||
|
private UUID issuer;
|
||||||
|
@Override public void notifyIfOnline(UUID issuerId) { issuer = issuerId; }
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override public void save(QuestState candidate) throws IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestCompletionServiceTest {
|
||||||
|
@Test
|
||||||
|
void completesOnceAndHoldsDeliveredBlocksForIssuer() throws Exception {
|
||||||
|
MemoryQuestRepository repository = new MemoryQuestRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest quest = service.create(
|
||||||
|
issuer, "Issuer", "STONE", 64,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 3, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
|
||||||
|
QuestCompletion completion = service.complete(
|
||||||
|
quest.id(), new EscrowItem("STONE", 64, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals(QuestStatus.COMPLETED, service.state().quests().get(quest.id()).status());
|
||||||
|
assertEquals(quest.reward(), completion.reward());
|
||||||
|
assertTrue(service.state().claims().get(issuer).stream()
|
||||||
|
.anyMatch(claim -> claim.items().equals(List.of(new EscrowItem("STONE", 64, null)))));
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class MemoryQuestRepository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override public void save(QuestState state) { this.state = state; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,127 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestExpiryAndClaimServiceTest {
|
||||||
|
@Test
|
||||||
|
void expiryReturnsExactRewardAsTypedClaimAndAcknowledgementRemovesIt() throws Exception {
|
||||||
|
MemoryQuestRepository repository = new MemoryQuestRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
EscrowItem reward = new EscrowItem("DIAMOND", 3, "exact-data");
|
||||||
|
Quest quest = service.create(
|
||||||
|
issuer, "Issuer", "STONE", 64, List.of(reward), Instant.EPOCH
|
||||||
|
);
|
||||||
|
|
||||||
|
service.expire(quest.expiresAt());
|
||||||
|
List<QuestClaim> claims = service.claimsFor(issuer);
|
||||||
|
|
||||||
|
assertEquals(QuestStatus.EXPIRED, service.state().quests().get(quest.id()).status());
|
||||||
|
assertEquals(List.of(reward), claims.getFirst().items());
|
||||||
|
assertEquals(QuestClaimSource.EXPIRATION, claims.getFirst().source());
|
||||||
|
assertEquals(QuestClaimType.RETURNED_REWARD, claims.getFirst().type());
|
||||||
|
service.acknowledgeClaim(issuer, claims.getFirst().id());
|
||||||
|
assertTrue(service.claimsFor(issuer).isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void sevenDayBoundaryIsExclusiveBeforeAndDueExactlyAtExpiration() throws Exception {
|
||||||
|
QuestService service = new QuestService(new MemoryQuestRepository());
|
||||||
|
Quest quest = create(service, UUID.randomUUID());
|
||||||
|
|
||||||
|
assertTrue(service.expire(quest.expiresAt().minusNanos(1)).isEmpty());
|
||||||
|
assertEquals(QuestStatus.ACTIVE, service.state().quests().get(quest.id()).status());
|
||||||
|
|
||||||
|
assertEquals(1, service.expire(quest.expiresAt()).size());
|
||||||
|
assertEquals(QuestStatus.EXPIRED, service.state().quests().get(quest.id()).status());
|
||||||
|
assertTrue(service.expire(quest.expiresAt().plusSeconds(1)).isEmpty());
|
||||||
|
assertEquals(1, service.claimsFor(quest.issuerId()).size());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void completionCancellationAndExpirationClaimsKeepTheirDistinctSources() throws Exception {
|
||||||
|
QuestService service = new QuestService(new MemoryQuestRepository());
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
Quest completed = create(service, issuer);
|
||||||
|
Quest cancelled = service.create(
|
||||||
|
issuer, "Issuer", "DIRT", 1,
|
||||||
|
List.of(new EscrowItem("EMERALD", 2, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
Quest expired = service.create(
|
||||||
|
issuer, "Issuer", "SAND", 1,
|
||||||
|
List.of(new EscrowItem("GOLD_INGOT", 4, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
|
||||||
|
service.complete(
|
||||||
|
completed.id(), new EscrowItem("STONE", 1, null), Instant.EPOCH.plusSeconds(1)
|
||||||
|
);
|
||||||
|
service.cancel(cancelled.id(), issuer, Instant.EPOCH.plusSeconds(1));
|
||||||
|
service.expire(expired.expiresAt());
|
||||||
|
|
||||||
|
assertEquals(
|
||||||
|
List.of(
|
||||||
|
QuestClaimSource.COMPLETION,
|
||||||
|
QuestClaimSource.CANCELLATION,
|
||||||
|
QuestClaimSource.EXPIRATION
|
||||||
|
),
|
||||||
|
service.claimsFor(issuer).stream().map(QuestClaim::source).toList()
|
||||||
|
);
|
||||||
|
assertEquals(
|
||||||
|
List.of(
|
||||||
|
QuestClaimType.DELIVERED_BLOCKS,
|
||||||
|
QuestClaimType.RETURNED_REWARD,
|
||||||
|
QuestClaimType.RETURNED_REWARD
|
||||||
|
),
|
||||||
|
service.claimsFor(issuer).stream().map(QuestClaim::type).toList()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void failedExpirationPersistsNothingAndCanBeRetriedWithoutDuplication() throws Exception {
|
||||||
|
MemoryQuestRepository repository = new MemoryQuestRepository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
Quest quest = create(service, UUID.randomUUID());
|
||||||
|
repository.fail = true;
|
||||||
|
|
||||||
|
assertThrows(IOException.class, () -> service.expire(quest.expiresAt()));
|
||||||
|
assertEquals(QuestStatus.ACTIVE, service.state().quests().get(quest.id()).status());
|
||||||
|
assertTrue(service.claimsFor(quest.issuerId()).isEmpty());
|
||||||
|
assertTrue(service.pendingNotifications(quest.issuerId()).isEmpty());
|
||||||
|
|
||||||
|
repository.fail = false;
|
||||||
|
service.expire(quest.expiresAt());
|
||||||
|
service.expire(quest.expiresAt());
|
||||||
|
assertEquals(1, service.claimsFor(quest.issuerId()).size());
|
||||||
|
assertEquals(1, service.pendingNotifications(quest.issuerId()).size());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Quest create(QuestService service, UUID issuer) throws IOException {
|
||||||
|
return service.create(
|
||||||
|
issuer, "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 3, null)), Instant.EPOCH
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class MemoryQuestRepository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
private boolean fail;
|
||||||
|
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void save(QuestState candidate) throws IOException {
|
||||||
|
if (fail) {
|
||||||
|
throw new IOException("disk full");
|
||||||
|
}
|
||||||
|
state = candidate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
package games.dmg.spigotquestboard;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
|
||||||
|
import java.time.Clock;
|
||||||
|
import java.time.Instant;
|
||||||
|
import java.time.ZoneOffset;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.UUID;
|
||||||
|
import java.util.concurrent.atomic.AtomicReference;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
final class QuestExpiryTaskTest {
|
||||||
|
@Test
|
||||||
|
void scheduledPassExpiresDueQuestAndRequestsImmediateOnlineNotification() throws Exception {
|
||||||
|
Instant boundary = Instant.parse("2026-09-12T03:00:00Z");
|
||||||
|
Repository repository = new Repository();
|
||||||
|
QuestService service = new QuestService(repository);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
service.create(
|
||||||
|
issuer, "Issuer", "STONE", 1,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)),
|
||||||
|
boundary.minusSeconds(604800)
|
||||||
|
);
|
||||||
|
AtomicReference<UUID> notified = new AtomicReference<>();
|
||||||
|
QuestExpiryTask task = new QuestExpiryTask(
|
||||||
|
service, notified::set, Clock.fixed(boundary, ZoneOffset.UTC),
|
||||||
|
Logger.getAnonymousLogger()
|
||||||
|
);
|
||||||
|
|
||||||
|
task.run();
|
||||||
|
|
||||||
|
assertEquals(issuer, notified.get());
|
||||||
|
assertEquals(1, service.pendingNotifications(issuer).size());
|
||||||
|
assertEquals(QuestStatus.EXPIRED, service.state().quests().values().iterator().next().status());
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final class Repository implements QuestRepository {
|
||||||
|
private QuestState state = QuestState.empty();
|
||||||
|
@Override public QuestState load() { return state; }
|
||||||
|
@Override public void save(QuestState candidate) { state = candidate; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -93,6 +93,74 @@ final class YamlQuestRepositoryTest {
|
|||||||
assertTrue(Files.readString(path).contains("status: COMPLETED"));
|
assertTrue(Files.readString(path).contains("status: COMPLETED"));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void roundTripsClaimsAndPendingNotificationsWhileOldFilesDefaultThemEmpty() throws Exception {
|
||||||
|
Path path = temporaryDirectory.resolve("quests.yml");
|
||||||
|
YamlQuestRepository repository = new YamlQuestRepository(path);
|
||||||
|
UUID issuer = UUID.randomUUID();
|
||||||
|
UUID questId = UUID.randomUUID();
|
||||||
|
Quest quest = new Quest(
|
||||||
|
questId, issuer, "Issuer", "STONE", 2,
|
||||||
|
List.of(new EscrowItem("DIAMOND", 1, null)),
|
||||||
|
Instant.parse("2026-09-05T03:00:00Z"),
|
||||||
|
Instant.parse("2026-09-12T03:00:00Z"), QuestStatus.COMPLETED
|
||||||
|
);
|
||||||
|
QuestClaim claim = new QuestClaim(
|
||||||
|
UUID.randomUUID(), questId, issuer,
|
||||||
|
List.of(new EscrowItem("STONE", 2, null)),
|
||||||
|
Instant.parse("2026-09-05T03:01:00Z")
|
||||||
|
);
|
||||||
|
IssuerNotification notification = new IssuerNotification(
|
||||||
|
UUID.randomUUID(), questId, issuer, "Your delivery can be claimed.",
|
||||||
|
Instant.parse("2026-09-05T03:01:00Z")
|
||||||
|
);
|
||||||
|
QuestState expected = new QuestState(
|
||||||
|
Map.of(questId, quest), Map.of(issuer, List.of(claim)),
|
||||||
|
Map.of(notification.id(), notification)
|
||||||
|
);
|
||||||
|
|
||||||
|
repository.save(expected);
|
||||||
|
|
||||||
|
assertEquals(expected, repository.load());
|
||||||
|
String yaml = Files.readString(path);
|
||||||
|
assertTrue(yaml.contains("claims:"));
|
||||||
|
assertTrue(yaml.contains("source: COMPLETION"));
|
||||||
|
assertTrue(yaml.contains("notifications:"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void sourceLessHistoricalClaimsInferTypeFromQuestLifecycle() throws Exception {
|
||||||
|
Path path = temporaryDirectory.resolve("quests.yml");
|
||||||
|
Files.writeString(path, """
|
||||||
|
quests:
|
||||||
|
- id: 00000000-0000-0000-0000-000000000010
|
||||||
|
issuer-id: 00000000-0000-0000-0000-000000000001
|
||||||
|
issuer-name: Issuer
|
||||||
|
requested-material: STONE
|
||||||
|
requested-amount: 1
|
||||||
|
created-at: '2026-09-05T03:00:00Z'
|
||||||
|
expires-at: '2026-09-12T03:00:00Z'
|
||||||
|
status: CANCELLED
|
||||||
|
reward:
|
||||||
|
- material: DIAMOND
|
||||||
|
amount: 1
|
||||||
|
claims:
|
||||||
|
- id: 00000000-0000-0000-0000-000000000020
|
||||||
|
quest-id: 00000000-0000-0000-0000-000000000010
|
||||||
|
owner-id: 00000000-0000-0000-0000-000000000001
|
||||||
|
created-at: '2026-09-05T04:00:00Z'
|
||||||
|
items:
|
||||||
|
- material: DIAMOND
|
||||||
|
amount: 1
|
||||||
|
""");
|
||||||
|
|
||||||
|
QuestClaim claim = new YamlQuestRepository(path).load().claims().values()
|
||||||
|
.iterator().next().getFirst();
|
||||||
|
|
||||||
|
assertEquals(QuestClaimSource.CANCELLATION, claim.source());
|
||||||
|
assertEquals(QuestClaimType.RETURNED_REWARD, claim.type());
|
||||||
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void malformedStateIsRejectedRatherThanPartiallyLoaded() throws Exception {
|
void malformedStateIsRejectedRatherThanPartiallyLoaded() throws Exception {
|
||||||
Path path = temporaryDirectory.resolve("quests.yml");
|
Path path = temporaryDirectory.resolve("quests.yml");
|
||||||
|
|||||||
Reference in New Issue
Block a user