Iskandert's Library

模组

· 作者 Unfamily

一个函数库,主要用于 Iskandert 的团队模组

0 本站下载 0 关注 更新于 3 个月前

最新 1.9.0.0.0 · 1.21.1 · NeoForge

一键开服(送7天)

Iskandert's Library — 功能概览

本库包含 Iskandert's Team 各项目间复用的构建模块。它专注于 实用游戏系统(结构、阶段、标记、商店/队伍)和 开发者工具(解析辅助、传输桥接、调试工具)。

使用与许可

本项目采用 MIT 许可证发布。只要保留许可证声明,您可以自由地在项目中使用它(包括修改、重新分发和商业使用)。

包含内容

结构系统(基于 JSON)

用于使用外部 JSON 定义来定义和放置结构的工具:

  • 结构定义:模式、方块键、替换规则,以及如强制/覆盖等选项。
  • 配置扫描与加载:发现结构 JSON 文件并在运行时注册。
  • 放置引擎:在世界中放置结构,具备验证、属性应用及可选行为(例如“以玩家身份放置”、刷新刻)。
  • 撤销历史:轻量级的按玩家划分的放置历史记录,支持撤销操作。

关键包/类:

  • net.unfamily.iskalib.structure.StructureDefinition
  • net.unfamily.iskalib.structure.StructureLoader
  • net.unfamily.iskalib.structure.StructurePlacer
  • net.unfamily.iskalib.structure.StructurePlacementHistory

阶段系统(玩家 / 世界 / 队伍)

一个通用的“阶段”注册表,旨在限制内容访问并跨不同范围跟踪进度:

  • 玩家阶段:持久化的按玩家划分的阶段标志。
  • 世界阶段:存储在世界保存数据中的全局标志。
  • 队伍阶段:由队伍共享的阶段标志,存储在世界保存数据中。
  • 钩子和监听器:用于对阶段变化做出反应的集成点。

关键包/类:

  • net.unfamily.iskalib.stage.StageRegistry
  • net.unfamily.iskalib.stage.StageHooks
  • net.unfamily.iskalib.stage.StageActionHooks

队伍支持(共享余额 / 成员资格)

用于将玩家分组并共享余额的队伍管理功能:

  • 创建/删除队伍
  • 管理成员资格和角色
  • 追踪和查询按队伍划分的货币余额

关键包/类:

  • net.unfamily.iskalib.team.ShopTeamManager

商店货币集成钩子

该库按货币 ID 存储余额,但不硬编码货币目录。使用者可以提供元数据和建议:

  • 货币 ID 列表:用于命令自动补全和用户界面
  • 货币显示元数据(翻译键、符号):在可用时提供

关键包/类:

  • net.unfamily.iskalib.shop.ShopCurrencyHooks

世界标记工具(客户端)

面向开发者的标记渲染和辅助功能,适用于调试区域、选择、扫描和自动化:

  • 方块标记渲染
  • 位置标牌
  • 运行时会话(非持久化):用于清理/重置行为
  • 调试命令入口点:用于创建/清除标记

关键包/类:

  • net.unfamily.iskalib.client.marker.MarkRenderer
  • net.unfamily.iskalib.client.marker.VanillaWorldMarkerClientHooks
  • net.unfamily.iskalib.marker.MarkerSession
  • net.unfamily.iskalib.command.MarkerCommand

渐进式爆炸系统(服务端)

一种模块化、更减少卡顿的爆炸实现,可以随时间逐步运行:

  • 椭圆/水平+垂直半径爆炸
  • 基于刻的处理(当间隔为零时为即时执行)
  • 可选实体伤害和“破坏不可破坏方块”模式
  • 活跃爆炸的中心注册表,带有停止/自省辅助功能

关键包/类:

  • net.unfamily.iskalib.explosion.ExplosionSystem

物品字符串解析与转换工具

用于将“物品参数”字符串转换为 ItemStack(反之亦然)的辅助功能,匹配 /give 接受的格式:

  • 解析 minecraft:item_id 以及类似 minecraft:item[component=value,...] 的方括号组件语法
  • 验证用户提供的物品字符串以用于配置/命令
  • 将 ItemStack 格式化为物品参数字符串(ID + 组件补丁)

关键包/类:

  • net.unfamily.iskalib.item.ItemConverter

传输桥接(自动化兼容性)

将旧版物品处理器桥接到 NeoForge 的物品传输能力:

  • 将 IItemHandler 包装为事务性的 ResourceHandler<ItemResource>
  • 在可能时使用快照日志进行回滚(IItemHandlerModifiable)

关键包/类:

  • net.unfamily.iskalib.transfer.LegacyItemHandlerResourceHandler

调试辅助功能和命令

小型、专注的工具,旨在用于开发和故障排除:

  • 手持/物品转储辅助功能
  • 用于标记/阶段工作流的调试命令

关键包/类:

  • net.unfamily.iskalib.debug.HandItemDump
  • net.unfamily.iskalib.command.IskaLibDebugCommand
  • net.unfamily.iskalib.command.StageCommand

液体 API:

  • net.unfamily.iskalib.liquid

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源