PyreTale Gilded Dreams

Gilded Dreams // 为 Hytale 打造的全方位玩家经济系统

大多数模组只是给你一种货币。Gilded Dreams 给你的是一整个经济体系。 开设店铺、雇佣店员、将金币存入银行、在实时拍卖行中参与竞价、搜寻游商，以及与其他玩家面对面交易——这一切都通过简洁的按钮驱动界面完成。为“金币应当举足轻重”的服务器而生。

主要指令： /shop、/bank、/auction、/trade、/gold （另有管理界面） 需求： Hytale 服务器 0.5.6+ 联动： 同团队出品的 Empires ——税收、国库、建国费用均基于 Gilded Dreams 的金币体系运行。

已在我们的主服务器 PyreTale 上线，与 LadyPaladra 出品的 Empires、The Armoury 以及 Riprod 出品的 Hexcode – Magic by Design 协同运行。安装前可先来体验实际效果。

---

概览

Gilded Dreams 是 Hytale 服务器的经济支柱。它不是带有商店招牌的“/balance”插件，而是一个鲜活的交易市场。玩家可通过击杀生物和交易赚取金币、建立自己的商店并雇佣真实的 NPC 店员驻守柜台、开设银行以收取交易税，还能在全服拍卖行中竞相加价——每一条拍卖信息都会在交易频道中公告。

所有金币都是同一种货币，在商店、银行、拍卖行、玩家交易之间通用；若你运行 Empires，税收和国库也使用同一体系。经济与政治作为一套系统运作，而不是两个互不关联的插件。

所有功能都通过生态系统中统一的按钮驱动菜单管理：商店中心、银行中心、拍卖行、游商补货中心，以及面向服务器管理团队的管理面板。玩家无需记忆数十条指令来运营市场，也能清晰看到在售商品及其价格。

---

核心特性

拍卖行

一个完全由玩家驱动的竞拍场所，而非固定价格货架。所有操作都在一个包含六个标签页的中心内完成。

• 真实的竞价战。 可加价 5、10、20、50、100 或 1000 金币，也可输入自定义金额。最小加价幅度为 5 金币，每次出价都必须高于当前最高价。
• 每次出价前均有确认步骤 // 点击一个加价档位后，你会看到“确定出价 1,115 金币吗？”并附有确认和取消按钮。误触 1000 金币档位绝不会让你损失惨重。
• 出价以你的银行存款为依托。 出价时不会扣款，只有当最终获胜时才扣款。若最高出价者在结算时无法支付，商品将自动顺延给次高出价者，依此类推——不会出现流拍情况。
• 持续时间从 1 小时到 24 小时可选，上架时通过下拉菜单确定。
• 上架费（默认为你起拍价的 10%，可配置）维持拍卖行秩序，防止有人以一百万金币的天价挂单当作免费仓库。
• 每位卖家最多 5 个活跃拍卖，避免刷屏。
• “我的竞得”标签页 // 你竞得的所有物品都会安全存放在邮箱中等待领取。即使背包已满，也不会丢失任何物品。领取时先放入可容纳的物品，其余保留。
• “历史拍卖”标签页 // 你的完整出售记录：卖出什么、买家是谁、成交价是多少、哪些未能售出，以及累计金币收入。

拍卖通知

市场会主动与玩家沟通，无需他们主动查看菜单。

• 交易频道公告：每次新上架、拍卖进入最后阶段（显示剩余时间和当前出价）、每笔成交（含中标者和最终价格）都会发布公告。
• 个人提示：当有人超过你的出价时，以及你成功竞得时，会立即以加粗字体发送给你，确保不会被忽略。
• 卖家也会收到通知：收到首个出价、物品售出、或物品到期未售出时。
• 离线？不会错过任何消息。 提示会排队保存，在玩家下次上线时送达。
• 任何玩家都可静音公告，使用 /auction alerts 或在界面中切换；公开公告将静默，但个人的竞得/被超价提示仍会送达。

玩家商店

• 花费金币即可成立商店，并会生成一个真实的 NPC 店员守柜台——无需招牌，无需箱子，而是一个真正站在世界中的商人。
• 九种店员种族可选： 克洛普斯、费兰、特洛克萨满、哥布林食人魔、哥布林拾荒者、克威比克、流亡者、骷髅战士和荆棘精灵。可随时更换种族，NPC 会就地改变外观。
• 既出售物品，也发布收购订单：可上架商品供玩家购买，也可存入金币，让你的商店向玩家收购你需要的物品——一个完整的双向市场。
• 实时物品搜索店铺：顾客输入物品名称，匹配的列表会随输入实时显示，可同时搜索服务器上的所有商店。
• 通过 /shop hub 进行全面的自助管理：以单件物品的价格和数量上货、补货、修改价格、重命名、更换店员，并跟踪收益。
• 移动和转向店员 // 可将 NPC 重新定位到你的位置，或左右转向面向人群；重启后位置保持不变。
• 安全关闭：关闭商店会将存货退回你的背包（空间不足时会清晰警告），待结算收益则存入银行——任何物品都不会丢失。
• 每间商店拥有独立的收益金库，可存取资金以支持收购订单。

