Home›Java›Mods›ItemsEngine
ItemsEngine
ModsJava

ItemsEngine

ItemsAdder-compatible API and hook bridge backed by CraftEngine for Paper and Folia.

⬇ Download on Spigot
Open in MCModsHubGet it on Google Play →

ItemsEngine
ItemsAdder API Compatibility for CraftEngine

Run plugins that expect an ItemsAdder integration on CraftEngine-powered Paper and Folia servers.

SOURCE CODE • DOWNLOADS • ISSUE TRACKER
​

What is ItemsEngine?

ItemsEngine is an open-source compatibility bridge that presents itself as an ItemsAdder provider and routes supported ItemsAdder API calls to real CraftEngine data.

It is designed for server owners who manage custom items, blocks, furniture and font images through CraftEngine but still need to use plugins that integrate with the public ItemsAdder API.

ItemsEngine uses Paper's provides: [ItemsAdder] mechanism. This allows compatible plugins that declare depend: [ItemsAdder] to load without requiring the real ItemsAdder plugin.

Calls such as getPlugin("ItemsAdder") are resolved to ItemsEngine, while supported API operations are backed by CraftEngine registries.

Why use ItemsEngine?


Main features


Placeholder compatibility

ItemsEngine preserves supported ItemsAdder placeholder spellings while producing values from real CraftEngine registries.

Font images and emojis

Code (Text):

%img_namespace:image%
%img_image-or-emoji%
%img_namespace:sprite:row:column%
%img_offset_-16%
%img_offset_16%
 
Inline image syntax

Code (Text):

:image:
:namespace:image:
:namespace:sprite:row:column:
:offset_-16:
:offset_16:
 
Registry information

Code (Text):

%itemsadder_loaded%
%itemsadder_version%
%itemsadder_craftengine_version%

%itemsadder_items_count%
%itemsadder_blocks_count%
%itemsadder_furniture_count%
%itemsadder_images_count%
 
ItemsEngine also provides supported registry ID lists, existence checks, item metadata, image metadata and player-context values such as:

Code (Text):

%itemsadder_mainhand_id%
%itemsadder_offhand_id%
 
Additional supported metadata includes item material, display name, maximum stack size, CustomModelData, image Unicode value, codepoint, height, ascent, rows, columns, font and file information.

Recommendation: Always use fully qualified IDs such as namespace:id whenever possible.

A bare ID is resolved only when it uniquely identifies one entry. Ambiguous or unknown values fail safely instead of returning fabricated data.

Anti-xray and anti-cheat integrations

ItemsEngine connects several common public ItemsAdder API integration paths to CraftEngine-backed data.

Supported integration points include:


Important: Compatibility is targeted at plugins that use the public ItemsAdder API.

ItemsEngine does not claim universal compatibility with unpublished, private or internal classes used by closed-source premium plugins.

Requirements


ItemsEngine is not designed to run on the Spigot server implementation.

Although the resource is published on SpigotMC, the plugin requires a supported Paper or Folia server at runtime.

Installation

  1. Install a supported version of CraftEngine.
  2. Download the latest ItemsEngine JAR from the releases page.
  3. Place the JAR inside your server's plugins/ directory.
  4. Install PlaceholderAPI 2.12.3 or newer when placeholder functionality is required.
  5. Make sure the real ItemsAdder JAR is not installed on the same server.
  6. Fully restart the server.
  7. Run /itemsengine status and verify the reported integration state.

Do not use /reload.

A complete server restart is required.

Important limitations


This fail-closed design allows consuming plugins to detect unsupported operations safely instead of receiving incorrect or invented data.

For plugin developers

You do not need to replace your ItemsAdder API dependency.

Your plugin may continue declaring ItemsAdder through depend, softdepend or loadbefore.

Continue listening for the ItemsAdder load event before accessing registry-backed data. Do not assume that all registry data is ready during onEnable.

Code (Text):

CustomStack stack = CustomStack.getInstance("namespace:item");

if (stack != null) {
    player.getInventory().addItem(stack.getItemStack());
}
 
Verified environments

The project has been tested through real Paper and Folia server probes covering placeholders and placed custom-block API consumption.

The same Java 21 bytecode JAR can be used on supported Java 21 and Java 25 server environments according to the target Paper version.

For the detailed and conservative compatibility matrix, see:

ItemsEngine Compatibility Documentation


Use CraftEngine. Keep ItemsAdder integrations working.

ItemsEngine provides a safe, transparent and developer-friendly bridge between the CraftEngine and ItemsAdder API ecosystems.

GITHUB • LATEST RELEASE • REPORT AN ISSUE
​


ItemsEngine
CraftEngine için ItemsAdder API Uyumluluk Köprüsü

ItemsAdder entegrasyonu bekleyen eklentileri CraftEngine tabanlı Paper ve Folia sunucularında çalıştırın.

KAYNAK KOD • İNDİR • HATA TAKİBİ
​

ItemsEngine nedir?

ItemsEngine, kendisini bir ItemsAdder sağlayıcısı olarak sunan ve desteklenen ItemsAdder API çağrılarını gerçek CraftEngine verilerine yönlendiren açık kaynaklı bir uyumluluk köprüsüdür.

Özel item, blok, mobilya ve font görsellerini CraftEngine ile yöneten ancak public ItemsAdder API entegrasyonuna sahip eklentileri kullanmaya devam etmek isteyen sunucu sahipleri için geliştirilmiştir.

