萨维斯共同经济

萨维斯共同经济

全功能经济模组，支持模组兼容性、多服务器支持、数据库后端、玩家箱子商店、银行票据和交易历史。仅服务端！

经济

萨维斯共同经济预览查看大图

Savs Common Economy

一个为 Minecraft 26.1（Fabric）打造的全面、仅服务端经济模组，专为 SMP 服务器和多服务器网络设计。它提供强大的经济系统，支持 JSON、SQLite、MySQL 和 PostgreSQL 存储、离线玩家支持、排行榜、实体纸币、玩家箱子商店以及跨服网络同步。无需客户端安装。

核心功能

  • 仅服务端：无需修改客户端。原版客户端加入你的 Fabric 服务器即可完美运行。
  • 数据库支持：从简单的 JSON（默认）起步，或针对高流量环境升级到 SQLite、MySQL 或 PostgreSQL。
  • Redis 网络同步：内置 Redis 发布/订阅支持。在代理架构和多服务器网络之间同步余额与交易通知。
  • Common Economy API：完整支持 Common Economy API，可与 Universal Shops、Mob Money 及其他兼容经济模组集成。
  • 离线交易：即使玩家离线，也能无缝执行管理操作和向玩家付款。
  • 箱子商店：玩家商店。使用原版告示牌创建收购和出售箱子商店。
  • 买与卖系统：快速配置官方服务器价格，让玩家通过 /buy 和 /sell 命令直接与服务器交易。（可通过 worth.json 自定义）。
  • 纸币：玩家可以将数字余额提取为原版纸张物品，用于交易或储存。
  • 交易日志：为服务器管理员提供可搜索的游戏内交易账本（/ecolog）。
  • 原版权限设置：使用 permissions.json 配置文件，通过原版 OP 权限等级轻松配置命令访问级别。

命令

玩家命令

  • /bal 或 /balance：查看自己的余额。
  • /bal <player>：查看其他玩家的余额。
  • /pay <player> <amount>：向其他玩家支付一定金额。
  • /baltop 或 /balancetop：查看服务器上最富有的玩家。
  • /withdraw <amount>：将钱提取为实体纸币。
  • /worth：查看手中物品的价值。
  • /worth all：查看背包中所有与手中物品相同的物品的价值。
  • /worth list：查看所有服务器买入和卖出价格的有序彩色表格。
  • /worth <item>：查看特定物品的价值。
  • /buy <item> [amount]：直接从服务器购买物品。
  • /sell：出售当前手中的物品堆。
  • /sell all：出售背包中所有相同的物品。

商店命令

  • /shop create sell <price>：创建一个出售商店（向玩家出售物品）。
  • /shop create buy <price>：创建一个收购商店（从玩家处收购物品）。
  • /shop remove：进入移除模式，点击告示牌即可删除商店。
  • /shop info：显示你正在查看的商店信息。
  • /shop list：列出你拥有的所有活跃商店。

管理员命令（等级 2+ / 可配置）

  • /givemoney <player> <amount>：向玩家账户添加金钱。
  • /takemoney <player> <amount>：从玩家账户移除金钱。
  • /setmoney <player> <amount>：将玩家余额设置为指定金额。
  • /resetmoney <player>：将玩家余额重置为默认初始值。
  • /shop admin：切换管理员商店创建模式（无限库存/资金）。
  • /ecolog <target> <time> <unit> [page]：搜索交易日志（例如 /ecolog * 1 h）。

配置指南

主配置文件会自动创建于 config/savs-common-economy/config.json。 你可以在这里更改默认初始余额、货币符号和数据库详情。

{
  "defaultBalance": 1000.0,
  "currencySymbol": "$",
  "symbolBeforeAmount": true,
  "enableSellCommands": false,
  "enableChestShops": true,
  "storage": {
    "type": "JSON",
    "host": "localhost",
    "port": 3306,
    "database": "savs_economy",
    "user": "root",
    "password": "password",
    "tablePrefix": "savs_eco_",
    "poolSize": 10,
    "connectionTimeout": 30000,
    "idleTimeout": 600000
  },
  "redis": {
    "enabled": false,
    "host": "localhost",
    "port": 6379,
    "password": "",
    "channel": "savs-economy-updates",
    "debugLogging": false,
    "timeout_ms": 5000,
    "client_name": "Savs-Economy-Node"
  },
  "apiNotificationMode": "ACTION_BAR",
  "commandNotificationMode": "CHAT"
}

