Skip to content

Home en

eaker edited this page Oct 12, 2026 · 7 revisions

English | 简体中文

Just Items Viewer Developer Wiki

This Wiki is for mod developers integrating Just Items Viewer (JIV): display custom recipes, extend ingredient search, integrate container screens, and control JIV at runtime.

The documentation targets JIV 0.0.1-alpha-5 / Minecraft 26.1.2 / NeoForge 26.1.2.99 / Java 25. The public API package is eakerzt.jiv.api; the bundled configuration API is eakerzt.jiv.config.api. Some source @since tags come from upstream and are not JIV release numbers.

Start here

Goal Page
Add the Maven Central dependency and display your first recipe Getting started
Understand discovery, registration, and runtime availability Plugin lifecycle
Define recipe types, categories, slots, and crafting stations Recipes
Register variants, fluids, custom ingredients, and aliases Ingredients
Add recipe click areas, exclusion areas, and ghost dragging GUI integration
Fill container input slots and observe transfer results Recipe transfer
Open recipes, set search text, manage bookmarks, and add dynamic content Runtime API
Extend vanilla categories and replace search storage Advanced extensions
Use the bundled configuration system Configuration
Troubleshoot integration and migrate older examples FAQ
Copy the complete Java source files Complete examples

API model

An integration implements IModPlugin and carries @JivPlugin. JIV discovers it and passes registration objects into its callbacks. After registration, onRuntimeAvailable provides IJivRuntime; onRuntimeUnavailable tells the plugin to release connection-specific references.

A category defines the recipe layout. Recipe data describes its inputs and outputs. An ingredient type identifies, searches, and renders objects such as item stacks. Recipe transfer is a separate container integration; displaying a recipe does not automatically add a working fill button.

Use the public API. Implementation classes in common, library, and gui, and types marked @ApiStatus.Internal, are not integration entry points. JIV supplies interfaces marked @ApiStatus.NonExtendable; call them instead of implementing them.

Dependency and source

Release coordinates on Maven Central:

io.github.eakerzt:jiv-26.1.2-neoforge:0.0.1-alpha-5

The Markdown sources can also be maintained in the project's wiki/ directory. When copying them into the separate GitHub Wiki repository, remove .md from internal page links. _Sidebar.md defines the navigation; complete Java examples are included as Wiki pages.

Clone this wiki locally