
toucanLib
Small shared multi-loader utility helpers for jvn's mods.
- Загрузки
- 10K
- Подписчики
- 3
- Обновлён
- 16 августа 2026 г.
- Лицензия
- All-Rights-Reserved
Опубликован 14 мая 2026 г.

toucanLib
toucanLib is a small shared library for my Minecraft mods.
It does not add any gameplay on its own. It just provides common code and helpers that other mods use.
Required By (my mods)
- ✅ Second Wind!
- ✅ Villager Retaliation!
- ✅ Emerald Pouch
- ✅ Gracebound
- 🚧 Focus [in progress]
- ⛔ Flow State! (👀 coming soon...)
- ⛔The Hunt (👀 coming soon...)
Install toucanLib if another one of my mods lists it as a dependency.
If toucanLib is missing, those mods will not load.
Supported Versions
- Minecraft: 1.21.1
- Java: 21
- Loaders: NeoForge, Fabric
For Players
Just install the correct toucanLib jar for your loader.
- Use the NeoForge jar for my NeoForge mods.
- Use the Fabric jar for my Fabric mods.
Do not mix loader versions.
For Developers
toucanLib contains shared utility code used across my mods, such as setup helpers, platform checks, and other small reusable tools.
Ченджлог
0.5.0Релиз1.21.1 · 16 августа 2026 г.
Added
- Added an ordered passenger-seat API with synchronized layout metadata, exact-seat mounting and dismounting, custom offsets, atomic driver-seat transfers, persistent passenger state, and client-side positioning.
0.5.0Релиз1.21.1 · 16 августа 2026 г.
Added
- Added an ordered passenger-seat API with synchronized layout metadata, exact-seat mounting and dismounting, custom offsets, atomic driver-seat transfers, persistent passenger state, and client-side positioning.
0.4.0Релиз1.21.1 · 12 августа 2026 г.
Added
Added
ToucanCrosshairCooldownIndicatorsfor reusable hand-oriented cooldown icons beside the crosshair.- Positions indicators according to the player’s physical arm.
- Automatically mirrors sprites on the right side.
- Fills recovery progress toward the crosshair.
- Stacks multiple visible indicators outward in registration order.
- Respects the vanilla crosshair attack-indicator setting and rendering state.
- Supports uniquely identified, removable registrations.
Added
ToucanSkyDomefor generating reusable position-only spherical dome vertex buffers for sky effects.Added
ToucanScaledAnimationClockfor discontinuity-safe, variable-speed animation timing.Added
ToucanPlayerSkinResolverfor non-blocking UUID-based player-skin resolution with:- Live-player skin reuse.
- Authenticated profile loading.
- UUID-based fallback skins.
- Bounded caching.
- Failed-lookup throttling.
Added cross-loader hovered-slot interaction routing with:
- Modifier-key snapshots.
- Deterministic handler ordering.
- Removable registrations.
- Explicit vanilla-click consumption.
- Slot, menu, carried-stack, and pointer context.
Added reusable visual-slot utilities for:
- Slot bounds and registration.
- Hover hit testing.
- Item, highlight, and count-label rendering.
- Modifier-aware amount scrolling.
- Source-stack reservation.
- Unnumbered preview icons.
- Hidden give-all sentinel handling.
- Bounded item tooltips.
- Component-key reveal hints.
Added progressive tooltip composition with:
- Compact and expanded alternatives.
- Lazy hidden-branch evaluation.
- Current keybinding hints.
- Custom predicates and key chords.
- Standard
1/5/10/100scroll instructions.
Added
ToucanItemStateCyclefor ordered component-backed item states with:- Forward and reverse wrapping.
- Enum support.
- Unknown-state recovery.
- Default-component removal.
Added
ToucanClientFeedbackfor standard action-bar messages and UI sounds for confirmed or rejected interactions.Added
ToucanLimitFeedbackfor reusable tick-based limit feedback.Added
ToucanModelPartAnchorsfor reusable model-part anchor calculations and cube access.Added
ToucanPostChainfor reusable post-processing chain management.Added
ToucanBoundedCache.Added
ToucanColorValuesfor loader-neutral RGB/ARGB packing and color parsing.Added
ToucanItemCustomDatahelpers.Added
ToucanSegmentAabbsfor generating segmented bounding boxes.Added
ToucanEntityLookuphelpers.Added vector stream codecs through
ToucanStreamCodecs.Added deterministic, allocation-free unit-float and signed mutable-random helpers to
ToucanRandom.Added double-precision smootherstep and clamping helpers to
ToucanEasing.Added optional NeoForge shader registration.
Added two-, three-, and four-component float uniform setters to
ToucanShaders.Added simplified NeoForge config-screen factory helpers.
Added supporting HUD, container-screen, model-part, and
GuiGraphicsmixins.Added tests covering the new interaction, tooltip, rendering, timing, random, caching, networking, state-cycle, skin-resolution, and crosshair-indicator APIs.
Changed
- Changed the project license from GNU GPL v3.0 to All Rights Reserved.
- Expanded the README with examples for player skins, progressive tooltips, item states, hovered-slot interactions, and sky-dome rendering.
- Expanded the API documentation to include the new client interaction, tooltip, rendering, animation, random, and crosshair cooldown APIs.
0.4.0Релиз1.21.1 · 12 августа 2026 г.
Added
Added
ToucanCrosshairCooldownIndicatorsfor reusable hand-oriented cooldown icons beside the crosshair.- Positions indicators according to the player’s physical arm.
- Automatically mirrors sprites on the right side.
- Fills recovery progress toward the crosshair.
- Stacks multiple visible indicators outward in registration order.
- Respects the vanilla crosshair attack-indicator setting and rendering state.
- Supports uniquely identified, removable registrations.
Added
ToucanSkyDomefor generating reusable position-only spherical dome vertex buffers for sky effects.Added
ToucanScaledAnimationClockfor discontinuity-safe, variable-speed animation timing.Added
ToucanPlayerSkinResolverfor non-blocking UUID-based player-skin resolution with:- Live-player skin reuse.
- Authenticated profile loading.
- UUID-based fallback skins.
- Bounded caching.
- Failed-lookup throttling.
Added cross-loader hovered-slot interaction routing with:
- Modifier-key snapshots.
- Deterministic handler ordering.
- Removable registrations.
- Explicit vanilla-click consumption.
- Slot, menu, carried-stack, and pointer context.
Added reusable visual-slot utilities for:
- Slot bounds and registration.
- Hover hit testing.
- Item, highlight, and count-label rendering.
- Modifier-aware amount scrolling.
- Source-stack reservation.
- Unnumbered preview icons.
- Hidden give-all sentinel handling.
- Bounded item tooltips.
- Component-key reveal hints.
Added progressive tooltip composition with:
- Compact and expanded alternatives.
- Lazy hidden-branch evaluation.
- Current keybinding hints.
- Custom predicates and key chords.
- Standard
1/5/10/100scroll instructions.
Added
ToucanItemStateCyclefor ordered component-backed item states with:- Forward and reverse wrapping.
- Enum support.
- Unknown-state recovery.
- Default-component removal.
Added
ToucanClientFeedbackfor standard action-bar messages and UI sounds for confirmed or rejected interactions.Added
ToucanLimitFeedbackfor reusable tick-based limit feedback.Added
ToucanModelPartAnchorsfor reusable model-part anchor calculations and cube access.Added
ToucanPostChainfor reusable post-processing chain management.Added
ToucanBoundedCache.Added
ToucanColorValuesfor loader-neutral RGB/ARGB packing and color parsing.Added
ToucanItemCustomDatahelpers.Added
ToucanSegmentAabbsfor generating segmented bounding boxes.Added
ToucanEntityLookuphelpers.Added vector stream codecs through
ToucanStreamCodecs.Added deterministic, allocation-free unit-float and signed mutable-random helpers to
ToucanRandom.Added double-precision smootherstep and clamping helpers to
ToucanEasing.Added optional NeoForge shader registration.
Added two-, three-, and four-component float uniform setters to
ToucanShaders.Added simplified NeoForge config-screen factory helpers.
Added supporting HUD, container-screen, model-part, and
GuiGraphicsmixins.Added tests covering the new interaction, tooltip, rendering, timing, random, caching, networking, state-cycle, skin-resolution, and crosshair-indicator APIs.
Changed
- Changed the project license from GNU GPL v3.0 to All Rights Reserved.
- Expanded the README with examples for player skins, progressive tooltips, item states, hovered-slot interactions, and sky-dome rendering.
- Expanded the API documentation to include the new client interaction, tooltip, rendering, animation, random, and crosshair cooldown APIs.
0.3.1Релиз1.21.1 · 1 июня 2026 г.
- Fixed world-text indicator construction on runtimes where Java's default random-generator provider cannot supply
L32X64MixRandom - Switched the default world-text random source to
java.util.Random, while keeping the seededRandomGeneratorconstructor for deterministic callers
0.3.1Релиз1.21.1 · 1 июня 2026 г.
- Fixed world-text indicator construction on runtimes where Java's default random-generator provider cannot supply
L32X64MixRandom - Switched the default world-text random source to
java.util.Random, while keeping the seededRandomGeneratorconstructor for deterministic callers
0.3.0Релиз1.21.1 · 1 июня 2026 г.
ToucanLib 0.3.0 Release Notes
Highlights
ToucanLib 0.3.0 expands shared utilities extracted from active mods, including Focus, Villager Retaliation, Emerald Pouch, Gracebound, and Second Wind.
Added
- Fabric networking helpers aligned with the NeoForge networking wrapper
- Shared send helpers on NeoForge
- Datapack JSON readers
- Item selectors
- Inventory extraction helpers
- Combat attribution helpers
- Recoverable damage rules
- Screen projection utilities
- Documented helpers for world-text indicator animation state
- Deterministic seeded randomness support
Changed
- Version bump from
0.2.0to0.3.0 - Continued cross-mod extraction and consolidation of utility code into ToucanLib
0.3.0Релиз1.21.1 · 1 июня 2026 г.
ToucanLib 0.3.0 Release Notes
Highlights
ToucanLib 0.3.0 expands shared utilities extracted from active mods, including Focus, Villager Retaliation, Emerald Pouch, Gracebound, and Second Wind.
Added
- Fabric networking helpers aligned with the NeoForge networking wrapper
- Shared send helpers on NeoForge
- Datapack JSON readers
- Item selectors
- Inventory extraction helpers
- Combat attribution helpers
- Recoverable damage rules
- Screen projection utilities
- Documented helpers for world-text indicator animation state
- Deterministic seeded randomness support
Changed
- Version bump from
0.2.0to0.3.0 - Continued cross-mod extraction and consolidation of utility code into ToucanLib
Комментарии
Загружаем…