SI：基础版

🌐 SI: Essentials

由 Soncresity Industries 提供的核心 API、库与工具包。

---

✨ 概述

SI: Essentials 是一个集 API、库和工具包于一体的模组。对于任何希望改进整合包或开发自己模组的人来说，它都是一个绝佳选择。

---

🔧 功能

移除器模块

移除器子模块允许你禁用游戏中的特定物品。你可以通过 ID、组件和正则表达式（regex）来实现。你可以完全禁用该物品，或者仅禁用特定的操作/功能，例如与该物品的交互、攻击或其配方。

日志器

SI: Essentials 自带一个自定义日志器，它基于 Minecraft 模组中常用的 slf4j 日志器。通过我们的设置，我们可以为每个世界创建单独的日志文件，其中仅包含你的模组的输出。这可以让你更快地发现代码中的问题。

我们的日志器还带有一个调试选项，该选项由 SI: Essentials 通用配置（Common Config）中的全局 debug_enabled 值控制。虽然调试输出仅在 Minecraft 日志中根据该值显示，但调试输出将始终记录到你上面提到的自定义日志文件中。

配置 API

我们的配置 API 允许你（作为开发者）在你的项目中创建多个配置，并访问和设置配置键和值。目前，你可以选择 cnfg 或 objt 文件类型。

命令工具

命令工具类允许你以玩家的身份执行命令，同时能够自定义权限、位置和旋转。

小数工具

小数工具类允许你将一个小数值四舍五入到逗号后指定位数的小数点后几位。

文件哈希工具

文件哈希工具类允许你以字符串形式获取文件的 SHA256 文件哈希/校验和。

物品工具

物品工具类允许你从字符串解析物品和物品堆栈，反之亦然。

消息工具

消息工具类允许你使用 Adventure/MiniMessage API（在聊天或操作栏中）发送（私人和广播）消息。

注册工具

注册工具类通过提供有用的辅助方法，使注册物品和方块的过程更加容易。

单人游戏工具

单人游戏工具类允许检查 ServerPlayer 是否是单人世界的主机。当你的模组包含封禁玩家功能，但你不想封禁世界主机时（因为否则他们的世界将无法正常保存，其他玩家也会被踢出），这可能很有用。

槽位工具

槽位工具类允许你获取大型箱子 GUI 中槽位的 x 和 y 位置。这对于我们的槽位预设很有用。

声音工具

声音工具类允许你将声音 ID 解析为 SoundEvent，然后你可以使用它在本地为单个玩家播放声音或进行广播。

标题工具

标题工具类允许你使用 Adventure/MiniMessage API 向玩家显示和广播完全可自定义的标题。

---

📦 需求

• Minecraft 1.21.1、1.21.4、1.21.8、1.21.10 或 1.21.11
• SI: Essentials
• NeoForge 或 Fabric

---

📖 维基与文档

📚 了解更多信息、指南和完整文档：➡️ SI: Essentials 维基

---

🌍 社区与支持

💬 加入我们的社区并获得帮助：➡️ Discord

🐛 报告错误与请求功能：➡️ 支持

---

🔗 链接

🌐 网站 📺 YouTube 📱 社交平台

---

❤️ 支持我们

如果你喜欢这个项目，请考虑支持我们：➡️ Patreon

---

🏢 关于 Soncresity Industries

本项目由 Soncresity Industries 开发，这是一个专注于创造高质量 Minecraft 体验、工具和系统的团队。

🌐 网站 | 💬 Discord

---

⚠️ 许可与使用

本项目根据 Soncresity 标准许可 (SSL) 授权。你可以在此查看。

---

🚀 致谢

• Soncresity Industries
• SkyKing_PX
• KalarianAthecila