Chunklock - 区块进度系统

Chunklock 通过“区块解锁”机制彻底革新 Minecraft 生存玩法，让玩家不再能无限探索，而是需要通过资源投入、团队协作与策略规划，一块一块地解锁领土。

💡什么是 Chunklock？

• Chunklock 为生存服引入了战略性的区块进度系统。
• 玩家从一个可用区块开始，之后每个区块都必须通过资源解锁。
• 解锁成本会根据生物群系、距离与难度动态变化。
• 支持团队共享进度，让多人协作更有意义。

⭐核心概念

• 玩家在指定世界中从 1 个已解锁区块开始。
• 每个区块都需要投入资源才能获得。
• 进度推进需要策略规划，而不是盲目扩张。
• 团队合作可以共享进度。
• 成本会根据生物群系、距离和难度动态调整。

✨主要功能

AI 驱动的智能系统

• OpenAI Integration - 可选的 AI 动态成本计算。
• Smart Pricing - 成本会根据玩家行为和服务器经济自适应。
• Configurable AI - 可控制 AI 行为、缓存与安全边界。
• Cost-Effective - 使用 GPT-4o-mini，兼顾成本与效果。

⚔️ 高级团队系统

• Team creation & management - 支持创建带自定义设置的队伍。
• Officer permissions - 可将成员提升为具有管理权限的军官。
• Join request system - 新成员加入需要审批流程。
• Team chat - 专属团队聊天频道。
• Shared progression - 在同一世界中协作推进。
• Cost sharing - 团队折扣与共享解锁。

视觉增强

• Interactive GUI - 右键打开解锁界面。
• Glass borders - 使用玻璃边框显示区块边界，并带有团队颜色。
• Holographic previews - 解锁前即可查看成本。
• FancyHolograms integration - 支持更强的全息显示效果。
• Team-colored indicators - 团队标识更清晰。
• Real-time updates - GUI 与 holograms 会即时更新。

Smart Progression System

• Biome-aware unlocking - 不同生物群系对应不同成本。
• Custom item requirements - 可在解锁中使用 Oraxen/MMOItems 物品。
• Distance-based scaling - 随距离增加而逐步提高难度。
• Resource scanning - 成本可依据区块内容计算。
• Dynamic pricing - 每个种子都有不同体验。
• Dual economy - 支持材料或 Vault 货币。

多语言与自定义

• Complete language system - 200+ 条可自定义消息。
• Multiple languages - 便于翻译与本地化。
• Modular configuration - 10+ 个专注的配置文件。
• Easy customization - 配置结构清晰，便于修改。
• Live reload - 无需重启服务器即可生效。

⚡ 性能与兼容性

• Queue-based processing - 队列式处理，减少卡顿。
• Memory optimization - 可支持数百名玩家。
• MapDB storage - 快速高效的数据存储。
• Cross-server compatibility - 支持 Paper、Spigot、Pufferfish。
• Minecraft 1.21.10+ - 支持最新版本。
• Async operations - 异步区块操作，不阻塞主线程。

🎮工作方式

开始你的旅程

• 管理员使用 /chunklock setup <diameter> 创建世界。
• 加入服务器后使用 /chunklock start。
• 系统会分配你的起始区块（16x16 blocks）。
• 从 1 个已解锁区块开始，作为安全区。
• 从起始区域采集资源。
• 规划你的扩张策略。

进度机制

• 右键边界可打开解锁 GUI。
• 只能解锁相邻区块。
• 成本会根据生物群系、距离、难度和进度动态变化。
• 支持使用材料（原版或自定义物品）或 Vault 经济支付。
• 可选 OpenAI 集成，用于智能成本计算。
• 扩张方向需要谨慎选择。

团队协作

• 使用 /chunklock team create 创建或加入团队。
• 使用 /chunklock team invite 邀请好友。
• 一起制定扩张策略。
• 在共享领土中共同建造。
• 共享资源并协调解锁。
• 享受团队成本减免。

🔧管理功能

管理员命令

• /chunklock setup <diameter> - 创建并配置 Chunklock 世界
• /chunklock reload - 实时重载全部配置
• /chunklock reset <player> - 重置玩家进度
• /chunklock bypass [player] - 切换绕过模式
• /chunklock unlock <player> - 强制解锁区块
• /chunklock apikey <key> - 设置 OpenAI API key
• /chunklock aidebug - 测试 AI 集成
• /chunklock debug - 性能监控
• /chunklock status [player] - 查看进度信息
• /chunklock team <args> - 完整团队管理

配置系统