配置项说明

通用

  • defaultBalance：新玩家首次加入时的初始金额。
  • currencySymbol：显示在金额旁边的符号（例如 "$"、"€"、"Coins"）。
  • symbolBeforeAmount：若为 true，输出显示为 $100。若为 false，输出显示为 100$。
  • enableSellCommands：开启或关闭 /worth、/buy 和 /sell 服务器市场。
  • enableChestShops：开启或关闭玩家箱子商店告示牌系统。

存储选项

控制玩家余额的保存方式。

  • storage.type：选择保存玩家余额的方式。JSON 是默认选项，非常适合标准服务器。如果你运营大型网络，将其改为 MYSQL 或 POSTGRESQL。
  • storage.host / port / database / user / password：仅在使用 MYSQL 或 POSTGRESQL 时填写。
  • storage.tablePrefix：数据库表使用的前缀（默认 savs_eco_）。

Redis 网络同步（可选）

如果你运营多服务器网络，开启此项以在服务器之间同步余额。

  • redis.enabled：设为 true 以启用跨服余额共享。
  • redis.host / port / password：你的 Redis 服务器登录信息（端口通常为 6379）。
  • redis.channel：确保网络中每台服务器的此处文本完全一致，以便它们能够互相通信。

聊天通知

控制交易消息如何向玩家显示。 将这些设置为 ACTION_BAR（在快捷栏上方短暂显示）、CHAT（标准聊天消息）或 NONE。

  • apiNotificationMode：由其他插件自动触发的消息。
  • commandNotificationMode：来自玩家命令（如 /pay）的消息。

权限与 OP 等级

该模组支持 LuckPerms 和 Fabric Permissions API。

如果你未使用权限管理器，我们会优雅地回退到标准的原版 OP 等级。打开 config/savs-common-economy/permissions.json 文件，即可轻松更改每条命令所需的 OP 等级。大多数标准玩家命令默认为 OP 等级 0（所有人），而管理员命令默认为 OP 等级 2。

以下是你可以在配置中更改的所有当前权限节点列表：

玩家命令节点（默认：等级 0）

  • savscommoneconomy.command.bal：访问 /bal 以查看自己的余额。
  • savscommoneconomy.command.bal.others：访问 /bal <player> 以查看他人余额。
  • savscommoneconomy.command.pay：访问 /pay。
  • savscommoneconomy.command.withdraw：访问 /withdraw。
  • savscommoneconomy.command.baltop：访问 /baltop。
  • savscommoneconomy.command.worth：访问 /worth 和 /worth all。
  • savscommoneconomy.command.sell：访问 /sell 和 /sell all。
  • savscommoneconomy.command.buy：访问 /buy。

商店命令节点（默认：等级 0）

  • savscommoneconomy.shop.create：访问以创建收购和出售箱子商店。
  • savscommoneconomy.shop.info：访问以查看商店详情。
  • savscommoneconomy.shop.list：访问以查看所有活跃商店。
  • savscommoneconomy.shop.remove：访问以安全拆除自己的商店。

管理员命令节点（默认：等级 2）

所有强大的管理功能都安全地分组在一个单一节点约束下。

  • savscommoneconomy.admin：控制对所有管理功能的访问，包括 /givemoney、/takemoney、/setmoney、/resetmoney、/shop admin 和 /ecolog。

箱子商店设置

箱子商店允许玩家或管理员直接从箱子中买入和卖出物品。

如何创建商店：

  1. 放置任意箱子容器并放入物品（如果要创建 sell 出售商店）。
  2. 手持要出售的对应物品，精确地看向箱子。
  3. 运行 /shop create sell 100 创建一个以每次交互 100 美元向玩家出售物品的商店。
  4. 或者，运行 /shop create buy 50 创建一个以每次交互 50 美元从玩家处收购物品的商店。

如何与商店交易：

  1. 右键点击任意实体商店告示牌以开始交易。
  2. 在聊天中输入你想买入或卖出的数量（例如输入 10 或输入 all），然后按回车键。
  3. 收到你的物品或金钱。