新币

🪙 新硬币

中文

添加一个硬币系统——一种用于贸易、经济机制，或仅仅作为精美收藏品的新货币！

---

✅ 主要特性

• ✅ 3种硬币：金币、银币和铜币——具有不同的价值和独特的纹理
• ✅ 自定义名称与描述：悬停可查看当前面值和描述
• ✅ 易于集成：可独立运行，也可与其他项目配合使用
• ✅ 面向经济的架构：专为未来扩展而设计（例如，银行、兑换终端）
• ✅ NeoForge支持：专为 NeoForge 21.1.x 构建

---

📅 开发路线图

🔜 即将在后续版本中推出（可能会有变动）

1. 纸币 → 高面额物品作为独立物品（例如，100金币 → 1张纸币），具有自定义模型、图标和重量

2. 借记卡

   • 首次使用：激活界面提示玩家创建密码
   • 后续使用：访问银行功能时需要输入密码
   • 卡片与玩家账户绑定，安全存储余额
   • 可扩展：可集成商店系统、多人游戏经济API

3. 音效

   • 每种硬币类型都有独特音效（拾取、掉落、交易、合成）
   • 纸币和卡片确认时的动画音效触发
   • 可通过 config/coins.toml 或命令配置：音量、音源和场景
   • 资源包友好：音效定义位于 assets/coins/sounds.json 及资源文件中

4. 增强的价值系统与兑换

   • 灵活的汇率（例如，1金币 = 10银币 = 100铜币）
   • 自动计算找零（例如，用于商店物品定价）
   • 基于NBT的交易记录、所有权、时间戳
   • 数据包友好：面额和配方可配置

---

🛠️ 面向开发者

• 使用：NeoForge API (1.21.1)、Java 21
• 源代码：
  • Gitverse
  • GitHub
• 许可证：MIT（参见 LICENSE 文件）

---

❓ 支持与反馈

• 错误报告与功能请求：Github Issues
• 截图与教程：请参阅下方 截图 部分 👇

---

Русский

Добавляет систему монет — новую валюту для торговли, экономики или просто как красивые коллекционные предметы!

---

✅ Основные возможности

• ✅ 3 типа монет: Золотые, Серебряные и Медные — с разными стоимостями и уникальными текстурами
• ✅ Кастомный лор и имена: При наведении — подсказка с текущим номиналом и описанием
• ✅ Легкая интеграция: Работает как отдельно, так и в связке с другими дополнениями
• ✅ Экономически-ориентированная разработка: Монеты можно легко расширять (например, добавить банки, обменники и т.д.)
• ✅ NeoForge-совместимость: Специально для NeoForge 21.1.x

---

План развития

🔜 В ближайших версиях, но все может поменяться

1. Бумажные деньги (banknotes) → Крупные номиналы в виде отдельных предметов с уникальной моделью, иконкой и весом (например: 100 золотых → 1 бумага вместо стака монет)

2. Банковские карты (debit cards)

   • При первом использовании — появляется интерфейс активации: игрок создаёт пароль (введён через GUI)
   • В последующих сессиях — при обращении к банковской системе запрашивается пароль
   • Карта привязывается к аккаунту игрока и хранит баланс
   • Совместимость: можно интегрировать с системой банка, магазинов или мультиплеерной экономики

3. Добавление звуков

   • Уникальные звуки для каждого типа монет (при дропе, подборе, использовании в крафте/торговле)
   • Анимированные звуки банкнот и карт при активации/подтверждении
   • Опциональная тонкая настройка громкости и источника звука через конфиг/команду
   • Совместимость с ресурс-паками: звуки вынесены в assets/coins/sounds.json и assets/coins/sounds/

4. Переработанная система ценностей и обмена

   • Гибкая настройка курса: 1 золотая = 10 серебряных = 100 медных
   • Автоматический расчёт размена (например, при добавлении предметов с ценой)

---

🛠️ Для разработчиков

• Использованы: NeoForge API (1.21.1), Java 21
• Исходный код: Gitverse или Github

---

❓ Поддержка и обратная связь

• Ошибки и фич-реквесты: Issues на Github
• Скриншоты и гайды: в секции Screenshots ниже 👇