SP商店

SP商店

高度可编辑的游戏内商店。

SP Shop

一个使用独立经济系统的可配置商店,支持物品买卖以及十四种可购买能力。

0.9.2 新增 — 可滚动的物品信息

将鼠标滚轮悬停在右侧物品信息面板上,可查看所有购买需求和出售收益。滚动条指示当前位置。物品标题保持固定;支付行在面板内被裁剪。选择其他报价会重置滚动位置。已移除简写的“+ 更多”行。

0.9.1 新增 — 清晰的支付列表

购买会显示一个缩进列表,包含货币和材料图标/数量,随后是出售及其货币收益。已移除重复的“需要”摘要。长列表在“花费”中继续显示。

SPCoins(包括旧版物品)已从材料选择器中排除,并拒绝作为新的材料需求。现有的硬币需求会一次性合并到数字购买价格中,并生成 settings.json.pre-0.9.1.bak 备份。已禁用购买的功能保持禁用。其他材料保持不变。

0.9.0 新增 — 菜单编辑与材料价格

  • 管理员可以从 /shop 打开 编辑菜单,或在分类内打开 编辑 以直接编辑该分类或选中的报价。/shopedit 仍然可用。
  • 主菜单与分类 编辑三个列标题/图标并打开目录。添加/移除/重命名/重新排序分区、分类、组和物品;分类 菜单设置 控制可见性以及非装备分类的列位置。装备保留其护甲 / 武器与工具拆分。
  • 报价的 所需物品 最多接受 16 种不同的已注册物品,每种带每捆数量。可将 SPCoins 与铁、钻石或已安装模组的材料/碎片组合。将购买 SPCoins 设为 0 以实现纯材料交易,出售设为 -1 以禁用回售。
  • 商店在物品旁显示材料花费;花费 列出所有需求。每项需求都会随所选捆数缩放。向商店出售仍只支付配置的 SPCoins 价格。
  • 支付使用 36 个主背包槽位中的普通匹配物品;重命名、附魔或损坏的变体被排除。缺少材料或输出空间不足时,钱包和背包保持不变。
  • 在表单中使用 应用,然后返回编辑器并 全局保存。设置在世界之间共享;钱包和已购买能力保持世界独立。
  • 在客户端和服务器上安装 0.9.0:商店协议已更改,以防止过时的客户端显示不完整的价格。旧报价加载时无材料需求。

0.8.0 新增 — 紧凑商店布局

  • 主菜单使用三个紧凑列:护甲、武器与工具、补给。材料按钮和分类来自配置的目录,额外条目带分页。
  • 能力和“我的能力”是独立按钮,从不出现在物品网格中。
  • 物品商店:左侧为可选择的图标槽位;右侧为物品名称、捆数、数量和价格。使用真实的已注册 Minecraft/模组物品图标。
  • 数量控制、购买/出售、明确确认和紧凑交易收据保留服务器权威定价和背包验证。
  • 现有目录、价格、共享设置、钱包和已拥有能力保持不变。

命令

命令 功能 访问权限
/shop 买卖物品、购买能力、切换已拥有能力 所有玩家
/shopedit 分区、物品报价、能力和 HUD 操作员/游戏管理员;单人游戏中需开启作弊
/spcoinedit 怪物奖励和货币设置 操作员/游戏管理员;单人游戏中需开启作弊

仅创造模式不会授予编辑权限。创造模式购买仍需花费硬币;创造模式击杀不奖励硬币。

0.6.0 新增

SP Coins 现在拥有钱包、实体硬币物品、生物/方块奖励、/spcoinedit、/spcoins、货币通知 UI 以及可选的 SP VitalView 集成。SP Shop 仅拥有其目录、购买、能力和能力 HUD。它通过公开的 CoinsApi 读取和支付;Luck 通过 API 提供加成,而不是重复怪物奖励。

替换旧版商店 JAR,并在客户端和服务器上安装两个新 JAR。SP Coins 会自动导入一次旧余额/奖励设置并生成备份;商店保留已购买能力和目录设置。旧版 sp_shop:spcoin 仍可使用,而新掉落使用 sp_coins:spcoin。之后移除 SP Shop 会留下一个功能正常的独立经济系统。不要将这些版本与旧版 SP Shop 一同安装。

以下各节描述早期版本引入的功能;货币设置现由 SP Coins 提供。

0.5.1 新增

方块挖矿现在可以奖励 SPCoins。在 /spcoinedit 中,打开 方块奖励设置 并启用该功能,然后使用 方块奖励规则 添加/编辑/删除规则。每条规则有一个方块注册 ID、启用开关、最小/最大硬币数和百分比概率。应用表单,返回,然后 全局保存。有八条初始规则,适用于煤/铁/金/钻石矿石及其深板岩变种(10% 概率,1–3 枚硬币)。总开关默认为 关闭,包括现有世界。

