Minecraft 层 API

基本信息

MineTweakerMC 是 MC 类型与 API 类型之间的转换枢纽，没有 @ZenClass，属 Java 侧工具类（api/minecraft/MineTweakerMC.java）。

核心脚本类型

IPlayer 与 IServer 的脚本方法数由 grep -cE '^\s*@ZenMethod|^\s*@ZenGetter' 统计（IPlayer.java → 16，IServer.java → 6）。1.7.10 实现为 MCPlayer（mc1710/player/MCPlayer.java）、MCServer（mc1710/server/MCServer.java），另有 RconPlayer 与 CommandBlockPlayer 两个命令发送者包装（mc1710/player/）。

ILoadedMods 不靠方法而靠运算符暴露（api/mods/ILoadedMods.java:9-18）：

@ZenClass("minetweaker.mods.ILoadedMods")
@IterableSimple("minetweaker.mods.IMod")
public interface ILoadedMods extends Iterable<IMod> {
    @ZenOperator(OperatorType.CONTAINS)
    boolean contains(String name);

    @ZenOperator(OperatorType.INDEXGET)
    IMod get(String name);
}

即脚本里可写 "IC2" in loadedMods 与 loadedMods["IC2"]，并可 for 遍历。注意元素类型 IMod 没有 @ZenClass（见类型系统与扩展），只有 @IterableSimple 里的字符串名。@ModOnly 门控正是靠 contains 实现的（MineTweakerAPI.java:249）。

game —— 游戏元数据

IGame（api/game/IGame.java）10 个脚本方法：

实体掉落实现在同一文件：MCGame.getEntity(name).getDropsToAdd() / getDropsToAddPlayerOnly() / getDropsToRemove() 三个映射驱动 ForgeEventHandler.onLivingDeathDrops（mc1710/ForgeEventHandler.java:73-140）。该处理器在 Forge 的 LivingDropsEvent 上直接增删 ev.drops，不经过 minetweaker.event.PlayerDeathDropsEvent（后者从未被发布，见事件系统）。

setLocalization 的底层是 SetTranslation 动作（MCGame.java:188），注释标为 “Ported from ModTweaker”（MCGame.java:184）。

缺陷：lock() 的 GUI 提示已被注释掉

MCGame.signalLockError() 全文（MCGame.java:166-177）：

public void signalLockError() {
    MineTweakerAPI.getLogger().logError("Reload of scripts blocked (script lock)");

    if (Minecraft.isGuiEnabled()) {
        // Commented out due to unresolved import
        /**
         * Minecraft.getMinecraft().displayGuiScreen( new GuiCannotRemodify( "Minecraft has been tweaked for another
         * server", "with modifications that cannot be rolled back.", "Please restart your game."));
         **/
    }
}

GuiCannotRemodify（mc1710/GuiCannotRemodify.java:12）是本仓唯一的 GuiScreen 子类，构造它的语句是全仓唯一引用，且被注释（grep -rn GuiCannotRemodify 命中 3 处：类声明 1 处 + 注释 2 处）。结论：脚本锁定失败时只写一行日志，玩家看不到任何界面提示。该 GUI 属死代码。

物品与方块的 1.7.10 实现

api/ 另有 4 个方块相关类型 IBlock、IBlockDefinition、IBlockPattern、IBlockGroup，其中 minetweaker.world.IBlockGroup 属世界分组。

交互副作用动作

mc1710/actions/ 下 4 个动作类提供脚本可触发的属性修改，全部实现 IUndoableAction 以便 /mt 重载时回滚：

MCGame 内另有私有 SetTranslation（MCGame.java:188-194）服务于 game.setLocalization，与上述公共动作类并存。

相关条目

• 全局符号 - game / format / server / client / loadedMods 的注册
• 类型系统与扩展 - 12 个未注册接口，含 IEventManager 与 IFormatter
• 事件系统 - 实体掉落走 LivingDropsEvent 而非脚本事件