Fabric 1.20.1: server features (commands, LuckPerms, Placeholder API, economy API, client link) and client mod (HUD, editor, shop and market windows); Paper client link; docs and examples

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DjMbLQujBHunCCu5GpsHaT

examples/fabric-client/scopenet-client.json

@@ -1,27 +1,24 @@
 {
-  "_about": "SCOPENET client mod (Fabric 1.20.1) -> config/scopenet-client.json. The in-game config screen edits this file; you rarely need to change it by hand. The mod is in development and this format may grow.",
   "enabled": true,
   "hud": {
     "scale": 1.0,
     "opacity": 0.85,
-    "widgets": {
-      "balance":      { "enabled": true,  "anchor": "top_right",    "x": -8, "y": 8,   "compact": false },
-      "level":        { "enabled": true,  "anchor": "top_left",     "x": 8,  "y": 8,   "showXpBar": true },
-      "guild":        { "enabled": true,  "anchor": "bottom_left",  "x": 8,  "y": -8,  "showClaimOwner": true },
-      "quests":       { "enabled": false, "anchor": "middle_right", "x": -8, "y": 0,   "maxShown": 3 },
-      "claimBorders": { "enabled": true,  "showOnlyWhenSneaking": false }
-    },
     "hideInF3": true,
-    "hideWhileChatOpen": false
+    "hideWhileChatOpen": false,
+    "claimBorders": true,
+    "claimBordersOnlyWhenSneaking": false,
+    "widgets": {
+      "level":   { "enabled": true,  "anchor": "top_left",     "x": 8,  "y": 8,   "compact": false },
+      "balance": { "enabled": true,  "anchor": "top_right",    "x": -8, "y": 8,   "compact": false },
+      "guild":   { "enabled": true,  "anchor": "bottom_left",  "x": 8,  "y": -40, "compact": false },
+      "claim":   { "enabled": true,  "anchor": "top_center",   "x": 0,  "y": 8,   "compact": false },
+      "quests":  { "enabled": false, "anchor": "middle_right", "x": -8, "y": 0,   "compact": false }
+    }
   },
   "notifications": {
     "levelUp": true,
     "achievements": true,
-    "friendRequests": true,
-    "gameInvites": true
-  },
-  "keybinds": {
-    "openMenu": "key.keyboard.k",
-    "toggleHud": "key.keyboard.h"
+    "guild": true,
+    "errors": true
   }
 }

examples/fabric-server/scopenet.properties

@@ -1,6 +1,7 @@
 # SCOPENET for Fabric (server side)  ->  config/scopenet.properties
-# Works with the same panel as the Paper plugin. Keys marked [planned] are read once the Fabric
-# feature-parity work lands; unknown keys are ignored, so it is safe to keep them here.
+# Same panel as the Paper plugin. Sign-in, stats, claims and the Live Map work on every supported Fabric version.
+# Commands, permissions, placeholders and the client link need Fabric API and are in the Fabric 1.20.1 build.
+# Extra files the mod creates: config/scopenet/essentials.json (homes, warps), guild-homes.json, economy-pending.json.
 
 # --- Connection (required) ---------------------------------------------------
 # Your panel address and the token from Servers -> this server in the panel.
@@ -24,29 +25,30 @@ economy.enabled=true
 # (also needs Live Map switched on for this server in the panel).
 livemap.enabled=true
 
-# --- Essentials [planned] ----------------------------------------------------
-# Homes, warps, /back, /tpa and /rtp. Same defaults as Paper.
+# --- Essentials (1.20.1) -----------------------------------------------------
+# /spawn /home /sethome /delhome /back /tpa /tpaccept /tpdeny /rtp /warp /playtime
 essentials.max_homes=5
 essentials.rtp_radius=2500
 essentials.tpa_timeout_seconds=60
 
-# --- Permissions [planned] ---------------------------------------------------
-# Uses the LuckPerms mod when it is installed (nodes are scopenet.command.*, same as Paper).
-# Without it, these defaults apply: "all" lets every player use the command, "op" limits to operators.
-permissions.default_level=all
-permissions.admin_commands=op
-
-# --- Economy mods [planned] --------------------------------------------------
-# auto   : use the first supported economy mod found (Impactor, Common Economy API), else SCOPENET's own balances
-# scopenet: always use SCOPENET balances (other mods can still read them through the SCOPENET API)
-economy.provider=auto
+# --- Economy (1.20.1) --------------------------------------------------------
+# Shown next to amounts.
 economy.currency_symbol=$
 
-# --- Placeholder API [planned] -----------------------------------------------
-# Registers %scopenet:level%, %scopenet:guild%, %scopenet:balance%, %scopenet:playtime%,
-# %scopenet:quest_progress% when Placeholder API (Fabric) is installed.
+# --- Permissions (1.20.1) ----------------------------------------------------
+# With the LuckPerms mod installed, its answer wins. Use the same nodes as the Paper plugin
+# (scopenet.command.home, scopenet.command.guild.bank.withdraw, scopenet.claims.bypass ...).
+# Without LuckPerms, or when LuckPerms has no setting for a node:
+#   all : every player may use ordinary commands
+#   op  : only operators may
+# Admin nodes (/scopenet status and reload, scopenet.claims.bypass) always need operator level 2 by default.
+permissions.default_level=all
+
+# --- Placeholder API (1.20.1) ------------------------------------------------
+# With Placeholder API installed, registers %scopenet:level%, %scopenet:guild%, %scopenet:balance%,
+# %scopenet:playtime%, %scopenet:quest_progress% and the rest of the Paper placeholder list.
 placeholders.enabled=true
 
-# --- Client mod link [planned] -----------------------------------------------
-# Send balance, level and guild info to players who have the SCOPENET client mod.
+# --- Client mod link (1.20.1) ------------------------------------------------
+# Send balance, level, guild and claim info to players who have the SCOPENET client mod.
 clientlink.enabled=true

examples/paper/config.yml

@@ -114,6 +114,15 @@ integrations:
     enabled: true
     report-interval-seconds: 30
 
+# ==============================================================================
+# Client mod link
+# Sends balance, level, guild and claim info to players who have the optional SCOPENET
+# client mod (HUD widgets, claim overlay, shop and market windows). Players without it
+# are unaffected. Display only: everything the client does is an ordinary command.
+# ==============================================================================
+clientlink:
+  enabled: true
+
 # ==============================================================================
 # Permissions (set these in LuckPerms, not here)
 #   scopenet.command.<command>             e.g. scopenet.command.home