Перейти к содержимому
Mineforgian

toucanLib

Small shared multi-loader utility helpers for jvn's mods.

Загрузки
10K
Подписчики
3
Обновлён
16 августа 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 14 мая 2026 г.

Requires Architectury API

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)

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 ToucanCrosshairCooldownIndicators for 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 ToucanSkyDome for generating reusable position-only spherical dome vertex buffers for sky effects.

  • Added ToucanScaledAnimationClock for discontinuity-safe, variable-speed animation timing.

  • Added ToucanPlayerSkinResolver for 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/100 scroll instructions.
  • Added ToucanItemStateCycle for ordered component-backed item states with:

    • Forward and reverse wrapping.
    • Enum support.
    • Unknown-state recovery.
    • Default-component removal.
  • Added ToucanClientFeedback for standard action-bar messages and UI sounds for confirmed or rejected interactions.

  • Added ToucanLimitFeedback for reusable tick-based limit feedback.

  • Added ToucanModelPartAnchors for reusable model-part anchor calculations and cube access.

  • Added ToucanPostChain for reusable post-processing chain management.

  • Added ToucanBoundedCache.

  • Added ToucanColorValues for loader-neutral RGB/ARGB packing and color parsing.

  • Added ToucanItemCustomData helpers.

  • Added ToucanSegmentAabbs for generating segmented bounding boxes.

  • Added ToucanEntityLookup helpers.

  • 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 GuiGraphics mixins.

  • 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 ToucanCrosshairCooldownIndicators for 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 ToucanSkyDome for generating reusable position-only spherical dome vertex buffers for sky effects.

  • Added ToucanScaledAnimationClock for discontinuity-safe, variable-speed animation timing.

  • Added ToucanPlayerSkinResolver for 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/100 scroll instructions.
  • Added ToucanItemStateCycle for ordered component-backed item states with:

    • Forward and reverse wrapping.
    • Enum support.
    • Unknown-state recovery.
    • Default-component removal.
  • Added ToucanClientFeedback for standard action-bar messages and UI sounds for confirmed or rejected interactions.

  • Added ToucanLimitFeedback for reusable tick-based limit feedback.

  • Added ToucanModelPartAnchors for reusable model-part anchor calculations and cube access.

  • Added ToucanPostChain for reusable post-processing chain management.

  • Added ToucanBoundedCache.

  • Added ToucanColorValues for loader-neutral RGB/ARGB packing and color parsing.

  • Added ToucanItemCustomData helpers.

  • Added ToucanSegmentAabbs for generating segmented bounding boxes.

  • Added ToucanEntityLookup helpers.

  • 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 GuiGraphics mixins.

  • 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 seeded RandomGenerator constructor 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 seeded RandomGenerator constructor 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.0 to 0.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.0 to 0.3.0
  • Continued cross-mod extraction and consolidation of utility code into ToucanLib

Комментарии

Загружаем…