服务器商店（管理员）

• 通过管理中心的专属“服务器商店”标签页为世界投放服务器运营的商店。
• 无限库存，服务器商店永不售罄，支持单件物品的买入和卖出价格设定。
• 上货时实时物品目录搜索：开始输入，物品数据库即自动补全——无需记忆物品 ID。
• 全面的单店控制：传送至商店、转向、就地重命名、编辑库存、重新生成到你所在位置或直接删除——全部通过一个可扩展至数百家商店的可滚动列表完成。
• 自定义名称：会显示在 NPC 的姓名牌上以及玩家看到的商店窗口标题中。

银行业务

• 玩家自有银行：成立自己的银行、放置银行 NPC，并设定交易税（0 至服务器配置的上限），你将从分行每次存取款中抽取分成。
• 官方/管理银行，由工作人员运营，作为公共选择，配有专门的管理中心。
• 多分行：可放置额外的银行 NPC，并通过 /bank hub 管理——一个带有坐标的可滚动名单，支持移动、转向、重命名和删除。
• /bankadmin hub // 一个滚动管理面板，列出服务器上所有官方银行，支持逐 NPC 重命名、传送、移至本人处、转向和删除。
• 逐银行 NPC 税率覆盖：工作人员可为任何单个银行家设置特定税率，或让其继承银行的默认税率，并在柜台实时生效。
• 存款金币 vs. 随身金币：真正的银行余额与口袋中的金币分离，因此财富可在死亡和盗窃中幸存。
• 交易账本，记录每一笔资金流动，保证透明度。

游商

• 游荡商人在世界中玩家附近生成，使用定制的熊商模型，借用了原版动画。
• 真正的可猎杀目标 // 游商可以被攻击和击杀，与受保护的店员和银行家不同。
• 保持自然密度：世界会大致保持每位玩家附近有一个游商，按计时器刷新，存在数个游戏日后移动离开——他们总能被找到，但不会扎堆。
• 服务器控制的库存池：管理员可通过一个补货中心精确设置游商可出售的物品，支持实时物品目录搜索，并可就地编辑任何产品线，调整价格或数量而无需删除重新添加。
• 每个游商随机定价：设定一个价格范围（例如 5–15 金币），每位商人在生成时自行掷出价格，直到消失前保持不变——没有两个商人完全相同。
• 按世界控制生成：可选择游商出现在哪些世界。配置会自动列出所有世界，将任何世界设为关闭后该处即不再生成商人，通过 /gd reload 实时生效，默认所有世界开启。

NPC 金币掉落——完全可配置

• 由你决定哪些 NPC 掉落金币，以及掉落多少。 专门的 gold_drops.cfg 文件控制游戏中所有掉落。
• 内置分级：哥布林等杂兵掉落少量金币，食人魔或幽魂等精英掉落更多，BOSS 则掉落一笔可观财富。
• 动物不会印钞。 鸡、牛、鹿、鱼等被动型生物默认被排除。
• 可为每个 NPC 设置范围（drop = Trork, 4, 9），每次击杀在该范围内掷取。
• 兼容任何模组的 NPC。 规则按 NPC 的角色名称匹配，因此为另一模组添加生物只需一行。未列出的 NPC 默认不掉落金币，新模组绝不会无意中冲击你的经济。
• 内置发现工具：/gd roles <search> 列出服务器上所有 NPC 角色（包括模组中的），而 log_unmatched 选项会打印任何在无规则情况下死亡的实体的准确名称。
• 实时重载，使用 /gd reload // 无需重启即可重新调整整个掉落经济系统。

玩家间交易

• 安全的面对面交易，使用 /trade：在一个锁定双方界面中交换物品和金币，双方均需确认——没有骗局，无需扔到地上碰运气。

金币经济核心

• 一种货币支撑所有系统：商店、银行、拍卖、交易以及 Empires 税收均流动同一种金币。
• /gold（别名 /balance、/bal）可一眼查看存款和随身金币；管理员可使用 /gold give 发放金币。

为服务器主打造

• 三份带说明的配置文件，首次启动时自动生成：
  • gildeddreams.cfg // 商店开设费用、银行开设费用、银行 NPC 放置费用、默认及最高银行税、拍卖上架费以及 NPC 转向步长。
  • wandering_merchant.cfg // 商人的库存池、价格范围、寿命、模型、角色，以及允许出现的世界。
  • gold_drops.cfg // 哪些 NPC 掉落金币、掉落多少，以及排除项。
