refactor(wand): clean GSD comments and translate to English
- Reduce javadocs to one-liners, remove REQ/plan/phase references - No behavioural change
This commit is contained in:
@@ -32,7 +32,7 @@ public final class GravityFlipWandInteraction extends SimpleInstantInteraction {
|
|||||||
// Volatile: writer (setup thread) must publish safely to reader threads (interaction dispatch).
|
// Volatile: writer (setup thread) must publish safely to reader threads (interaction dispatch).
|
||||||
private static volatile WandSelectionStore STORE;
|
private static volatile WandSelectionStore STORE;
|
||||||
|
|
||||||
/** Wire the selection store before any click can be processed. */
|
/** Wires the selection store before any click can be processed. */
|
||||||
public static void bindStore(WandSelectionStore store) {
|
public static void bindStore(WandSelectionStore store) {
|
||||||
STORE = store;
|
STORE = store;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -26,7 +26,7 @@ public final class WandSelectionStore {
|
|||||||
|
|
||||||
private final ConcurrentHashMap<UUID, Selection> byUuid = new ConcurrentHashMap<>();
|
private final ConcurrentHashMap<UUID, Selection> byUuid = new ConcurrentHashMap<>();
|
||||||
|
|
||||||
/** Record the Primary-click corner for the given player. */
|
/** Records the Primary-click corner for the given player. */
|
||||||
public void setPos1(UUID uuid, int x, int y, int z) {
|
public void setPos1(UUID uuid, int x, int y, int z) {
|
||||||
if (uuid == null) return;
|
if (uuid == null) return;
|
||||||
byUuid.compute(uuid, (k, prev) -> new Selection(
|
byUuid.compute(uuid, (k, prev) -> new Selection(
|
||||||
@@ -34,7 +34,7 @@ public final class WandSelectionStore {
|
|||||||
prev != null ? prev.pos2 : null));
|
prev != null ? prev.pos2 : null));
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Record the Secondary-click corner for the given player. */
|
/** Records the Secondary-click corner for the given player. */
|
||||||
public void setPos2(UUID uuid, int x, int y, int z) {
|
public void setPos2(UUID uuid, int x, int y, int z) {
|
||||||
if (uuid == null) return;
|
if (uuid == null) return;
|
||||||
byUuid.compute(uuid, (k, prev) -> new Selection(
|
byUuid.compute(uuid, (k, prev) -> new Selection(
|
||||||
@@ -42,14 +42,14 @@ public final class WandSelectionStore {
|
|||||||
new int[]{x, y, z}));
|
new int[]{x, y, z}));
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Return the current selection for the given player (never null). */
|
/** Returns the current selection for the given player (never null). */
|
||||||
public Selection get(UUID uuid) {
|
public Selection get(UUID uuid) {
|
||||||
if (uuid == null) return EMPTY;
|
if (uuid == null) return EMPTY;
|
||||||
Selection s = byUuid.get(uuid);
|
Selection s = byUuid.get(uuid);
|
||||||
return s != null ? s : EMPTY;
|
return s != null ? s : EMPTY;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Forget the selection for the given player. */
|
/** Forgets the selection for the given player. */
|
||||||
public void clear(UUID uuid) {
|
public void clear(UUID uuid) {
|
||||||
if (uuid == null) return;
|
if (uuid == null) return;
|
||||||
byUuid.remove(uuid);
|
byUuid.remove(uuid);
|
||||||
|
|||||||
Reference in New Issue
Block a user