Documentazione per sviluppatori

API addon Minecraft

dev.nebulastorage.api · Java 21 · Kotlin · NeoForge 1.21.1

Una simulazione non possiede risorse. L’adattatore fisico conserva ingressi, uscite e ricevuta nello stesso proprietario.

Un addon dipende da Nebula e compila contro dev.nebulastorage.api. Isola gli adattatori opzionali per non caricare classi di mod assenti. API 1.0.0 è distinta dalla versione alpha. Questi esempi di addon riguardano Nebula Storage alpha.7 e i suoi nuovi package. I file pubblicati fino ad alpha.6 usano ancora dev.nexusstorage. Ricompila gli addon durante l’aggiornamento; gli identificatori Minecraft e i mondi salvati non cambiano.

Esempio di registrazione

Implementa NebulaExtension pubblicamente e inserisci il nome completo in META-INF/services/dev.nebulastorage.api.NebulaExtension, risorsa del JAR senza .txt.

L’esempio dichiara example:pressing, ma non crea blocchi o ricette. Registra un adattatore per l’oggetto reale e una fonte con ingressi e uscite esatti. Non accedere al mondo durante la registrazione.

package example.nexus

import dev.nebulastorage.api.NebulaExtension
import dev.nebulastorage.api.NebulaRegistrar
import dev.nebulastorage.api.production.ProductionCapabilityId

class ExampleExtension : NebulaExtension {
    override fun register(registrar: NebulaRegistrar) {
        registrar.capability(ProductionCapabilityId("example:pressing"))
    }
}

META-INF/services/dev.nebulastorage.api.NebulaExtension

example.nexus.ExampleExtension

API del sito

OpenAPI 3 · JSON · GET

Endpoint di sola lettura su https://ns-api.vyxs.fr, senza account o chiave. Il sito usa gli stessi dati tramite il server.

GET /v1/catalogue?locale=en&q=server
GET /v1/entries/controller?locale=fr
GET /v1/releases?locale=en
GET /v1/downloads/0.1.0-alpha.5

/v1/catalogue

Indice leggero. Filtra con locale, q (massimo 120 caratteri) e category. Usa lo slug per l’articolo completo.

/v1/entries/{slug}

Articolo, slot delle ricette e diagrammi. locale supporta en, fr, de, es, it e ja; slug sconosciuto: 404.

/v1/releases

Versioni verificate con nome file, dimensione e SHA-256. Le note seguono locale. Nuove release dopo consultazione Forgejo e rinnovo cache.

/v1/downloads/{version}

Trasmette il JAR pubblicato. Confronta SHA-256 con i metadati. Versione sconosciuta: 404; file non disponibile o non verificato: 503.

Parametri non validi: 400. Limite: 429 con Retry-After. Conserva risposte valide e attendi prima di riprovare. Nessuna rotta modifica reti Minecraft.

Ambito delle integrazioni

JEI ed EMI mostrano le ricette; Ponder offre tutorial nel gioco. Sono supportate macchine Vanilla, Mekanism e di altri mod. La lista delle integrazioni indica processi supportati ed esclusioni.