Commerce: Economy & Public Services

Commerce 1.6.17 Update Notes
Compared with Commerce 1.6.6

For Minecraft 1.20.1, Forge 47.3.1–47.x and Java 17. Built and tested with Forge 47.4.10. The server and every client must use Commerce 1.6.17.

1. Accounts and login

Login now uses a one-time challenge instead of sending the password in the mod's login packet. Existing 1.6.6 accounts remain usable; their older credentials are upgraded after a successful login.

Players still register and log in through Commerce's original in-game flow. The Shenxiang World Account main-menu entry and cloud registration screen that were mistakenly included in 1.6.16 have been removed. Cloud password recovery is not part of this release. The optional, signed server-side Bridge remains available for server owners who have set up their own account integration; it does not make the removed player-facing cloud screen available.

2. Item restrictions and qualification certificates

Each restriction block now has its own optional setting for deleting restricted drops with a player tag; it is off by default. The same item cannot be registered in two different restriction blocks, but one block can apply several restrictions to that item.

Administrators can issue qualification certificates to a specific player for a set number of real days or permanently. A certificate can exempt its holder from selected item restrictions; the exemption ends when the certificate expires or is revoked. Certificates can be displayed on a glowing wall mount, which only the holder or an administrator may remove. The exemption picker now has a search field.

3. Free building materials and vending machines

Administrators can search the free building-material library by item name or registry ID. Players can search the published materials from their phones. Both player and administrator vending machines have updated models. The player vending machine recipe now uses five chests.

4. Private land and A/B regions

Each player can own one private territory. A second claim is rejected before payment is taken.

Administrators can pair A and B anchors to manage a region. Newly paired regions can be up to 300 by 300 blocks horizontally and cover the dimension's full build height. They can be named, saved, reset on a schedule or deleted. Snapshots are saved in compressed sections under the world's data/commerce_region_snapshots directory. Deleting a saved snapshot stops its reset timer. Existing regions keep their original height and snapshots; pair a new region to use the expanded size.

Administrators can disable block drops inside a region, including contents of vanilla containers. Players inside see a countdown before a scheduled reset and are moved out before the area is restored. A server-wide warning five minutes before reset is optional and off by default. When using the administrator tablet in a region, right-clicking a device opens that device's own controls first; right-clicking ordinary ground opens the region controls.

Death remains are placed outside protected land where possible. If relocation fails, the original drops are not deleted. Protected bedrock-brush blocks are also guarded against direct breaking and replacement.

5. Item dispenser and money records

The item dispenser can allow each player ID one claim only, or use a cooldown set in real hours. The old daily setting is read as 24 hours. Random dispensing can vary either the number of individual items or the number of complete inventory slots given.

The accounting screen now shows cash stored in ATMs separately. ATM reserves count toward the server's total money supply, but not player-held circulation or the inflation-risk calculation. Moving creative-mode banknotes into an ATM no longer counts as currency destruction. The current risk score responds when the relevant money measure stops rising; past daily records are left intact. Older historical figures that mixed ATM cash with other amounts are not guessed apart.

6. Compatibility and testing

The network protocol has changed from 143 in 1.6.6 to 150 in 1.6.17. Do not mix Commerce versions between the server and clients. The 1.6.17 build passed 382 Forge server-side GameTests, a full Gradle build, checks for all 11 language files and the original item and block IDs. These tests include ordinary in-game registration and rejection of a reused login challenge.

The graphical client, real multiplayer play, upgrades of existing worlds, and maximum-size A/B regions with third-party mod blocks still need hands-on testing in a separate server copy. Before upgrading, back up the entire world, mods, configuration and whitelist; include data/commerce_region_snapshots and any connected account-service data. Test the exact client and server pack on a copy before replacing your live world.

商业 Commerce 1.6.17 更新日志
对比版本：1.6.6 → 1.6.17

