SDM Ore Stages

SDM Ore Stages

SDM Ore Stages 是对经典模组 Ore Stages 的现代化重制版本，
适配Minecraft 新版本（1.21 及更高版本），并全面集成到 SDM Stages 生态系统中。

该模组允许你逐步限制方块的访问权限——隐藏、替换方块，或使其无法访问，
直到玩家达到所需的进度阶段。

主要特性

• 通过 SDM Stages 实现逐步推进系统——不再需要 GameStages。
• 隐藏和替换方块：例如，在解锁阶段前，可以将 diamond_ore 替换为 stone。
• 支持 CraftTweaker 和 KubeJS，可灵活配置。
• 全面支持 BlockState——可以设置状态（如 snowy=false、axis=y 等）。

运行要求

• SDM Stages
• CraftTweaker 或 KubeJS

⚠️ 仅支持 Minecraft 1.21 及更高版本。
不支持旧版本（1.20.x 及以下），这些版本无法运行。（也许以后会移植。）

工作原理？

如果玩家**没有所需阶段**：

• 方块会显示为替代方块（例如，用 stone 代替 diamond_ore）。
• 玩家无法与其互动（PCM、破坏、激活）。
• 方块被破坏时，会掉落替代方块的物品。
• 挖掘速度与替代方块相同。
• 如果方块在没有玩家参与的情况下被破坏（爆炸、液体、矿车），则会使用“默认行为”。

示例：KubeJS

// server_scripts/example.js

// Replaces the grass with an oak log until the "one" stage is opened
OreStages.addOreStageBlockReplaced("one", "minecraft:grass_block", "minecraft:oak_log");

// Replaces iron ore with stone until the "two" stage is opened
OreStages.addOreStageBlockReplaced("two", "minecraft:iron_ore", "minecraft:stone");

// Hides diamond ore up to the "three" stage
OreStages.addOreStageBlockState("three", "minecraft:diamond_ore");

/*
OreStages.addOreStageBlock(stage as String, hidden as Block);            // By default, stone or deep slate is used.        
OreStages.addOreStageBlockState(stage as String, hidden as BlockState);  // By default, stone or deep slate is used.       

OreStages.addOreStageBlockReplaced(stage as String, hidden as Block, replaced as Block);
OreStages.addOreStageBlockStateReplaced(stage as String, hidden as BlockState, replaced as BlockState);
*/

示例：CraftTweaker

import mods.orestages.OreStages;

// Replaces the grass with an oak log until the "one" stage is opened
OreStages.addOreStage("one", <blockstate:minecraft:grass_block:snowy=false>, <blockstate:minecraft:oak_log:axis=y>);

// Replaces iron ore with stone until the "two" stage is opened
OreStages.addOreStage("two", <block:minecraft:iron_ore>, <block:minecraft:stone>);

// Hides diamond ore up to the "three" stage
OreStages.addOreStage("three", <block:minecraft:diamond_ore>);

/*
OreStages.addOreStage(stage as string, hidden as Block);          // By default, stone or deep slate is used.        
OreStages.addOreStage(stage as string, hidden as BlockState);     // By default, stone or deep slate is used.    

OreStages.addOreStage(stage as string, hidden as Block, replaced as Block);
OreStages.addOreStage(stage as string, hidden as BlockState, replaced as BlockState);
*/

集成

给整合包作者的说明

这款模组非常适合：

• 带有渐进式矿石与资源探索的 RPG/任务整合包。
• 帮助新玩家循序渐进地学习机制的教育类整合包。
• 需要平衡进度或科技树的服务器。

原项目

本项目基于原模组 Ore Stages
（作者：Darkhax），并针对 Minecraft 的现代版本进行了彻底的重写与更新，
集成了 SDM API，性能也有所提升。