赤城竞技

赤城经济

Chicheng Economy 是一个为《我的世界》服务器或单人游戏添加了完整虚拟货币系统（赤城币）以及全功能自动售货机和收银机的模组。

玩家可以放置自动售货机，上架任意物品（支持附魔、NBT 等）。其他玩家可以使用赤城币购买物品，收益会自动分配给售货机主人（在线时实时转账；离线时收益存储，登录时支付）。

收银机允许玩家直接向主人转账，方便团队或服务器交易。该模组还包括余额 HUD、经济指令等辅助功能。

✨ 主要特性

🛒 自动售货机

• 放置与绑定： 放置方块的玩家自动成为主人。
• 上架物品： 主人手持物品右击售货机，设置单价和库存（支持任意物品，保留附魔和 NBT）。
• 购买物品： 任何玩家右击售货机打开购买界面，选择物品，输入数量 - 模组会自动检查余额和背包空间。
• 收益分配：
  • 主人在线 → 收益实时到账。
  • 主人离线 → 收益存储在售货机中，主人登录时自动支付（伴有通知）。
• 数据持久化： 物品列表、所有权、收益等随世界保存，服务器重启后依然存在。
• 保护机制： 只有主人可以破坏售货机；破坏时，所有上架物品掉落。
• 实时同步： 所有界面在多人游戏中会自动刷新。

🧾 收银机

• 放置与绑定： 放置方块的玩家自动成为主人。
• 转账功能： 任何其他玩家右击打开转账界面，输入金额并确认 - 硬币会立即转入主人账户（无需手动领取）。
• 主人提示： 主人右击仅显示一条信息，不打开转账界面。
• 保护机制： 只有主人可以破坏方块。

💰 经济系统

• 赤城币： 虚拟货币，通过指令管理。
• 指令（均以 /chicheng 为前缀）：
  • balance – 查询你的余额。
  • give <玩家> <数量> – 给予玩家赤城币（仅 OP）。
  • take <玩家> <数量> – 移除玩家的赤城币（仅 OP）。
  • set <玩家> <数量> – 设置玩家的余额（仅 OP）。
  • transfer <目标玩家> <数量> – 向其他玩家转账。
• 余额 HUD： 在右下角显示你当前的余额（可配置）。
• 配置： 修改 config/chichengjingji-common.toml 文件以设置初始余额（默认为 100）。

🎨 界面与交互

• 售货机购买界面： 物品列表（图标、单价、库存）→ 点击物品进入详情页（放大图标）→ 输入购买数量。
• 上架界面： 直观的输入框和按钮。
• 收银机转账界面： 简单的数字输入和确认按钮。
• 所有按钮支持悬停高亮；界面不会暂停游戏。

📦 安装

1. 确保你已安装 NeoForge 1.21.1。
2. 将下载的 chichengjingji-1.0-SNAPSHOT.jar 放入 .minecraft/mods 文件夹。
3. 启动游戏 - 模组会自动生成其配置文件。
4. 多人游戏服务器：将 jar 文件放入服务器的 mods 文件夹。所有客户端也必须安装此模组（否则无法看到界面）。

🕹️ 使用指南

自动售货机

1. 放置售货机（放置者成为主人）。
2. 手持要出售的物品，右击售货机 → 设置单价和数量 → 确认上架。
3. 其他玩家（空手）右击打开购买界面 → 选择物品 → 输入数量 → 购买。
4. 主人可以随时添加新物品并查看收益（收益会自动支付/存储）。

收银机

1. 放置收银机（放置者成为主人）。
2. 其他玩家右击收银机 → 输入转账金额 → 确认 - 硬币会从他们的账户扣除并添加到主人账户。
3. 主人右击仅显示一条信息，无法转账。

经济指令

• 在聊天栏输入 /chicheng help 查看子指令（用法如上所述）。

⚙️ 配置 配置文件路径：config/chichengjingji-common.toml

[common]
starting_balance = 100          # 新玩家的初始余额
showBalanceHUD = true           # 是否显示余额 HUD

🛠️ 开发者信息

• 开发环境： NeoForge 1.21.1
• 语言： Java 21

📄 许可协议 保留所有权利（如需使用请联系作者获取许可）。

🧑‍💻 作者 MCyangguang

🙏 鸣谢