SI: Essentials

🌐 SI: Essentials

由 Soncresity Industries 开发的核心 API、前置库和工具包。

✨ 概述

SI: Essentials 是一款集 API、前置库和工具包于一体的模组。无论你想改进整合包，还是开发自己的模组，它都是不错的选择。

🔧 功能

移除器模块

移除器子模块可让你禁用游戏中的特定物品。你可以通过 ID、组件和正则表达式（regex）来设置。你可以完全禁用某个物品，也可以只禁用特定操作或功能，例如使用该物品攻击或交互，或禁用其合成配方。

日志记录器

SI: Essentials 内置了自定义日志记录器，基于 Minecraft 模组中常用的slf4j日志记录器。通过我们的配置，每个世界都可以生成单独的日志文件，且文件中只包含你的模组输出的内容，帮助你更快地定位代码问题。

我们的日志记录器还提供调试选项，可通过 SI: Essentials 通用配置中的全局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

📖 Wiki 与文档

📚 了解更多内容、指南和完整文档：➡️ SI: Essentials Wiki

🌍 社区与支持

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

🐛 报告错误并申请新功能：➡️ 支持

🔗 链接

🌐 网站 📺 YouTube 📱 社交媒体

❤️ 支持我们

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

🏢 关于 Soncresity Industries

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

🌐 网站 | 💬 Discord

⚠️ 许可证与使用

本项目采用 Soncresity Standard License (SSL) 许可。你可以在此处

查看。🚀 制作人员

• Soncresity Industiries
• SkyKing\_PX
• KalarianAthecila