适用环境：Minecraft 1.20.1、Forge 47.3.1 至 47.x、Java 17。已使用 Forge 47.4.10 构建和测试。服务端与所有客户端都需要使用 Commerce 1.6.17。

1. 账号与登录

登录改为一次性挑战验证，模组登录数据包不再直接发送密码。1.6.6 的旧账号仍可使用，玩家成功登录后，旧凭据会升级为新格式。

玩家仍通过 Commerce 原有的游戏内流程注册和登录。1.6.16 误加入的主菜单“深巷世界账号”入口及云端注册页面已撤回；本版也没有云端密码找回。供服主自行对接账号系统使用的服务端签名 Bridge 保留，但这不代表玩家端云端注册页面仍然存在。

2. 物品限制与资格证

每台合成使用限制器新增独立的“玩家标签掉落同样删除”开关，默认关闭。同一种物品不能重复放入不同限制器，但可以在同一台设备上设置多种限制。

管理员可以给指定玩家发放限期或永久资格证，豁免选定的物品限制。证书到期或被吊销后，豁免立即失效。资格证也可以挂在墙上发光展示，只有持有人或管理员能拆下。选择豁免项目时支持搜索。

3. 免费建材库与贩卖机

管理员可按物品名称或注册 ID 搜索免费建材库；玩家也能从手机搜索已公开的建材。玩家贩卖机和管理员贩卖机更新了模型，玩家贩卖机的配方现在需要五个箱子。

4. 私人领地与 A/B 区域

每名玩家最多拥有一块私人领地。再次申请会先提示达到上限，不会扣费。

管理员可用 A、B 区块器配对建立管理区域。新配对区域的水平范围最大为 300×300 格，纵向覆盖所在维度的完整建筑高度。区域可以命名、保存、定时重置或删除。快照以压缩分片存入世界目录下的 data/commerce_region_snapshots；删除已保存的快照后，重置计时也会停止。旧区域保留原来的高度和快照，要使用新范围需重新配对。

管理员可关闭区域内的方块掉落，原版容器里的物品也不会因破坏而散落。定时重置前，区域内玩家会看到倒计时，并在方块恢复前被移出。重置前五分钟全服提醒可自行开启，默认关闭。管理员手持平板在区域内右键设备时，会优先打开设备自己的后台；右键普通地面仍可打开区域后台。

玩家在受保护区域内死亡时，死亡遗物会尽量放到保护范围外；如果转移失败，原掉落物不会被清除。基岩刷保护方块也增加了破坏和替换保护。

5. 物品发放器与货币统计

物品发放器支持每个玩家 ID 只领取一次，也能按现实小时设置领取间隔。旧版“每日领取”按 24 小时读取。随机发放可以选择随机发出多少件物品，或随机发出多少个完整物品栏格。

记账器会单独列出 ATM 内的备钞。这笔钱计入全服货币总量，但不算玩家手里的流通货币，也不参与通胀风险计算。管理员把创造模式钞票放入 ATM，不再被误记为货币销毁。当前统计口径下的货币存量不再上涨时，风险分会及时回落；过去的每日记录不被改写。旧存档中混合记录的历史金额也不会被擅自拆分。

6. 版本与测试

网络协议从 1.6.6 的 143 升至 1.6.17 的 150，服务端和客户端不能混装不同 Commerce 版本。本版通过 382 项 Forge 服务端自动测试、完整 Gradle 构建、11 种语言文件检查和原有物品、方块 ID 检查。测试包含普通玩家游戏内注册，以及已使用的登录挑战无法重复使用。

图形客户端、真实多人、旧世界升级，以及包含第三方 Mod 方块的最大 A/B 区域，仍需在隔离的服务器副本中人工验收。升级前请备份整个世界、mods、配置和白名单；世界目录中的 data/commerce_region_snapshots，以及实际接入的外部账号服务数据，都不要漏掉。先用与你正式服一致的客户端和服务端整合包测试，再替换正式世界。