ItemsEngine, Paper'ın provides: [ItemsAdder] mekanizmasını kullanır. Böylece depend: [ItemsAdder] tanımlayan uyumlu eklentiler, gerçek ItemsAdder eklentisine ihtiyaç duymadan yüklenebilir.

getPlugin("ItemsAdder") gibi çağrılar ItemsEngine'e çözümlenir ve desteklenen API işlemleri CraftEngine kayıtlarıyla karşılanır.

Neden ItemsEngine?


Temel özellikler


Placeholder uyumluluğu

ItemsEngine, desteklenen ItemsAdder placeholder yazımlarını korurken değerleri gerçek CraftEngine kayıtlarından üretir.

Font görselleri ve emojiler

Code (Text):

%img_namespace:image%
%img_image-or-emoji%
%img_namespace:sprite:row:column%
%img_offset_-16%
%img_offset_16%
 
Satır içi görsel biçimleri

Code (Text):

:image:
:namespace:image:
:namespace:sprite:row:column:
:offset_-16:
:offset_16:
 
Kayıt bilgileri

Code (Text):

%itemsadder_loaded%
%itemsadder_version%
%itemsadder_craftengine_version%

%itemsadder_items_count%
%itemsadder_blocks_count%
%itemsadder_furniture_count%
%itemsadder_images_count%
 
ItemsEngine ayrıca desteklenen kayıt ID listelerini, varlık kontrollerini, item metadata değerlerini, görsel metadata değerlerini ve oyuncu bağlamındaki değerleri sunar.

Code (Text):

%itemsadder_mainhand_id%
%itemsadder_offhand_id%
 
Desteklenen ek metadata alanları arasında item materyali, görünen ad, maksimum stack boyutu, CustomModelData, görsel Unicode değeri, codepoint, yükseklik, ascent, satır, sütun, font ve dosya bilgileri bulunur.

Öneri: Mümkün olduğunda daima namespace:id biçimindeki tam kimlikleri kullanın.

Kısa bir ID yalnızca tek bir kayıtla benzersiz biçimde eşleştiğinde çözümlenir. Belirsiz veya bilinmeyen değerlerde sahte sonuç üretilmez.

Anti-xray ve anti-cheat entegrasyonları

ItemsEngine, yaygın public ItemsAdder API bağlantı yollarını CraftEngine destekli verilere bağlar.

Temel entegrasyon noktaları:


Önemli: Uyumluluk, public ItemsAdder API kullanan eklentiler için hedeflenir.

ItemsEngine, kapalı kaynaklı ücretli eklentilerin yayımlanmamış, özel veya dahili sınıflarıyla evrensel uyumluluk iddiasında bulunmaz.

Gereksinimler


ItemsEngine, Spigot sunucu yazılımında çalışmak üzere tasarlanmamıştır.

Kaynak SpigotMC üzerinde yayımlansa da eklentinin çalışma ortamında desteklenen bir Paper veya Folia sunucusu bulunmalıdır.

Kurulum

  1. Desteklenen bir CraftEngine sürümü kurun.
  2. Releases sayfasından en güncel ItemsEngine JAR dosyasını indirin.
  3. JAR dosyasını sunucunuzun plugins/ klasörüne yerleştirin.
  4. Placeholder özelliklerine ihtiyaç duyuyorsanız PlaceholderAPI 2.12.3 veya daha yeni bir sürümünü kurun.
  5. Gerçek ItemsAdder JAR dosyasının aynı sunucuda kurulu olmadığından emin olun.
  6. Sunucuyu tamamen yeniden başlatın.
  7. /itemsengine status komutunu çalıştırarak entegrasyon durumunu kontrol edin.

/reload kullanmayın.

Tam bir sunucu yeniden başlatması gereklidir.

Önemli sınırlamalar


Bu fail-closed yaklaşımı, entegrasyon kullanan eklentilerin yanlış veya uydurulmuş veri almak yerine desteklenmeyen işlemleri güvenli biçimde algılamasını sağlar.

Eklenti geliştiricileri için

ItemsAdder API bağımlılığınızı değiştirmeniz gerekmez.

Eklentiniz ItemsAdder adını depend, softdepend veya loadbefore içerisinde kullanmaya devam edebilir.

Kayıt tabanlı verilere erişmeden önce ItemsAdder yükleme eventini dinlemeye devam edin. Tüm kayıtların onEnable aşamasında hazır olduğunu varsaymayın.

Code (Text):

CustomStack stack = CustomStack.getInstance("namespace:item");

if (stack != null) {
    player.getInventory().addItem(stack.getItemStack());
}
 
Doğrulanmış ortamlar

Proje; placeholder işlemlerini ve yerleştirilmiş özel blokların API üzerinden okunmasını kapsayan gerçek Paper ve Folia sunucu problarıyla test edilmiştir.

Aynı Java 21 bytecode JAR dosyası, hedef Paper sürümüne göre desteklenen Java 21 ve Java 25 sunucu ortamlarında kullanılabilir.

Ayrıntılı ve temkinli uyumluluk matrisi:

ItemsEngine Uyumluluk Belgesi


CraftEngine kullanın. ItemsAdder entegrasyonlarını koruyun.

ItemsEngine, CraftEngine ve ItemsAdder API ekosistemleri arasında güvenli, şeffaf ve geliştirici dostu bir köprü sunar.

GITHUB • SON SÜRÜM • HATA BİLDİR
​

ItemsEngine is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 6 times (via Spigot). Download it and open it directly in the game.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.21Java mods for 26