只有玩家使用合适工具成功挖矿才会奖励硬币;创造/旁观模式、失败的破坏、爆炸和自动机器不会。矿脉采矿/伐木采矿使用相同的逐方块奖励路径。全局奖励倍率、物理/直接交付和通知偏好适用。超过 4096 的大额奖励像之前一样使用直接交付;Luck 仍只修改怪物奖励。

排除玩家放置的方块 默认开启,可为农场友好型经济关闭。此更新后进行的普通 BlockItem 放置会被记录,即使奖励已禁用。现有已记录的矿石放置会被保留。这是放置跟踪,不是通用的自然方块检测器:更新前的非矿石放置、活塞移动、次要多方块部件以及其他模组直接执行的放置不会被全面跟踪。已记录的位置会持久保存,并在挖矿时清除。

0.5.0 新增

  • 已注册货币物品 sp_shop:spcoin:一个物品即一枚 SPCoin,最多堆叠 64。金币模型,中心为绿宝石;/give @s sp_shop:spcoin 64 对操作员有效。
  • 怪物奖励默认为 物理 掉落。硬币使用普通物品拾取、消失/损坏、箱子和漏斗行为。任何收集硬币的人都会获得其价值。正常地面拾取需要一个空闲背包槽位或匹配的硬币堆叠。
  • 玩家背包、副手或携带光标中的硬币会在服务器上自动兑换。存储容器内的硬币保持原样。达到钱包上限时只兑换可容纳的数量;剩余物品保持物理状态。钱包保存失败会恢复已移除的物品。
  • /spcoinedit → 全局 SPCoins 设置 → 硬币交付 选择物理或直接。每次击杀超过 4096 硬币的奖励会自动使用直接交付,以限制掉落实体数量。销售始终直接计入数字钱包。应用编辑,然后返回 → 全局保存。
  • +X SPCoins 通知 有三个世界设置:
    • 自动(默认):如果安装了并启用了 SP VitalView,则使用其拾取信息流;否则使用 SP Shop 的通知。
    • 开启:货币始终使用 SP Shop 的通知。
    • 关闭:禁用 SP Shop 的通知;如果启用了 SP VitalView,仍可显示货币。
  • 可选的 SP VitalView 0.4.0 适配器将以注册硬币物品的形式转发来自掉落、箱子取出、销售和直接奖励的已确认钱包入账。它会抑制其重复的自然硬币拾取通知。在自动模式下,禁用/透明的拾取信息流和不支持的数值数量会回退到我们的精确数量。其他物品通知不受影响。
  • 自动目前识别 SP VitalView,而非所有第三方拾取模组。其他模组可以引用注册的物品 ID,但可能需要自己的集成来显示钱包入账。当在其他地方管理通知时可以使用关闭。
  • 现有余额、能力和商店目录会保留。在服务器和客户端上安装匹配的 0.7.0 JAR 加上 SP Coins 1.1.0,替换旧版 SP Shop JAR。与其他物品一样,存储的硬币需要模组保持安装。钱包文件和原版背包是分开的存档;这不承诺在机器崩溃时实现原子恢复。

0.4.0 新增

  • 交易收据使用较小的居中卡片,带有狭窄的绿色成功标题,而不是大的纯绿色面板。
  • 能力购买现在遵循 时长 → 查看购买 → 支付 / 取消。最后一页显示能力、所选时长、确切价格和结果余额。只有支付才会发送购买。取消不花费任何费用;服务器仍会验证所有权、资金和当前价格。资金不足时无法支付。
  • 夜视:在黑暗中清晰视物。
  • 苦力怕守护:在 8 格半径内防止苦力怕引信/爆炸,可在能力编辑器中从 2–16 调整。它还会拆除半径内手动点燃的苦力怕。苦力怕仍可能靠近;TNT 和其他爆炸不受影响。
  • 末影人和平:目光接触不再激怒末影人。攻击它仍可能引发报复;现有的愤怒不会被消除。
  • 水下呼吸:在水下呼吸。与夜视一起使用时,使用在能力激活期间维持的隐藏环境效果。禁用/过期会移除商店创建的效果;现有的普通药水效果保持不变。

四个新能力支持 1 小时/3 小时/6 小时/永久方案、可编辑价格、开关和 HUD 图标。一小时起始价格分别为 600/650/700/750 SPCoins;其他方案使用现有的 3×/6×/24× 默认值。

