如何在Minecraft插件中实现玩家分级跑酷进度的数据存储？

最适合你的方案：YAML文件存储 #

你的需求里数据结构非常简单——就是玩家对应已解锁的最高跑酷等级，YAML完全够用，而且Minecraft插件生态对YAML支持得很好，不需要额外依赖，上手也快。

1. 先定好YAML的数据结构 #

用玩家的UUID当键（别用玩家名，不然玩家改名数据就乱了），值存已解锁的最高等级，示例如下：

players:
  "123e4567-e89b-12d3-a456-426614174000": 1  # 只解锁了跑酷1
  "987e6543-e21b-43c2-d109-876543210987": 3  # 全解锁

2. 核心代码实现（以Bukkit/Spigot为例） #

读取玩家的解锁进度

public int getPlayerMaxUnlocked(Player player) {
    File progressFile = new File(getDataFolder(), "player_progress.yml");
    YamlConfiguration config = YamlConfiguration.loadConfiguration(progressFile);
    // 默认返回0，代表还没解锁任何跑酷
    return config.getInt("players." + player.getUniqueId().toString(), 0);
}

更新玩家的进度

比如玩家完成跑酷1后，把他的等级更改为1：

public void updatePlayerProgress(Player player, int newLevel) {
    File progressFile = new File(getDataFolder(), "player_progress.yml");
    YamlConfiguration config = YamlConfiguration.loadConfiguration(progressFile);
    config.set("players." + player.getUniqueId().toString(), newLevel);
    try {
        config.save(progressFile);
    } catch (IOException e) {
        getLogger().severe("保存玩家进度出错：" + e.getMessage());
    }
}

权限控制逻辑

玩家尝试进入某个跑酷关卡时，检查他的解锁等级：

public boolean canEnterParkour(Player player, int targetLevel) {
    int unlocked = getPlayerMaxUnlocked(player);
    // 比如要进跑酷2，必须完成跑酷1（也就是已解锁等级≥1）
    return unlocked >= targetLevel - 1;
}

备选方案：嵌入式数据库（SQLite/H2） #

如果之后你想加更多功能，比如记录跑酷完成时间、做排行榜，那可以用嵌入式数据库，不用单独装数据库服务，直接嵌入插件里就行。

1. 先建表 #

CREATE TABLE IF NOT EXISTS parkour_progress (
    player_uuid VARCHAR(36) PRIMARY KEY,
    max_unlocked INT NOT NULL DEFAULT 0
);

2. 核心操作示例（JDBC） #

查询进度

public int getPlayerUnlocked(UUID uuid) {
    String query = "SELECT max_unlocked FROM parkour_progress WHERE player_uuid = ?";
    try (Connection conn = getDbConnection();
         PreparedStatement stmt = conn.prepareStatement(query)) {
        stmt.setString(1, uuid.toString());
        ResultSet rs = stmt.executeQuery();
        return rs.next() ? rs.getInt("max_unlocked") : 0;
    } catch (SQLException e) {
        getLogger().severe("查进度失败：" + e.getMessage());
        return 0;
    }
}

更新进度

public void updateProgress(UUID uuid, int newLevel) {
    String query = "INSERT OR REPLACE INTO parkour_progress (player_uuid, max_unlocked) VALUES (?, ?)";
    try (Connection conn = getDbConnection();
         PreparedStatement stmt = conn.prepareStatement(query)) {
        stmt.setString(1, uuid.toString());
        stmt.setInt(2, newLevel);
        stmt.executeUpdate();
    } catch (SQLException e) {
        getLogger().severe("更改进度失败：" + e.getMessage());
    }
}

几个关键注意点 #

• 一定要用UUID存玩家数据，别用玩家名，不然玩家改名后数据就找不到了，这是Minecraft插件的标准操作。
• YAML文件读写要注意线程安全，如果插件有异步任务，记得加锁，不然可能把文件搞坏。
• 用数据库的话，连接一定要及时关，用try-with-resources自动管理就行，别漏了。
• 插件启动的时候，要检查YAML文件或者数据库表有没有，没有就创建一个，不然第一次用会报错。

内容的提问来源于stack exchange，提问作者professorchemist