OniriaEconomy

OniriaEconomy

一个为 NeoForge 21.1.231 服务器设计的完整高级经济、商店与权限组系统。

OniriaEconomy 添加了一个基于 OniriaCoins (OCS) 的完全集成的虚拟货币系统，包含游戏内商店、高级权限组处理、NPC 奖励、区块购买、管理员管理工具和安全的 PayPal 支持。

它专为那些希望以干净、现代的方式销售游戏内奖励，同时对购买、续期、限制和玩家进度保持完全控制的服务器而设计。

---

主要功能

虚拟货币：OniriaCoins (OCS)

• 专属服务器货币系统
• 服务器与客户端之间的玩家余额同步
• 用于添加或移除货币的管理员工具
• 专为服务器盈利和高级奖励而构建

游戏内商店

玩家可以直接在可视化的游戏内商店中花费 OCS 来购买：

• 物品
• 命令
• 临时或永久权限组
• 区块认领
• NPC 预设

商店包括：

• 现代化 UI
• 购买确认界面
• 每个条目描述
• 支持限制性和唯一性购买

购买限制与唯一性购买

对于物品、命令和 NPC 奖励，你可以配置：

• 唯一性购买（仅能购买一次）
• 每位玩家的最大购买次数
• 管理员重置玩家的购买限制

这对于捐赠者礼包、一次性解锁、特殊奖励和可控的服务器优惠非常有用。

临时权限组与自动续期

OniriaEconomy 支持带有效期的权限组套餐，例如：

• 7 天
• 30 天
• 90 天
• 永久权限组

额外的权限组功能：

• 自动过期处理
• 可选的使用 OCS 自动续期
• 玩家端的续期开关
• 权限组续期或过期时的通知
• 活跃的临时权限组在过期前无法重新购买

PayPal 集成

• 通过 PayPal 购买 OCS
• 沙盒和生产模式
• 仅服务器端验证
• 订单在货币记入前将安全地捕获
• 包含交易日志
• 凭证可以安全地存储在主配置之外

管理员 GUI

管理界面允许你：

• 重新加载商店配置
• 打开可视化商店编辑器
• 管理玩家余额
• 重置玩家的唯一性/限制性购买

可视化商店编辑器

内置编辑器允许管理员配置商店，而无需手动编辑 JSON。 你可以创建和管理：

• PayPal OCS 套餐
• 物品条目
• 命令条目
• 权限组条目
• 区块条目
• NPC 条目
• 描述
• 购买限制
• 唯一性购买标志

简易 NPC 支持

OniriaEconomy 可以用 Easy NPC 预设 奖励玩家。 它支持直接将预设导入到玩家位置，并能根据你的设置自动应用所有权/跟随行为。

NPC 跟随魔杖

该模组包含一个可合成的实用物品：

• NPC 跟随魔杖
• 右键点击你拥有的 Easy NPC 来切换跟随主人功能的开启或关闭

区块购买支持

与基于命令的区块奖励设置（如 FTB Chunks）兼容。 你可以配置区块购买模板，并通过商店出售与认领相关的奖励。

已购买物品保护

已购买的商店物品可以被标记为受保护，以防止通过死亡相关系统被随意窃取，并针对 Corpse 风格的游戏机制设计了专用逻辑。

结构化日志

重要操作会以结构化格式记录，使审核和 Discord/服务器监控变得更加容易。 示例包括：

• 购买
• 权限组续期开关
• 余额修改
• 购买重置
• 商店配置操作

---

服务器集成

OniriaEconomy 设计为与以下内容特别兼容：

• NeoForge 1.21.1
• FTBRanks
• FTB Chunks
• Easy NPC
• Corpse
• PayPal

某些集成基于命令模板，这为你提供了更大的自由来使模组适应你的服务器环境。

---

安全性

OniriaEconomy 的设计始终将服务器端安全放在首位：

• PayPal 验证在服务器端完成
• 仅在付款捕获后才会记入货币
• 凭证不会暴露给客户端
• 支持安全的外部机密存储
• 交易日志可用于审计和支持

---

典型用例

此模组非常适合：

• 捐赠者/高级商店
• VIP 权限组订阅
• 一次性高级礼包
• 付费区块认领
• 付费 NPC 解锁
• 自定义货币化命令奖励
• 具有高级进程的 RPG 或生存服务器

---

需求

• Minecraft 1.21.1
• NeoForge 21.1.231
• Java 21

---

备注

• 主要针对多人服务器使用而设计
• 某些高级功能依赖于你的服务器命令模板或可选模组
• 如果你只想手动管理 OCS，PayPal 是可选的