安装与快速上手

安装步骤

将 Malkuth.jar 放入服务器的 plugins/ 目录
启动服务器，插件会自动生成默认配置文件
关闭服务器，编辑 plugins/Malkuth/config.yml 配置数据库连接
重新启动服务器，插件即可正常使用

目录结构

首次启动后，插件会在 plugins/Malkuth/ 下生成以下文件：

plugins/Malkuth/
├── config.yml              # 主配置（数据库/Redis）
├── currency.yml            # 货币定义文件
├── autosell_chest.yml      # 自动售卖箱独立配置（默认关闭）
├── lang/
│   ├── en_US.yml           # 英文语言文件
│   └── zh_CN.yml           # 中文语言文件
├── shop/                   # 商店配置
│   ├── auction.yml
│   ├── building_shop.yml
│   ├── cron_example.yml
│   ├── decompose_advanced.yml
│   ├── decompose_example.yml
│   ├── def.yml
│   ├── equipment_shop.yml
│   ├── example_external_inventory.yml
│   ├── example_recycle_external.yml
│   ├── farming_shop.yml
│   ├── global_market.yml
│   ├── item_trade_example.yml
│   ├── limit_event.yml
│   ├── limit_shop.yml
│   ├── normal_full.yml
│   ├── player_shop.yml
│   ├── player_shop_full.yml
│   ├── potion_shop.yml
│   ├── premium_shop.yml
│   ├── recycle_advanced.yml
│   ├── recycle_example.yml
│   ├── recycle_full.yml
│   ├── recycle_shop.yml
│   ├── random_daily.yml
│   ├── random_weekly_cron.yml
│   ├── redstone_shop.yml
│   ├── schedule_example.yml
│   └── survival_shop.yml
├── goods/                  # 商品配置
│   ├── armor.yml
│   ├── attr.yml
│   ├── blocks.yml
│   ├── consumables.yml
│   ├── decoration.yml
│   ├── def1.yml
│   ├── farming.yml
│   ├── food.yml
│   ├── materials.yml
│   ├── services.yml
│   ├── tools.yml
│   ├── weapons.yml
│   └── special.yml
├── recycle/                # 回收规则
│   ├── custom_fishing.yml
│   ├── equipment.yml
│   ├── example.yml
│   ├── recycle1.yml
│   ├── decompose_example.yml
│   └── recycle_full.yml
└── ui/                     # 界面配置
    ├── auction_item.yml
    ├── auction_my_bids.yml
    ├── auction_upload.yml
    ├── autosell_chest_upgrade.yml
    ├── browse_player_shops.yml
    ├── cart.yml
    ├── confirm.yml
    ├── confirm_global_market.yml
    ├── confirm_player_shop.yml
    ├── edit_goods.yml
    ├── favorite.yml
    ├── global_market_compare.yml
    ├── global_market_detail.yml
    ├── global_market_item.yml
    ├── global_market_sort.yml
    ├── group_buy_detail.yml
    ├── group_buy_list.yml
    ├── group_buy_record.yml
    ├── mailbox.yml
    ├── order.yml
    ├── price_compare.yml
    ├── player_shop_item.yml
    ├── search.yml
    ├── transaction.yml
    ├── upload_global_market.yml
    ├── upload_shop.yml

ui/ 目录当前共 26 个模板文件；其中 group_buy_* 与 autosell_chest_upgrade.yml 会随默认资源一起释放，当前更适合作为 1.18.0 附带的模板资源参考。

创建第一个商店

插件自带了多个示例商店配置，你可以直接使用或在此基础上修改。最快的方式：

复制 shop/def.yml 并重命名，例如 shop/my_shop.yml
编辑文件，修改以下关键字段：
- mode — 商店模式（常用：normal、player、limit_time / limit-time、recycle、recycle_shop / recycle-shop、auction、global_market / global-market、decompose；其中 recycle_shop 仍要求保留 currency）
- title — 商店标题，显示在 GUI 顶部
- goods — 引用 goods/ 目录中定义的商品
- layout — 字符布局，控制界面中每个槽位的功能
保存文件后，使用命令测试：
```
/malshop open my_shop
```

文件热重载

config.yml 中默认启用了 file.enable_listen: true。当前源码会监听并热重载 goods/、shop/、recycle/、ui/、currency.yml 与 autosell_chest.yml。/malkuth reload 会一起重载 config.yml、currency.yml、autosell_chest.yml、goods/、shop/、ui/、recycle/ 与语言文件，并清空随机结果、购物车、回收统计缓存；大量改动时仍建议重启服务端确认状态一致。

安装步骤​

目录结构​

创建第一个商店​

安装步骤

目录结构

创建第一个商店