首次升级时,四个报价会添加到现有的 abilities 分区(如果存在)。备份保存为 sp-shop.pre-0.4.0.json;价格、余额和所有权会保留,后续删除会被尊重。

0.3.3 新增

在确认的怪物奖励或物品销售后,游戏屏幕顶部中央附近会出现一个紧凑的金色 +X SPCoins 通知。连续收益会合并并刷新其四秒显示;结束时淡出。当菜单打开时,它会等待游戏恢复。加载余额、购买物品或接收常规 HUD 更新从不计为收益。断开连接会清除待处理通知。完整余额保留在背包/商店中。

在客户端和服务器上使用 0.3.3。余额和配置会保留。

0.3.2 新增

  • 成功的购买和销售现在会打开一个单独的绿色收据,显示购买的物品/数量或能力/时长、价格和剩余余额。失败的交易显示单独的琥珀色说明。继续购物返回同一报价;收据基于服务器响应。
  • 状态文本使用购买按钮之外的免费页脚区域。之前重叠的确认文本已移除。
  • 默认情况下,游戏过程中会出现紧凑的能力图标,不带 SPCoins 余额。背包仍显示余额和图标,并有悬停详情。/shopedit → HUD 位置 → 游戏中的图标 可以隐藏游戏条。现有世界会收到新的默认值,而不改变大小、余额或已拥有能力。

在客户端和服务器上将旧版 SP Shop JAR 替换为 0.3.2。

0.3.1 新增

能力 HUD 现在是一个 紧凑图标条,默认 仅在玩家背包中 显示(生存和创造模式)。SPCoins 和能力都不再出现在游戏视图中。将鼠标悬停在图标上可查看其名称、精确剩余时间、激活/禁用状态和冷却时间。大型计时卡已移除。

/shopedit → HUD 位置:可见性、X/Y、图标大小 8–24 GUI 像素(默认 12)以及 仅在背包中。将最后一项设为否以在游戏过程中也显示紧凑条。我的能力 继续提供所有权和开关。

从 0.3.0 更新会将布局切换为仅背包,并将之前的图标大小一次性上限设为 12,同时在 sp-shop.pre-0.3.1.json 中保留备份。之后对大小/显示模式的更改会保留。余额、价格和已购买能力保持不变。在客户端和服务器上使用 0.3.1。

该模组还有一个原创的金色商店硬币和绿宝石图标,注册在其 Fabric 元数据中。

0.3.0 新增

  • 每个能力提供 1 小时、3 小时、6 小时或永久,并确认所选价格和时长。/shopedit → 能力 → 能力 → 时长价格 编辑所有四个价格;-1 禁用某个时长。新默认值将三个临时方案定价为每小时价格的 1×/3×/6×,永久为 24×。在线时间计算仍为默认,可按能力配置。
  • 四个新能力:飞行、保留物品、生长光环、双倍收获(详情如下)。
  • /shopedit → 物品 / 购买 / 出售 打开可视化目录:分区 → 分类 → 组 → 报价。+ 添加 在当前层级创建节点;↑ / ↓ 更改其顺序;名称 重命名它;× 在删除它及其内容前询问。空分类/组会保持保存并可见。打开一个分区并使用 图标 选择其图标。
  • 要在 Special 上方插入一个组:打开物品 → 食物,添加组,然后用 ↑ 向上移动。打开该组 → + 添加物品 → 按显示名称或注册 ID 搜索物品并点击其图标。它仅附加到此组。点击报价以编辑捆数、买/卖价格、变体和启用状态;物品 使用相同的选择器更改其物品。已安装的模组物品也包含在内。
  • /shopedit → HUD 位置 现在设置图标大小(现为 8 到 24 GUI 像素),以及 X/Y 和可见性。Minecraft GUI 缩放也会影响物理屏幕大小。

从 0.2.0 更新

在 客户端和服务器 上都将之前的 JAR 替换为 0.3.0;移除旧的 SP Shop JAR。网络通道已为新时长选项进行版本化。世界升级保留余额、已授予时长、现有物品价格、自定义组名称和能力设置,并在写入迁移配置之前保存 sp-shop.pre-0.3.0.json。新能力会一次性添加到现有的 abilities 分区(如果存在)。后续删除会被尊重。

之前的能力价格成为其一小时价格。三/六小时价格按 3×/6× 推导;永久为 24×,但现有的永久报价保留其之前的永久价格。管理员可以立即重新平衡所有四个。已购买的授予保持不变,包括自定义时长。

目录布局(0.2.0 引入)

