Iskandert's Library — 功能概览
本库包含 Iskandert's Team 各项目间复用的构建模块。它专注于 实用游戏系统(结构、阶段、标记、商店/队伍)和 开发者工具(解析辅助、传输桥接、调试工具)。
使用与许可
本项目采用 MIT 许可证发布。只要保留许可证声明,您可以自由地在项目中使用它(包括修改、重新分发和商业使用)。
包含内容
结构系统(基于 JSON)
用于使用外部 JSON 定义来定义和放置结构的工具:
- 结构定义:模式、方块键、替换规则,以及如强制/覆盖等选项。
- 配置扫描与加载:发现结构 JSON 文件并在运行时注册。
- 放置引擎:在世界中放置结构,具备验证、属性应用及可选行为(例如“以玩家身份放置”、刷新刻)。
- 撤销历史:轻量级的按玩家划分的放置历史记录,支持撤销操作。
关键包/类:
net.unfamily.iskalib.structure.StructureDefinitionnet.unfamily.iskalib.structure.StructureLoadernet.unfamily.iskalib.structure.StructurePlacernet.unfamily.iskalib.structure.StructurePlacementHistory
阶段系统(玩家 / 世界 / 队伍)
一个通用的“阶段”注册表,旨在限制内容访问并跨不同范围跟踪进度:
- 玩家阶段:持久化的按玩家划分的阶段标志。
- 世界阶段:存储在世界保存数据中的全局标志。
- 队伍阶段:由队伍共享的阶段标志,存储在世界保存数据中。
- 钩子和监听器:用于对阶段变化做出反应的集成点。
关键包/类:
net.unfamily.iskalib.stage.StageRegistrynet.unfamily.iskalib.stage.StageHooksnet.unfamily.iskalib.stage.StageActionHooks
队伍支持(共享余额 / 成员资格)
用于将玩家分组并共享余额的队伍管理功能:
- 创建/删除队伍
- 管理成员资格和角色
- 追踪和查询按队伍划分的货币余额
关键包/类:
net.unfamily.iskalib.team.ShopTeamManager
商店货币集成钩子
该库按货币 ID 存储余额,但不硬编码货币目录。使用者可以提供元数据和建议:
- 货币 ID 列表:用于命令自动补全和用户界面
- 货币显示元数据(翻译键、符号):在可用时提供
关键包/类:
net.unfamily.iskalib.shop.ShopCurrencyHooks
世界标记工具(客户端)
面向开发者的标记渲染和辅助功能,适用于调试区域、选择、扫描和自动化:
- 方块标记渲染
- 位置标牌
- 运行时会话(非持久化):用于清理/重置行为
- 调试命令入口点:用于创建/清除标记
关键包/类:
net.unfamily.iskalib.client.marker.MarkRenderernet.unfamily.iskalib.client.marker.VanillaWorldMarkerClientHooksnet.unfamily.iskalib.marker.MarkerSessionnet.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.HandItemDumpnet.unfamily.iskalib.command.IskaLibDebugCommandnet.unfamily.iskalib.command.StageCommand
液体 API:
net.unfamily.iskalib.liquid
Iskandert's Library — Features Overview
This library contains reusable building blocks used across projects in the Iskandert's Team. It focuses on practical gameplay systems (structures, stages, markers, shops/teams) and developer utilities (parsing helpers, transfer bridging, debug tools).
Usage and licensing
The project is released under the MIT License. You are free to use it in your projects (including modifying, redistributing, and using it commercially), as long as the license notice is preserved.
What’s included
Structure system (JSON-driven)
Utilities for defining and placing structures using external JSON definitions:
- Structure definitions: patterns, block keys, replacement rules, and options like force/overwrite.
- Config scanning & loading: discovery of structure JSON files and runtime registration.
- Placement engine: places structures in-world with validation, property application, and optional behaviors (e.g. “place as player”, refresh ticks).
- Undo history: lightweight per-player placement history with undo support.
Key packages/classes:
net.unfamily.iskalib.structure.StructureDefinitionnet.unfamily.iskalib.structure.StructureLoadernet.unfamily.iskalib.structure.StructurePlacernet.unfamily.iskalib.structure.StructurePlacementHistory
Stage system (player / world / team)
A generic “stage” registry designed to gate content and track progression across different scopes:
- Player stages: persistent per-player stage flags.
- World stages: global flags stored in world saved data.
- Team stages: stage flags shared by a team, stored in world saved data.
- Hooks and listeners: integration points for reacting to stage changes.
Key packages/classes:
net.unfamily.iskalib.stage.StageRegistrynet.unfamily.iskalib.stage.StageHooksnet.unfamily.iskalib.stage.StageActionHooks
Team support (shared balances / membership)
Team management for grouping players and sharing balances:
- Create/delete teams
- Manage membership and roles
- Track and query per-team currency balances
Key packages/classes:
net.unfamily.iskalib.team.ShopTeamManager
Shop currency integration hooks
The library stores balances by currency id but does not hardcode a currency catalog. Consumers can provide metadata and suggestions:
- Currency id listing for command autocompletion and UIs
- Currency display metadata (translation key, symbol) when available
Key packages/classes:
net.unfamily.iskalib.shop.ShopCurrencyHooks
World marker utilities (client-side)
Developer-focused marker rendering and helpers, useful for debugging areas, selections, scans, and automation:
- Marker rendering for blocks
- Billboards for positions
- Runtime sessions (non-persistent) for cleaning/reset behavior
- Debug command entrypoint for creating/clearing markers
Key packages/classes:
net.unfamily.iskalib.client.marker.MarkRenderernet.unfamily.iskalib.client.marker.VanillaWorldMarkerClientHooksnet.unfamily.iskalib.marker.MarkerSessionnet.unfamily.iskalib.command.MarkerCommand
Progressive explosion system (server-side)
A modular, lag-friendlier explosion implementation that can run progressively over time:
- Elliptical/horizontal+vertical radius explosions
- Tick-based processing (or instant execution when interval is zero)
- Optional entity damage and “break unbreakable” mode
- Central registry of active explosions with stop/introspection helpers
Key packages/classes:
net.unfamily.iskalib.explosion.ExplosionSystem
Item string parsing and conversion utilities
Helpers for converting “item argument” strings into ItemStack (and back), matching the shape accepted by /give:
- Parse
minecraft:item_idas well as bracketed component syntax likeminecraft:item[component=value,...] - Validate user-provided item strings for configs/commands
- Format an
ItemStackinto an item-argument string (id + component patch)
Key packages/classes:
net.unfamily.iskalib.item.ItemConverter
Transfer bridging (automation compatibility)
Bridges legacy item handlers to NeoForge’s item transfer capability:
- Wraps
IItemHandleras a transactionalResourceHandler<ItemResource> - Uses snapshot journals for rollback when possible (
IItemHandlerModifiable)
Key packages/classes:
net.unfamily.iskalib.transfer.LegacyItemHandlerResourceHandler
Debug helpers and commands
Small, focused utilities intended for development and troubleshooting:
- Hand/item dump helpers
- Debug commands for marker/stage workflows
Key packages/classes:
net.unfamily.iskalib.debug.HandItemDumpnet.unfamily.iskalib.command.IskaLibDebugCommandnet.unfamily.iskalib.command.StageCommand
Liquid API:
net.unfamily.iskalib.liquid
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
下载 Iskandert's Library
Iskandert 的图书馆
功能:
- 区域边界渲染器:仅适用于模组,它允许你通过创建一个框架来高亮显示一个区域,该框架可用于展示机械设备的操作范围。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