SL Library

🔹SL Library

 

🧰 核心前置库与实用工具

SL Library 内置了一个前置库，用于支持模组功能，例如同步、事件处理、逻辑执行和客户端渲染实用工具。

---

 

⚙️ 它提供哪些功能？

内置前置库由多个实用模块组成，可处理以下功能：

• 🔄 网络同步（客户端 ↔ 服务端）
• 🎯 用于游戏交互的事件驱动系统
• 🧠 条件逻辑与执行系统
• 📦 文件处理与配置实用工具
• ⚡ 命令注册与处理
• 🎮 输入处理与玩家交互事件
• ✨ 自定义粒子系统（包括文字粒子）
• 🧩 兼容性与模块化执行支持

---

 

🌐 网络系统

包含一套完整的、基于数据包的同步层：

• 在客户端与服务端之间同步自定义数据  
• 处理冷却时间、标签和状态更新  
• 支持粒子与视觉效果同步  

---

 

🎯 事件系统

提供丰富的游戏交互事件：

• 玩家输入与移动  
• 攻击与战斗行为  
• 目标选择系统  
• 客户端渲染与镜头控制  

---

 

🧠 逻辑与执行系统

基于可复用的“语句”构建的灵活逻辑框架：

• 玩家、实体、物品与装备条件  
• 执行链与条件逻辑  
• 声音与动作触发器  

---

 

✨ 粒子系统

包含具备高级功能的自定义粒子引擎：

• 文字粒子  
• 缓冲渲染系统  
• 用于动画与定位的数学处理器  

---

 

🛠️ 实用工具

还包含以下系统：

• 文件读取与路径构建实用工具  
• 配置管理  
• 命令注册系统  
•  异常处理框架  
• 渲染辅助工具与叠加层实用工具  

---

 

🔹SL Data-Driven

扩展数据读取功能，支持从外部文件夹读取资源包和数据包，也支持早期从 Jar 内部读取数据

 

📁 全局数据驱动文件夹

SL Data-Driven 会在你的 `.minecraft` 文件夹中创建两个特殊的全局目录：

.minecraft/data_driven/resourcepacks  
.minecraft/data_driven/datapacks  

---

 

🔍 工作原理

放入这些文件夹中的任何内容，都会像直接内置于游戏或模组中一样运行。

主要优势：

• 内容为全局内容  
• 自动适用于所有地图  
• 无需为每个地图单独安装

---

 

📦 资源包

路径：
.minecraft/data_driven/resourcepacks  

• 存放纹理、模型、动画等资源文件  
• 运行效果类似内置资源包  
• 无需手动启用  

资源包示例：

---

 

📚 数据包

路径：

.minecraft/data_driven/datapacks  

• 存放数据包及数据驱动逻辑  
• 运行方式与标准数据包相同  
• 自动加载到所有地图中  

数据包示例：

---

 

📦 依赖包系统

SL Data-Driven 引入了一套依赖系统，允许其他模组直接在自己的 .jar 文件中使用结构化文件（例如 JSON）自动添加内容。

这样一来，无需修改基础模组，也能轻松创建扩展、兼容层和数据驱动功能。

---

 

🔍 工作原理

该系统完全自动运行：

1. 声明依赖  
你的模组必须在 META-INF 描述文件中依赖 “sl_data_driven”。

2. 文件夹结构  
在你的模组中创建以下路径：

/data_driven/<your_mod_id>/

3. 添加文件  
将希望 SL Data-Driven 处理的文件（JSON、配置文件等）放入该文件夹。

4. 自动加载  
启动时，SL Data-Driven 会：

• 检测所有依赖它的模组  
•  扫描 /data_driven/ 目录  
•  将文件作为扩展加载  

这可以让系统收集并读取文件，但不会添加基础读取机制；所有文件读取功能都必须自行设计。

 

验证是否生效的一种方法是检查你的 modid 是否列在这里。例如，在这个示例中，我将模组（SL Library）添加到了 Data-Driven。

有效时：

 

无效时：

 

---

 

✅ 最低要求

要让你的 .jar 文件被识别为有效模组，必须满足以下条件：

•  必须包含 META-INF 描述文件  
• 必须使用：

modLoader=”lowcodefml”

---

 

🧪 配置示例

modLoader=”lowcodefml”
loaderVersion=”[47,)”
license=”All Rights Reserved”

[[mods]]
modId=”your_modid”
displayName=”Your Mod Name”
version=”1.0″
authors=”you”

[[dependencies.your_modid]]
modId=”sl_data_driven”
mandatory=true
versionRange=”*”
ordering=”AFTER”
side=”BOTH”