/shop → 物品 现在打开一个受参考商店布局启发的分类目录:

  • 装备:三个水平行——武器、护甲、工具与额外。材料按钮包括有报价的木头、石头、铜、铁、金、钻石和下界合金。护甲还有皮革、锁链和海龟变体;没有虚构的木头/石头护甲。弓、弩和箭出现在远程下,盾牌和其他工具出现在实用下。
  • 彩色方块:羊毛、混凝土和染色玻璃行,每行有 16 种颜色变体。
  • 功能方块:工作站、存储和红石。
  • 食物:农作物与水果、餐食和特殊。
  • 资源:原始资源报价仍然可用。

选择变体会打开带有真实物品图标、名称和价格的物品瓦片。悬停显示完整物品名称、捆数和两个价格。页面暴露更多变体而不挤压标签。仅显示启用的报价。

初始目录包含 158 个报价。新装备报价默认禁用出售;现有价格保留。/shopedit 维护显式的分类/组顺序。报价可以在其组内保留材料/颜色变体。

更新现有世界

替换旧 JAR;不要同时保留两个版本。多人游戏客户端和服务器必须使用相同的 SP Shop 版本。

现有的原始初始商店会一次性扩展,而不改变现有价格、余额或已拥有能力。原始钻石镐的旧工具分类变为装备。故意缩减/自定义的目录不会被重新填充。迁移前副本保留为存档旁的 sp-shop.pre-0.2.0.json。进一步编辑或删除不会在下次重启时重新引入。

商店

余额从 0 SPCoins 开始。通过出售配置的物品或直接击杀配置的怪物(玩家弹射物计入)来赚取硬币。环境死亡和玩家击杀不给硬币。余额按玩家 UUID、按世界/服务器。

从 物品、能力 和 我的能力 开始。物品分类出现在分区内。选择报价,选择捆数,选择购买/出售,然后确认。服务器重新检查价格、余额和背包空间。背包已满会拒绝购买而不扣钱。

默认物品(每捆一个) 购买 出售
圆石 4 1
橡木原木 8 2
铁锭 30 8
钻石 150 40
面包 10 2
钻石镐 500 禁用

/shopedit 将报价放入所选组,并设置其物品、变体、捆数、买/卖价格和启用状态。-1 禁用购买或出售;0 表示免费。 同一报价的出售价格不能超过购买价格。出售仅接受普通匹配物品:损坏、命名、附魔或自定义的物品被排除。模组物品可以在物品选择器中按名称或注册 ID 找到。

SPCoins 编辑器

默认规则覆盖僵尸、骷髅、苦力怕、蜘蛛、末影人、女巫、烈焰人、凋灵骷髅和史莱姆:2–5 枚硬币,75% 概率,5% 额外概率 x2。这些是可编辑的起始值。

每个怪物:实体注册 ID、启用、最小/最大数量、奖励概率、额外概率、额外倍率。全局控制:奖励开关、倍率、刷怪笼奖励、物理/直接交付和自动/开启/关闭货币通知。最终数量向下取整为整数硬币。已安装时支持模组实体 ID。

刷怪笼排除在安装 SP Shop 时识别普通怪物初始化;现有怪物和绕过初始化的模组可能不携带其标记。

能力

所有能力提供 1、3、6 小时或永久所有权。临时购买可续期,默认按在线时间计算。每个能力可以改为使用真实经过时间,包括离线时间。编辑器暴露其四个价格、名称、描述、图标物品 ID、分区、启用状态、计时模式和续期行为。以下价格为每小时。

能力 默认价格 效果/设置
矿脉采矿 100 潜行并挖掘面相连的同类型矿石。包括第一个在内共 32 方块限制,2 秒冷却;均可配置,限制最高 64。潜行要求可配置。
伐木 150 持斧潜行;同类型相连原木及附近树叶。相同的限制/冷却/潜行控制。
双倍掉落 200 25% 概率双倍挖掘矿石掉落;概率可配置。排除精准采集和已跟踪的玩家放置矿石。
自动熔炼 250 熔炉配方应用于挖掘掉落;概率可配置,初始 100%。排除精准采集。
二段跳 300 松开跳跃,然后在空中再次按下。一次额外跳跃;2 秒冷却。力量可从 0.25 配置到 2。
幸运 350 为怪物奖励概率增加 10 个百分点,上限 100%;可调 0–100。
飞行 400 双击跳跃在生存模式中飞行。过期/禁用会移除商店授予的飞行,如果在空中则给予 10 秒缓慢下落。创造/旁观飞行保留。
保留物品 450 死亡时保留背包、护甲和副手,并在重生时恢复而不掉落重复物品。XP 继续遵循原版世界规则。
生长光环 500 每秒一次,水平四格和垂直两格内的附近小麦/胡萝卜/马铃薯/甜菜根及兼容的 CropBlock 植物有可配置概率推进一个生长阶段(默认 10%)。需要足够光照和已加载区块。多个拥有者可以贡献。
双倍收获 550 方块破坏时双倍成熟作物产出,包括下界疣。小麦/甜菜根种子不双倍。概率可配置,默认 100%。不包括右键浆果收获和自动农场。
夜视 600 在黑暗中清晰视物;原生药水效果保持不变。
苦力怕守护 650 阻止附近苦力怕爆炸;默认半径 8,可编辑 2–16 方块。
末影人和平 700 防止目光接触激怒;报复仍可能发生。
水下呼吸 750 激活时在水下呼吸。