• Modular config system - 10+ 个专注的配置文件。
• Easy to manage - 经济、团队、边界等内容分文件管理。
• Economy configuration - 支持材料或 Vault 集成。
• OpenAI settings - 可配置 AI 驱动的成本计算。
• Team settings - 队伍大小限制、权限与聊天。
• Visual effects - 边框、holograms 与性能调优。
• Language files - 自定义全部消息内容。
• Live reload support - 无需重启服务器。

⭐安装说明

需求

• Minecraft 1.21.10+ - 推荐使用最新 Paper。
• Java 17+ - 需要现代 Java 版本。
• 2GB+ RAM - 大型服务器建议 4GB+。
• FancyHolograms - 可选，用于增强视觉效果。
• Vault + Economy Plugin - 可选，用于金钱支付。
• Oraxen/MMOItems - 可选，用于自定义物品解锁。

设置步骤

• 从 releases 下载 Chunklock.jar。
• 放入 /plugins 文件夹。
• 启动服务器（配置会自动生成）。
• 运行 /chunklock setup 30000 创建世界。
• 在 plugins/Chunklock/ 中配置设置（模块化配置）。
• 可选：使用 /chunklock apikey <key> 设置 OpenAI API key。
• 完成！玩家现在可以使用 /chunklock start。

✨适合的服务器类型

• 大型多人服务器 - 适合团队式进度玩法。
• 团队协作服务器 - 强调合作功能。
• 硬核 RPG 服务器 - 提供策略型生存体验。
• 朋友私服 - 带来团队进度挑战。
• 公共服务器 - 独特的策略玩法。
• 竞技服务器 - 团队对抗式推进。
• 自定义物品服务器 - 支持 Oraxen/MMOItems 集成。
• 多语言服务器 - 提供完整翻译支持。

💡为什么选择 Chunklock？

• 与传统领地插件或世界边界不同，Chunklock 带来完全独特的生存体验。
• AI-Powered - 支持 OpenAI 动态定价。
• Strategic progression system - 每一次区块扩张都很重要。
• Team collaboration - 与队友一起扩张领土。
• Custom items support - 集成 Oraxen 和 MMOItems。
• Multi-language - 完整翻译支持。
• ⚡ Performance optimized - 可处理数百名同时在线玩家。
• ⚙️ Highly configurable - 模块化配置，易于自定义。
• Well-documented - 提供完整 wiki 与指南。
• Active development - 持续更新并增加新功能。
• ⚖️ Balanced gameplay - 为所有玩家提供公平进度。
• Modern features - 支持最新 Minecraft 版本（1.21.10+）。

🎮独特之处

• Custom items in biome unlock requirements（Oraxen）
• 200+ 条可自定义消息的完整语言系统
• Modular configuration - 10+ 个专注的配置文件
• Interactive GUI - 右键解锁区块
• Smart cost calculation - 支持 AI 或传统公式计算

❓支持与社区

获取帮助

• Discord Community : 加入我们的 Discord
• GitHub Issues : 提交 Bug 和功能请求
• Complete Documentation : 内含完整 wiki
• Active Development : 持续更新与新增功能

Chunklock v2.1.0 现已可用！

立即为你的服务器带来一个玩家难忘的策略型进度系统。

现在下载，体验 Minecraft 进度系统的未来！

以下内容是 Chunklock 的配置说明，已整理为更清晰的简体中文版本，方便在插件目录页面快速浏览各项功能与参数。

⭐区块数值（`chunk-values`）

用于把区块中的得分映射到难度，并定义不同生物群系与方块对区块分数的影响。

阈值

• easy: 25：更容易进阶的较低阈值。
• normal: 50
• hard: 80

生物群系权重

• PLAINS: 5
• FOREST: 8
• DESERT: 10
• JUNGLE: 20
• WINDSWEPT_HILLS: 12
• OCEAN: 15
• SWAMP: 11
• BADLANDS: 16
• SAVANNA: 9
• TAIGA: 10
• SNOWY_PLAINS: 14
• DEEP_OCEAN: 18

方块分数

• OAK_LOG: 6
• BIRCH_LOG: 6
• SPRUCE_LOG: 7
• ACACIA_LOG: 7
• DARK_OAK_LOG: 7
• JUNGLE_LOG: 8
• WHEAT: 4
• CARROTS: 4
• POTATOES: 4
• BEETROOTS: 3
• WATER: 2
• COAL_ORE: 5
• IRON_ORE: 10
• COPPER_ORE: 7
• GOLD_ORE: 15
• REDSTONE_ORE: 12
• LAPIS_ORE: 12
• DIAMOND_ORE: 25
• EMERALD_ORE: 30
• STONE: 1
• DIRT: 1
• GRASS_BLOCK: 1

