mirror of
https://github.com/GTNewHorizons/ForgeMultipart.git
synced 2026-11-22 13:09:44 +00:00
docs: define direct Java material access
This commit is contained in:
1 parent
079739ea80
commit
37d5ea98f6
13 files changed
+311
-31
No files matched your search
@@ -8,6 +8,14 @@ Consumers can use the Java surface without importing Scala types. FMP still reta
|
||||
compatibility bridges, and some extension contracts still need migration. A Scala-authored mod can adopt the Java API
|
||||
without converting the rest of its code to Java.
|
||||
|
||||
## Direct calls and optional integration
|
||||
|
||||
The intended consumer API uses direct typed public calls, without reflection, private-field mixins or Scala
|
||||
companion lookup. Reuse existing entry points where they cover the task. For optional support, isolate FMP-typed
|
||||
code in a compatibility class loaded only after mod-presence and supported-version checks; test absent and present
|
||||
mod loading. Reflection snippets in older guides are legacy interoperability options, not the migration target.
|
||||
Existing reflective binaries remain supported until consumer release and pack adoption.
|
||||
|
||||
## Choose a guide
|
||||
|
||||
| Task | API and guide |
|
||||
@@ -15,6 +23,7 @@ without converting the rest of its code to Java.
|
||||
| Register part factories during mod initialization | `registerPartFactory(IPartFactory2, String...)` — [factory timing, payload ownership and migration](api/PART_REGISTRATION.md) |
|
||||
| Find the factory registered for a part type | `getPartFactory(String)` — [lookup ownership and Schematica reflection migration](api/FACTORY_LOOKUP.md) |
|
||||
| Enumerate microblock materials by numeric ID | `materialCount()`, `materialName(int)`, `getMaterial(int)` — [material enumeration](api/MATERIAL_ENUMERATION.md) |
|
||||
| Read a microblock material's block and metadata | `BlockMicroMaterial.block()`, `meta()` — [typed GuideNH query, identity and overrides](api/MATERIAL_ACCESS.md) |
|
||||
| Create a microblock with the requested material and side | `MicroblockGenerator.create(MicroblockClass, int, boolean)` — [construction, material traits and GuideNH migration](api/MICROBLOCK_CREATION.md) |
|
||||
| Read/index/search a tile's parts | `jPartList()` — [part collection ownership and order](api/PART_TRAVERSAL.md#collection-ownership-and-ordering) |
|
||||
| Run callbacks while skipping detached parts | `forEachPart(Consumer)` — [callback and override behavior](api/PART_TRAVERSAL.md#callback-behavior) |
|
||||
|
||||
Reference in new issue
Block a user