矿石识别使用以 _ore 结尾的注册路径,加上远古残骸。树木检测使用原木/树叶标签、同原木匹配和附近树叶。它无法将每棵树与由原木和树叶构成的建筑区分开。批量采矿消耗耐久度,调用普通方块破坏检查,工具损坏时停止,并保持在已加载方块和有界区域内。

双倍掉落目前影响矿石挖掘,而非怪物战利品或任意方块。熔炼发生在双倍之前。放置矿石跟踪覆盖普通物品放置;任意方块移动和其他模组的更改不是通用的来源系统。

二段跳排除创造模式、旁观者、鞘翅飞行、攀爬、骑乘、水和熔岩。它在第二次跳跃时重置下落距离;之后正常下落伤害累积。

HUD 与所有权

已购买的能力以物品图标显示剩余时间、永久授予的 无限、OFF 或冷却。/shopedit 控制 HUD 可见性、X/Y 位置和图标大小。/shop → 我的能力 切换效果而不暂停计时器。

续期增加时间;永久能力不能购买两次。临时所有权可以升级为永久。设置更改时,现有授予保留其原始计时模式;等待过期后再购买不同的临时计时模式。最大累积时间:一年。移除能力报价会保留其保存的所有权,但禁用/隐藏其效果,直到其类型恢复。

编辑

编辑表单并点击 应用 将其更改复制到编辑器草稿。应用保持表单打开。返回(或 Escape)返回而不应用后续编辑。在编辑器根节点点击 全局保存 以持久化草稿。放弃 / 退出 保持已保存设置不变。多页表单使用上一页/下一页按钮。0.3.2 中界面标签为英文;自定义名称/描述接受保加利亚语。

添加、重命名、重新排序或删除分区;删除会确认移除其报价。为十四种内置能力类型添加/移除报价。新效果类型需要代码。

限制:24 个分区、96 个分类、每分类 64 个组、512 个物品报价、十四种能力类型、96 条怪物规则、有界设置大小(可能在达到条目限制之前就达到)。服务器重新验证编辑器权限、值和当前价格。并发编辑器更改会拒绝过时草稿。最大余额:一万亿 SPCoins。

保存

世界本地文件:<world>/sp-shop.json。保存授予、玩家偏好和放置记录。钱包属于 SP Coins;配置共享在 config/sp-shop/settings.json 中。货币/配置立即保存;在线计时器每 30 秒、断开连接和正常关闭时保存。无效数据会禁用商店并保留文件。写入使用临时文件替换。

备份完整世界,包括玩家背包。Minecraft 背包和商店数据是分开的文件:突然的进程/存储故障不是跨文件原子事务。强制关闭也可能恢复最多 30 秒的在线计时器。正常重新打开的持久性由集成运行器覆盖。

共享设置与世界数据

设置由同一 Minecraft 安装/服务器内的所有世界共享:

  • SP Coins:config/sp-coins/settings.json — 奖励规则、概率、数量、交付和通知。
  • SP Shop:config/sp-shop/settings.json — 分区、目录、价格、能力规则/时长和 HUD 设置。

在编辑器中使用 全局保存。在多人服务器上,这些文件属于服务器,而非连接玩家的客户端。单独的 Minecraft 配置文件/服务器有单独的配置目录。要将设置复制到另一个安装,请在游戏/服务器停止时复制这些设置文件。

钱包、获得的能力授予/计时器、每玩家禁用的能力和放置方块记录保留在每个世界的 sp-coins.json / sp-shop.json 中。它们永远不会复制到共享设置中。普通世界保存不会覆盖共享配置。

升级后首次启动时,打开你想保留其设置的现有世界:如果不存在共享文件,其设置会作为共享文件的种子。后续世界使用共享文件而不替换它。迁移期间原始世界文件保留为 *.json.pre-shared-settings.bak。无效的共享设置会停止加载,而不是重置它们。

SHADYCRAFT HUB