✨生物群系解锁配置（`biome-unlocks`）

这是 Chunklock 的完整生物群系成本配置。每一项都以 material: amount 的形式填写，整体按进度玩法平衡，前期生物群系更便宜，稀有生物群系更昂贵。

基础主世界生物群系

• PLAINS：
• WHEAT: 8
• HAY_BLOCK: 2
• FOREST：
• OAK_LOG: 16
• APPLE: 4
• BIRCH_FOREST：
• BIRCH_LOG: 16
• MUSHROOM_STEW: 4
• DARK_FOREST：
• DARK_OAK_LOG: 16
• DARK_OAK_SAPLING: 4
• OLD_GROWTH_BIRCH_FOREST：
• BIRCH_LOG: 24
• GOLDEN_APPLE: 1
• OLD_GROWTH_PINE_TAIGA：
• SPRUCE_LOG: 24
• MOSSY_COBBLESTONE: 16
• OLD_GROWTH_SPRUCE_TAIGA：
• SPRUCE_LOG: 32
• PODZOL: 16

山地生物群系

• WINDSWEPT_HILLS：
• STONE: 40
• EMERALD: 1
• WINDSWEPT_FOREST：
• OAK_LOG: 20
• STONE: 24
• WINDSWEPT_GRAVELLY_HILLS：
• GRAVEL: 48
• FLINT: 8
• MEADOW：
• TALL_GRASS: 32
• DANDELION: 16
• POPPY: 8
• GROVE：
• SPRUCE_LOG: 20
• SNOW_BLOCK: 16
• SNOWY_SLOPES：
• SNOW_BLOCK: 32
• ICE: 12
• JAGGED_PEAKS：
• STONE: 64
• DIAMOND: 2
• FROZEN_PEAKS：
• PACKED_ICE: 24
• DIAMOND: 1
• STONY_PEAKS：
• STONE: 48
• COAL: 16

寒冷生物群系

• TAIGA：
• SPRUCE_LOG: 16
• SWEET_BERRIES: 8
• SNOWY_TAIGA：
• SPRUCE_LOG: 20
• SNOW_BLOCK: 16
• SNOWY_PLAINS：
• SNOWBALL: 20
• ICE: 8
• ICE_SPIKES：
• PACKED_ICE: 32
• BLUE_ICE: 4
• FROZEN_RIVER：
• ICE: 24
• COD: 8
• FROZEN_OCEAN：
• ICE: 40
• KELP: 16
• DEEP_FROZEN_OCEAN：
• PACKED_ICE: 32
• SALMON: 12

温带生物群系

• FLOWER_FOREST：
• OAK_LOG: 12
• ROSE_BUSH: 8
• PEONY: 4
• RIVER：
• CLAY_BALL: 16
• COD: 8
• BEACH：
• SAND: 20
• SEAGRASS: 12
• STONY_SHORE：
• STONE: 32
• GRAVEL: 24

温暖 / 干燥生物群系

• DESERT：
• SAND: 32
• CACTUS: 6
• SAVANNA：
• ACACIA_LOG: 16
• TALL_GRASS: 20
• SAVANNA_PLATEAU：
• ACACIA_LOG: 24
• COARSE_DIRT: 16
• WINDSWEPT_SAVANNA：
• ACACIA_LOG: 20
• STONE: 20
• BADLANDS：
• RED_SAND: 32
• TERRACOTTA: 16
• WOODED_BADLANDS：
• RED_SAND: 24
• OAK_LOG: 16
• TERRACOTTA: 12
• ERODED_BADLANDS：
• RED_SAND: 40
• RED_TERRACOTTA: 20

茂密生物群系

• JUNGLE：
• COCOA_BEANS: 16
• MELON_SLICE: 8
• SPARSE_JUNGLE：
• JUNGLE_LOG: 12
• COCOA_BEANS: 8
• BAMBOO_JUNGLE：
• BAMBOO: 32
• JUNGLE_LOG: 8
• SWAMP：
• SLIME_BALL: 4
• VINE: 16
• MANGROVE_SWAMP：
• MANGROVE_LOG: 20
• MUD: 16
• SLIME_BALL: 6
• LUSH_CAVES：
• MOSS_BLOCK: 24
• GLOW_BERRIES: 12

海洋生物群系

