# Iskandert-Library \u2014 Features Overview<\/p>\n
This library contains reusable building blocks used across projects in the Iskandert ecosystem.
\nIt focuses on **practical gameplay systems** (structures, stages, markers, shops\/teams) and **developer utilities**
\n(parsing helpers, transfer bridging, debug tools).<\/p>\n
## Usage and licensing<\/p>\n
The project is released under the **MIT License**. You are free to use it in your projects (including modifying,
\nredistributing, and using it commercially), as long as the license notice is preserved.<\/p>\n
## What\u2019s included<\/p>\n
### Structure system (JSON-driven)<\/p>\n
Utilities for defining and placing structures using external JSON definitions:<\/p>\n
– **Structure definitions**: patterns, block keys, replacement rules, and options like force\/overwrite.
\n– **Config scanning & loading**: discovery of structure JSON files and runtime registration.
\n– **Placement engine**: places structures in-world with validation, property application, and optional behaviors
\n (e.g. \u201cplace as player\u201d, refresh ticks).
\n– **Undo history**: lightweight per-player placement history with undo support.<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.structure.StructureDefinition`
\n– `net.unfamily.iskalib.structure.StructureLoader`
\n– `net.unfamily.iskalib.structure.StructurePlacer`
\n– `net.unfamily.iskalib.structure.StructurePlacementHistory`<\/p>\n
### Stage system (player \/ world \/ team)<\/p>\n
A generic \u201cstage\u201d registry designed to gate content and track progression across different scopes:<\/p>\n
– **Player stages**: persistent per-player stage flags.
\n– **World stages**: global flags stored in world saved data.
\n– **Team stages**: stage flags shared by a team, stored in world saved data.
\n– **Hooks and listeners**: integration points for reacting to stage changes.<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.stage.StageRegistry`
\n– `net.unfamily.iskalib.stage.StageHooks`
\n– `net.unfamily.iskalib.stage.StageActionHooks`<\/p>\n
### Team support (shared balances \/ membership)<\/p>\n
Team management for grouping players and sharing balances:<\/p>\n
– Create\/delete teams
\n– Manage membership and roles
\n– Track and query per-team currency balances<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.team.ShopTeamManager`<\/p>\n
### Shop currency integration hooks<\/p>\n
The library stores balances by currency id but does not hardcode a currency catalog.
\nConsumers can provide metadata and suggestions:<\/p>\n
– **Currency id listing** for command autocompletion and UIs
\n– **Currency display metadata** (translation key, symbol) when available<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.shop.ShopCurrencyHooks`<\/p>\n
### World marker utilities (client-side)<\/p>\n
Developer-focused marker rendering and helpers, useful for debugging areas, selections, scans, and automation:<\/p>\n
– **Marker rendering** for blocks
\n– **Billboards** for positions
\n– **Runtime sessions** (non-persistent) for cleaning\/reset behavior
\n– **Debug command** entrypoint for creating\/clearing markers<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.client.marker.MarkRenderer`
\n– `net.unfamily.iskalib.client.marker.VanillaWorldMarkerClientHooks`
\n– `net.unfamily.iskalib.marker.MarkerSession`
\n– `net.unfamily.iskalib.command.MarkerCommand`<\/p>\n
### Progressive explosion system (server-side)<\/p>\n
A modular, lag-friendlier explosion implementation that can run progressively over time:<\/p>\n
– Elliptical\/horizontal+vertical radius explosions
\n– Tick-based processing (or instant execution when interval is zero)
\n– Optional entity damage and \u201cbreak unbreakable\u201d mode
\n– Central registry of active explosions with stop\/introspection helpers<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.explosion.ExplosionSystem`<\/p>\n
### Item string parsing and conversion utilities<\/p>\n
Helpers for converting \u201citem argument\u201d strings into `ItemStack` (and back), matching the shape accepted by `\/give`:<\/p>\n
– Parse `minecraft:item_id` as well as bracketed component syntax like `minecraft:item[component=value,…]`
\n– Validate user-provided item strings for configs\/commands
\n– Format an `ItemStack` into an item-argument string (id + component patch)<\/p>\n
Key packages\/classes:
\n– `net.unfamily.iskalib.item.ItemConverter`<\/p>\n
### Transfer bridging (automation compatibility)<\/p>\n
Bridges legacy item handlers to NeoForge\u2019s item transfer capability:<\/p>\n
– Wraps `IItemHandler` as a transactional `ResourceHandler Key packages\/classes: ### Debug helpers and commands<\/p>\n Small, focused utilities intended for development and troubleshooting:<\/p>\n – Hand\/item dump helpers Key packages\/classes: A library of functions used primarily by Iskandert’s Team mods<\/p>\n","protected":false},"featured_media":86577,"template":"","meta":{"_minecraft_slug":"iska-lib","_minecraft_project_id":"y16HgCOF","_minecraft_author":"Unfamily","_minecraft_license":"MIT","_minecraft_downloads":67,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"iska-lib.zip","_minecraft_size_bytes":716980,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T17:18:41.772300Z","_minecraft_date_created":"2026-04-27T01:05:52.184128Z","_minecraft_date_modified":"2026-05-13T14:41:15.101593Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/iska-lib","_minecraft_icon_attachment_id":86577,"_minecraft_imported_at":"2026-06-04T22:43:18+00:00","_minecraft_import_hash":"f529b15f990a1ee2f82d1007dac90357","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,158,92],"mod_loader":[160],"minecraft_version":[163],"class_list":["post-86576","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-neoforge","mod_category-utility","mod_loader-neoforge","minecraft_version-26-1-2"],"yoast_head":"\n
\n– Uses snapshot journals for rollback when possible (`IItemHandlerModifiable`)<\/p>\n
\n– `net.unfamily.iskalib.transfer.LegacyItemHandlerResourceHandler`<\/p>\n
\n– Debug commands for marker\/stage workflows<\/p>\n
\n– `net.unfamily.iskalib.debug.HandItemDump`
\n– `net.unfamily.iskalib.command.IskaLibDebugCommand`
\n– `net.unfamily.iskalib.command.StageCommand`<\/p>\n","protected":false},"excerpt":{"rendered":"