Core Modules

核心模块

模块概述

核心模块位于 src/ 目录，提供插件的基础功能支持。

模块列表

模块	说明
core/ConfigManager	配置文件管理器
core/LitematicLoader	原理图文件加载器
core/NBT	NBT 数据格式解析器
core/BlockIdMap	方块 ID 映射表
render/ProjectionRenderer	投影渲染器
ui/UIManager	UI 管理器
easyplace/EasyPlaceManager	轻松放置管理器

配置管理 (ConfigManager)

配置文件位置：plugins/LitematicaBE/config.json

配置结构

配置节	说明
render	渲染配置
particleRespawn	粒子重生配置
easyPlace	轻松放置配置
layerSwitch	逐层切换配置
nearbyPrompt	附近投影提示配置
logCleaner	日志清理配置
gui	GUI 界面配置
projection	投影默认值配置
performance	性能配置

渲染配置

{
  "render": {
    "opacity": 0.6,
    "showBorder": true,
    "borderColor": "§a"
  }
}

原理图加载器 (LitematicLoader)

支持的格式

.litematic - Java 版 Litematica 导出的格式

JSON 格式示例

{
    "Metadata": {
        "Name": "My Structure",
        "Author": "PlayerName"
    },
    "Region": {
        "LiteTickets": [
            {
                "Blocks": [
                    {"pos": [0, 0, 0], "id": 1, "data": 0}
                ]
            }
        ]
    },
    "Entities": []
}

渲染系统 (ProjectionRenderer)

渲染方案

使用粒子系统显示投影内容：

• 每个方块显示 1 个粒子 ）

粒子重生

• 粒子生命周期：45 秒
• 38 秒时自动重生
• 确保投影持续显示

UI 管理器 (UIManager)

界面列表

界面	方法	功能
主菜单	showMainMenu()	显示主菜单
加载投影	showSchematicBrowser()	加载原理图
投影管理	showMyProjections()	管理投影列表
模式选择	showModeSelector()	选择操作模式
轻松放置	toggleEasyPlace()	切换轻松放置

轻松放置 (EasyPlaceManager)

功能

• 自动选中正确方块
• 潜影盒物品提取
• 方块状态匹配
• 错误操作阻止

配置

{
  "easyPlace": {
    "enabled": true,
    "autoSelect": true,
    "shulkerBoxSearch": true,
    "blockStateMatch": true
  }
}