• OCEAN：
• KELP: 32
• COD: 6
• DEEP_OCEAN：
• KELP: 40
• SALMON: 8
• LUKEWARM_OCEAN：
• TROPICAL_FISH: 12
• SEAGRASS: 16
• DEEP_LUKEWARM_OCEAN：
• TROPICAL_FISH: 16
• KELP: 24
• WARM_OCEAN：
• BRAIN_CORAL: 16
• TROPICAL_FISH: 8
• COLD_OCEAN：
• KELP: 36
• COD: 10
• DEEP_COLD_OCEAN：
• KELP: 44
• COD: 12

稀有 / 特殊生物群系

• MUSHROOM_FIELDS：
• RED_MUSHROOM: 16
• BROWN_MUSHROOM: 16
• DRIPSTONE_CAVES：
• POINTED_DRIPSTONE: 24
• COPPER_INGOT: 8
• DEEP_DARK：
• SCULK: 32
• ECHO_SHARD: 4
• EXPERIENCE_BOTTLE: 8
• CHERRY_GROVE：
• CHERRY_LOG: 20
• PINK_PETALS: 12

下界生物群系

• NETHER_WASTES：
• NETHERRACK: 64
• NETHER_WART: 16
• CRIMSON_FOREST：
• CRIMSON_STEM: 24
• CRIMSON_FUNGUS: 8
• WARPED_FOREST：
• WARPED_STEM: 24
• WARPED_FUNGUS: 8
• SOUL_SAND_VALLEY：
• SOUL_SAND: 32
• SOUL_SOIL: 24
• GHAST_TEAR: 2
• BASALT_DELTAS：
• BASALT: 48
• BLACKSTONE: 24
• MAGMA_CREAM: 8

末地生物群系

• THE_END：
• END_STONE: 64
• ENDER_PEARL: 8
• SMALL_END_ISLANDS：
• END_STONE: 48
• CHORUS_FRUIT: 12
• END_MIDLANDS：
• END_STONE: 56
• SHULKER_SHELL: 2
• END_HIGHLANDS：
• END_STONE: 72
• CHORUS_FRUIT: 16
• END_BARRENS：
• END_STONE: 40
• PURPUR_BLOCK: 8

🎮队伍设置（`team-settings`）

用于配置 Chunklock 的队伍系统。

通用设置

• max-team-size: 6：每个队伍的最大成员数。
• max-teams-per-server: 100：服务器范围内的队伍上限。
• allow-solo-teams: true：允许单人队伍。
• join-request-ttl-hours: 72：加入请求在 X 小时后自动过期。

成本缩放

• team-cost-multiplier: 0.15：每增加一名队伍成员，额外成本增加 15%。
• base-team-cost: 1.0：队伍基础倍率，1.0 表示不改变。
• max-cost-multiplier: 3.0：总成本倍率上限。
• contested-cost-multiplier: 3.0：争夺敌方区块时的成本倍率。
• max-contested-claims-per-day: 5：每个队伍每天可进行的争夺占领次数上限。

队伍功能

• enable-team-chat: true：启用队伍聊天功能。
• enable-leaderboards: true：显示队伍排行榜（未来功能）。

💡玻璃边框系统（`glass-borders`）

用于在玩家周围显示区块边界的玻璃效果。

视觉设置

• enabled: true：启用或禁用玻璃边框系统。
• use-full-height: true：使用完整世界高度（从基岩到最高高度）。
• border-height: 3：边框高度为多少格，仅在 use-full-height 为 false 时生效。
• min-y-offset: -2：基准 Y 轴以下的方块数，仅在 use-full-height 为 false 时生效。
• max-y-offset: 4：基准 Y 轴以上的方块数，仅在 use-full-height 为 false 时生效。

性能设置

• scan-range: 8：扫描玩家周围多少个区块以显示边框。
• update-delay: 20：边框更新前等待的 tick 数（1 秒 = 20 tick）。
• update-cooldown: 2000：每位玩家两次边框更新之间的毫秒间隔，用于提升响应速度。

行为设置

• show-for-bypass-players: false：绕过玩家是否也显示边框。
• auto-update-on-movement: true：玩家切换区块时自动更新边框。
• restore-original-blocks: true：移除边框时恢复原始方块。
• debug-logging: true：启用边框系统调试日志。

方块设置

• border-material: LIGHT_GRAY_STAINED_GLASS：边框使用的方块材质。

🔧性能（`performance`）

与边框更新相关的额外性能参数。

• border-update-delay: 2
• max-border-updates-per-tick: 10

❓世界设置（`worlds`）

用于控制插件在哪些世界中启用，以及世界切换时的自动分配行为。

启用的世界

• enabled-worlds：
• world
• world_nether
• world_the_end

世界切换行为

• auto-assign-on-world-change: true：玩家切换世界时自动分配。