• 实时重载，使用 /gd reload // 无需重启服务器即可调整费用、税率、手续费和掉落。
• 全面 NPC 控制：每位店员、银行家和服务器商店商人均可从其中心传送、移至你所在位置、转向、重命名和删除——无需修改配置文件即可重新布局整个经济。
• 坚如磐石的 NPC 持久化：店员、银行家、拍卖师和商人在重启后依然存在，不会重复生成，精准保持在你放置的位置。
• 店员受到保护且性格温和：不会走失、不会战斗、不会造成或承受伤害——商店 NPC 是设施，不是怪物。
• 原子化、安全的结算：拍卖恰好结算一次，金币在单笔事务中移动，竞得物品存放在邮箱中而非冒险放入已满背包。
• SQLite 存储、单一 jar 文件、附赠资源包 // 已在真实服务器上经受实战考验，而非仅限开发世界。

---

操作中心

与 Empires 相同的 UI 语言，整套系统如同一个游戏而非一堆插件的堆叠。

• 拍卖行（/auction）：浏览所有实时列表、我的拍卖、活跃出价（可一眼看到领先/被超价状态）、我的竞得、历史拍卖，以及出售物品。
• 商店中心（/shop hub）：管理你自己的商店，另有玩家商店目录、跨服务器物品搜索、收购订单等标签页，以及（工作人员）服务器商店。
• 银行中心（/bank hub）：你的余额、你的分行、你的税率，并可放置/移动/转向/删除你拥有的每位银行 NPC。
• 银行管理中心（/bankadmin hub）：工作人员查看服务器上所有官方银行，支持重命名、逐 NPC 税率、传送、移动、转向和删除。
• 商人管理中心（/merchantadmin hub）：策展游商库存池，支持添加、就地编辑和移除。
• Gilded Dreams 中心（/gd）：所有功能的总入口。

---

指令参考

Gilded Dreams 设计为通过中心、下拉菜单和按钮操作，而不是靠记忆指令。下面的指令供你需要时使用，而非必须依赖。

拍卖

指令	说明
/auction (/ah, /auctions)	打开拍卖行
/auction alerts	为自己切换拍卖公告的开关
/auctionadmin ...	管理员：拍卖师 NPC 和列表管理

商店

指令	说明
/shop hub	管理你的商店 + 服务器商店目录和物品搜索
/shopfound <name> [species]	成立玩家商店（消耗金币；选择种族或使用菜单）
/myshop	管理你的玩家商店
/shopadmin hub	管理员：所有商店目录 + 服务器商店管理
/shopadmin cleanup	管理员：移除附近重复/重叠的 GildedDreams NPC

银行

指令	说明
/bank hub	管理你的银行、分行和税率
/bankfound <name>	成立玩家自有银行（消耗金币）
/bank placenpc	为你的银行放置额外银行 NPC（消耗金币）
/bankadmin hub	管理员：所有官方银行滚动面板 + 逐 NPC 重命名、税率、移动、转向、删除
/bankadmin place / remove / list / ledger / removeplayer	管理员：银行 NPC 和账本工具

商人、交易与金币

指令	说明
/merchantadmin hub	管理员：管理游商库存池 + 价格范围
/trade <player>	与其他玩家开启安全的物品 + 金币交易
/gold (/balance, /bal)	查看你的存款和随身金币
/gold give <player> <amount>	管理员：向玩家发放存款金币
/gd (/gdhub, /gildeddreams)	打开 Gilded Dreams 中心
/gd roles [search]	管理员：列出用于 gold_drops.cfg 的 NPC 角色名称
/gd reload	管理员：无需重启即可重新加载配置文件

权限节点（供管理员使用）

节点	授予权限
(默认)	基础玩家访问：商店、银行、交易、金币、拍卖
gildeddreams.admin	完整管理套件：/shopadmin、/merchantadmin、/auctionadmin、/bankadmin、/gold give、/gd reload、/gd roles 以及服务器商店

仅授予普通玩家基础访问权限。工作人员则授予 gildeddreams.admin。

---

快速上手

1. 安装 Gilded Dreams（搭配 Empires 可获得完整的政治经济循环）。

通过击杀生物、游商和其他玩家赚取金币。

1. /shopfound <name> // 选择店员、上货、开门营业。
2. 使用 /bankfound <name> 开设自己的银行，开始从每笔交易中获取税收。
3. /auction // 上架你最稀有的战利品，看着交易频道热闹起来，让竞价战为你买单。
4. 开始积累财富。

---

支持与社区

Bug 报告、功能请求和最快的解答：https://discord.gg/PTbXg4WWUF

想看看 Gilded Dreams 以完整规模运行的样貌？它已在 PyreTale 服务器上实时运行——我们的暗黑中世纪 Hytale 服务器，背景设定在即将推出的小说 Pyre 的世界中，同时 Empires、The Armoury 和 Hexcode 也在其上协同运行。IP 地址和详细信息见 Discord 服务器。