Skip to content

PORTING_MANIFEST.md

Latest commit

 

History

History
627 lines (575 loc) · 37.1 KB

PORTING_MANIFEST.md

File metadata and controls

627 lines (575 loc) · 37.1 KB

PORTING_MANIFEST.md

Purpose

  • Canonical breadth-first inventory of registries, IDs, and source locations in the 1.12.2 codebase.
  • Use this file as the quick lookup map before touching implementation.
  • Also tracks current 1.20.1 scaffold coverage and where each breadth-phase registry now lives.

Source Scope

  • Legacy root: old-1.12.2
  • Main code root: old-1.12.2/src/main/java/openblocks
  • Main assets root: old-1.12.2/src/main/resources/assets/openblocks

Current 1.20.1 Port Snapshot (2026-02-09)

Current source roots:

  • Java root: src/main/java/art/arcane/openblocks
  • Assets root: src/main/resources/assets/open_blocks

Current registry classes:

  • Mod bootstrap: src/main/java/art/arcane/openblocks/OpenBlocks.java
  • Blocks register: src/main/java/art/arcane/openblocks/registry/OBBlocks.java
  • Items register: src/main/java/art/arcane/openblocks/registry/OBItems.java
  • Creative tab register: src/main/java/art/arcane/openblocks/registry/OBCreativeTabs.java
  • Fluid type register: src/main/java/art/arcane/openblocks/registry/OBFluidTypes.java
  • Fluid/block register: src/main/java/art/arcane/openblocks/registry/OBFluids.java
  • Block entity register: src/main/java/art/arcane/openblocks/registry/OBBlockEntities.java
  • Entity register: src/main/java/art/arcane/openblocks/registry/OBEntities.java
  • Sound register: src/main/java/art/arcane/openblocks/registry/OBSounds.java
  • Enchantment register: src/main/java/art/arcane/openblocks/registry/OBEnchantments.java
  • Menu register: src/main/java/art/arcane/openblocks/registry/OBMenuTypes.java
  • Recipe serializer register: src/main/java/art/arcane/openblocks/registry/OBRecipeSerializers.java
  • Custom pedometer item behavior:
    • src/main/java/art/arcane/openblocks/item/OBPedometerItem.java
  • Command registration (Forge bus): src/main/java/art/arcane/openblocks/command/OBCommands.java
  • Command inventory dump backend: src/main/java/art/arcane/openblocks/command/OBInventoryStore.java
  • Command inventory death-dump hook: src/main/java/art/arcane/openblocks/command/OBInventoryHooks.java
  • Command inventory subsystem event bridge: src/main/java/art/arcane/openblocks/api/OBInventoryEvent.java
  • Grave drop action event API: src/main/java/art/arcane/openblocks/api/OBGraveDropsEvent.java
  • Grave block + placement/claim wiring:
    • src/main/java/art/arcane/openblocks/block/OBGraveBlock.java
    • src/main/java/art/arcane/openblocks/block/entity/OBGraveBlockEntity.java
    • src/main/java/art/arcane/openblocks/grave/OBGraveHooks.java
  • Block functionality sweep classes:
    • src/main/java/art/arcane/openblocks/block/OBElevatorBlock.java
    • src/main/java/art/arcane/openblocks/block/OBElevatorRotatingBlock.java
    • src/main/java/art/arcane/openblocks/block/OBHealBlock.java
    • src/main/java/art/arcane/openblocks/block/entity/OBHealBlockEntity.java
    • src/main/java/art/arcane/openblocks/block/OBLadderBlock.java
    • src/main/java/art/arcane/openblocks/block/OBPathBlock.java
    • src/main/java/art/arcane/openblocks/block/OBRopeLadderBlock.java
    • src/main/java/art/arcane/openblocks/block/OBSpongeBlock.java
  • Game rule registration: src/main/java/art/arcane/openblocks/world/OBGameRules.java
  • Command flimflam effect registry: src/main/java/art/arcane/openblocks/command/OBFlimFlamEffects.java
  • Capability registration/attachment:
    • src/main/java/art/arcane/openblocks/capability/OBCapabilities.java
  • Custom advancement trigger bootstrap:
    • src/main/java/art/arcane/openblocks/advancement/OBCriterions.java
    • src/main/java/art/arcane/openblocks/advancement/OBBrickDroppedTrigger.java
    • src/main/java/art/arcane/openblocks/advancement/OBDevNullStackTrigger.java
    • src/main/java/art/arcane/openblocks/advancement/OBAdvancementHooks.java
  • Non-full shape helper block: src/main/java/art/arcane/openblocks/block/OBShapeBlock.java
  • Client render-layer setup: src/main/java/art/arcane/openblocks/client/OBClientRenderLayers.java
  • Datagen entrypoint: src/main/java/art/arcane/openblocks/datagen/OBDataGenerators.java
  • Datagen loot providers:
    • src/main/java/art/arcane/openblocks/datagen/OBLootTableProvider.java
    • src/main/java/art/arcane/openblocks/datagen/OBBlockLootSubProvider.java
  • Datagen tag provider:
    • src/main/java/art/arcane/openblocks/datagen/OBBlockTagsProvider.java

Current scaffold counts:

  • Block IDs registered: 41
  • Item IDs registered: 71 (41 block items + 30 standalone)
  • Creative tabs registered: 1 (open_blocks:main)
  • Fluid types registered: 1 (xpjuice)
  • Fluids registered: 2 (xpjuice, flowing_xpjuice)
  • Fluid blocks registered: 1 (xpjuice)
  • Block entity types registered: 35
  • Entity types registered: 11
  • Sound events registered: 19
  • Enchantments registered: 3
  • Menu types registered: 14
  • Recipe serializers registered: 8
  • Command roots wired: 3 (flimflam, luck, ob_inventory)
  • Custom capabilities wired: 3 (open_blocks:luck, open_blocks:pedometer_state, open_blocks:bowels)
  • Custom advancement triggers wired: 2 (open_blocks:brick_dropped, open_blocks:dev_null_stacked)

Current asset coverage:

  • Blockstates: src/main/resources/assets/open_blocks/blockstates (41 files)
  • Block models: src/main/resources/assets/open_blocks/models/block (41 files)
  • Item models: src/main/resources/assets/open_blocks/models/item (71 files)
  • Language file: src/main/resources/assets/open_blocks/lang/en_us.json
  • Sound definitions: src/main/resources/assets/open_blocks/sounds.json
  • Sound assets: src/main/resources/assets/open_blocks/sounds (legacy OpenBlocks .ogg set copied)
  • Advancement JSON scaffolding:
    • src/main/resources/data/open_blocks/advancements/oops.json
    • src/main/resources/data/open_blocks/advancements/tma2.json
  • Custom recipe placeholder JSONs: src/main/resources/data/open_blocks/recipes (7 files)
  • Generated block loot tables: src/generated/resources/data/open_blocks/loot_tables/blocks (41 files)
  • Generated block tags:
    • src/generated/resources/data/minecraft/tags/blocks/mineable/pickaxe.json
    • src/generated/resources/data/minecraft/tags/blocks/needs_stone_tool.json
    • src/generated/resources/data/minecraft/tags/blocks/climbable.json
  • Imported legacy textures:
    • src/main/resources/assets/open_blocks/textures/block
    • src/main/resources/assets/open_blocks/textures/item

Current validation status:

  • ./gradlew compileJava passes.
  • ./gradlew compileJava runData passes.
  • ./gradlew runData now executes Loot Tables provider and writes 41 block loot tables.
  • ./gradlew runData now also executes Tags for minecraft:block mod id open_blocks and writes 3 baseline block tag files.
  • Custom recipe placeholder JSONs for all 7 legacy custom recipe IDs load with current datagen/compile loop.
  • Legacy ore-dict compatibility tags now use broader forge/minecraft groups + fallback items across 34 updated files in src/main/resources/data/open_blocks/tags/items/legacy_ore_dict.
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after adding OBInventoryEvent store/load bridge wiring for /ob_inventory.
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after adding grave gamerule + drop-backup dump wiring (OBGameRules + OBGraveHooks).
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after deepening grave flow to place+claim baseline (OBGraveBlock, OBGraveBlockEntity, OBGraveHooks, and OBInventoryStore grave helpers).
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after wiring grave drop-action filtering + interaction follow-up (OBGraveDropsEvent, updated OBGraveHooks, and shovel-gated grave claim/death-message interaction in OBGraveBlock + OBGraveBlockEntity).
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after fixing open_blocks:xpjuice client fluid texture extensions in OBFluidTypes to prevent null-sprite crashes in third-party fluid-item renderers.
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after starting a first non-GUI block depth sweep (OBHealBlock/OBHealBlockEntity, OBPathBlock, OBSpongeBlock, plus OBBlocks/OBBlockEntities wiring updates).
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after ladder-domain sweep additions (OBLadderBlock, OBRopeLadderBlock, and OBBlocks wiring) for support/chain/auto-extension behavior.
  • Latest ./gradlew compileJava runData pass (2026-02-09) still succeeds after elevator-domain sweep additions (OBElevatorBlock, OBElevatorRotatingBlock, OBBlocks wiring, and rotating-elevator facing blockstate variants) for baseline bidirectional teleport behavior.
  • Capability scaffold note:
    • Legacy player capability IDs are now registered/attached under open_blocks namespace and clone-copied on respawn (luck, pedometer_state, bowels).
  • Build rule note: build.gradle skips optional jars from extra-mods-1.20.1 when task names include runData/datagen, so datagen is not blocked by unrelated runtime mods.
  • Client asset note: model texture paths must use open_blocks:block/... and open_blocks:item/... (not plural blocks/items) for 1.20 atlas resolution.
  • Fluid client-extension note: third-party renderers that query IClientFluidTypeExtensions directly require non-null still/flowing texture keys; OBFluidTypes now explicitly supplies open_blocks:block/xp_juice_still and open_blocks:block/xp_juice_flowing for open_blocks:xpjuice.
  • Run-log note: run/logs/latest.log had a concrete missing texture warning for open_blocks:paint_mixer (open_blocks:model/paint_mixer).
    • Fixed by switching to atlas-safe open_blocks:block/paint_mixer_model and adding textures/block/paint_mixer_model.png.
  • Legacy remap note:
    • src/main/java/art/arcane/openblocks/registry/OBMissingMappings.java now handles compatibility remaps for missing mappings.
    • Namespace remap coverage: openblocks and OpenBlocks to canonical open_blocks.
    • Alias coverage includes legacy camelCase/compact IDs and lowercased fallback forms for blocks/items/fluids/block entities/menus.
    • Core aliases include:
      • blocks: vacuumhopper, bigbutton, xpbottler, autoanvil, autoenchantmenttable, xpdrain, blockbreaker, blockPlacer, itemDropper, ropeladder, donationStation, paintmixer, paintcan, canvasglass, drawingtable, xpshower, goldenegg
      • items: hangglider, sonicglasses, pencilGlasses, crayonGlasses, technicolorGlasses, seriousGlasses, craneControl, craneBackpack, filledbucket, sleepingBag, paintBrush, heightMap, emptyMap, tastyClay, goldenEye, genericUnstackable, infoBook, devnull, spongeonastick, epicEraser
      • fluid: liquidxp -> xpjuice
  • Systems skeleton note:
    • src/main/java/art/arcane/openblocks/command/OBCommands.java now registers the three legacy command IDs in Brigadier form (flimflam, luck, ob_inventory).
    • src/main/java/art/arcane/openblocks/command/OBInventoryStore.java now provides the breadth-stage inventory dump backend used by /ob_inventory.
    • src/main/java/art/arcane/openblocks/command/OBInventoryHooks.java now stores command-consumable inventory dumps on player death.
    • src/main/java/art/arcane/openblocks/api/OBInventoryEvent.java now mirrors legacy inventory store/load event semantics for arbitrary subsystem payload IDs.
    • src/main/java/art/arcane/openblocks/api/OBGraveDropsEvent.java now mirrors legacy grave drop-action event semantics (STORE/DROP/DELETE) for grave filtering hooks.
    • src/main/java/art/arcane/openblocks/world/OBGameRules.java now registers legacy grave gamerule key openblocks:spawn_graves (default true).
    • src/main/java/art/arcane/openblocks/block/OBGraveBlock.java + src/main/java/art/arcane/openblocks/block/entity/OBGraveBlockEntity.java now provide placeable grave state with persisted dump metadata, death message display on normal interaction, and shovel-gated loot claim behavior.
    • src/main/java/art/arcane/openblocks/block/OBHealBlock.java + src/main/java/art/arcane/openblocks/block/entity/OBHealBlockEntity.java now provide periodic server-side healing/saturation aura behavior for nearby non-creative players.
    • src/main/java/art/arcane/openblocks/block/OBElevatorBlock.java now provides baseline elevator teleport flow (right-click up / sneak-right-click down) with travel/blocker limits and safe destination checks.
    • src/main/java/art/arcane/openblocks/block/OBElevatorRotatingBlock.java now extends baseline elevator teleport flow with facing-based player yaw alignment on arrival.
    • src/main/java/art/arcane/openblocks/block/OBLadderBlock.java now enforces north-face support survival for open_blocks:ladder.
    • src/main/java/art/arcane/openblocks/block/OBPathBlock.java now enforces support-below survival and drops itself when support is removed.
    • src/main/java/art/arcane/openblocks/block/OBRopeLadderBlock.java now supports chain survival, survival-mode downward auto-extension on placement, and cascading chain removal.
    • src/main/java/art/arcane/openblocks/block/OBSpongeBlock.java now performs periodic liquid cleanup, lava burn fallback, and border-fluid wake-up scheduling on removal.
    • src/main/java/art/arcane/openblocks/grave/OBGraveHooks.java now writes grave backup dumps, posts/consumes OBGraveDropsEvent action filtering, searches for valid placement nearby, places grave blocks on successful death handling, and clears only stored grave drops when grave placement succeeds.
    • src/main/java/art/arcane/openblocks/command/OBFlimFlamEffects.java now provides executable breadth-stage actions for all legacy /flimflam effect IDs.
    • Current command parity:
      • luck reads/writes open_blocks:luck capability state.
      • flimflam now executes a 17-effect action map with legacy ID names preserved; deeper legacy parity (luck/cost/weight/blacklist semantics and exact per-effect behavior) remains pending.
      • ob_inventory now supports main + built-in sub-inventory dump/restore/spawn:
        • dumps written to <world>/data/inventory-*.dat,
        • restore loads stored main inventory onto target player,
        • restore also reapplies serialized ender chest payload when present,
        • spawn drops target inventory stacks (or selected slot) at command source for main, armor, offhand, and ender_chest,
        • store/restore now also round-trip arbitrary sub-inventory payload maps through OBInventoryEvent.Store/OBInventoryEvent.Load,
        • dump root now includes player Location metadata (X,Y,Z,Dimension) for future grave/backend integrations.
        • grave backup dump writes/reads/deletes are now available via OBInventoryStore.storeDroppedItems(...), OBInventoryStore.readDroppedItems(...), and OBInventoryStore.deleteDump(...) and are consumed by the grave place/claim flow.
      • legacy arbitrary subsystem payload consumers/producers remain pending; grave parity now includes baseline drop-action filtering, but still lacks richer metadata/placement depth and concrete external grave event integrations.
    • /luck state storage now reads/writes through OBCapabilities (open_blocks:luck) rather than ad-hoc player persistent data.
    • src/main/java/art/arcane/openblocks/capability/OBCapabilities.java now registers and attaches legacy player capability IDs (open_blocks:luck, open_blocks:pedometer_state, open_blocks:bowels) and copies them during PlayerEvent.Clone (except bowels on death clones, to avoid duplicate death-drop state).
    • OBCapabilities.PedometerState now includes runtime/report helpers (reset, start, tick, stop, createReport) and report DTO data used by pedometer messaging.
    • src/main/java/art/arcane/openblocks/advancement/OBCriterions.java now registers custom trigger IDs open_blocks:brick_dropped and open_blocks:dev_null_stacked for advancement compatibility baseline.
    • src/main/java/art/arcane/openblocks/advancement/OBAdvancementHooks.java now wires initial trigger/capability gameplay hooks:
      • tasty_clay consume increments bowels count,
      • brick toss conditionally fires brick_dropped and decrements bowels for survival players,
      • LivingDropsEvent emits up to 16 brick drops from bowels count and clears stored bowels state,
      • PlayerTickEvent now performs baseline pedometer sampling while a pedometer is present in hotbar and tracking is active,
      • periodic placeholder inventory scan approximates dev-null depth and fires dev_null_stacked.
    • src/main/java/art/arcane/openblocks/registry/OBItems.java now sets parity-critical item properties:
      • tasty_clay is edible,
      • dev_null and generic_unstackable are stack size 1.
      • pedometer is stack size 1.
    • src/main/java/art/arcane/openblocks/item/OBPedometerItem.java now provides explicit pedometer interaction flow:
      • right-click starts tracking,
      • sneak-right-click resets tracking,
      • right-click while running prints report lines using legacy pedometer lang keys.

Top-Level Entry Points

  • Mod entrypoint and major registration flow:
    • old-1.12.2/src/main/java/openblocks/OpenBlocks.java
  • Config-driven registration + enchantments + meta items:
    • old-1.12.2/src/main/java/openblocks/Config.java
  • Custom recipe registry event:
    • old-1.12.2/src/main/java/openblocks/CustomRecipesSetup.java
  • GUI handler (luggage + dev null):
    • old-1.12.2/src/main/java/openblocks/OpenBlocksGuiHandler.java
  • API provider bootstrap:
    • old-1.12.2/src/main/java/openblocks/ApiSetup.java

Registry Surface Summary

  • @RegisterBlock entries: 41
  • @RegisterItem entries: 30
  • Primary fluid(s): 1 (xpjuice)
  • Enchantments: 3
  • Sound events registered in code: 19
  • Mod entities registered in code: 11
  • Block entities referenced by block registration: 35
  • Custom code-registered recipes: 7
  • Commands: 3
  • Custom advancements/triggers: 2
  • Custom capabilities: 3

Legacy Recipe Corpus Snapshot

Source: old-1.12.2/src/main/resources/assets/openblocks/recipes

  • Total recipe files: 189
  • Top-level recipe types:
    • forge:ore_shaped: 107
    • forge:ore_shapeless: 78
    • openmods:enchanting: 4
  • Existing 1.20 scaffold recipes currently present:
    • src/main/resources/data/open_blocks/recipes (7 custom serializer placeholders from CustomRecipesSetup + 1 custom flim-flam replacement recipe)
  • Mechanical conversion output now present:
    • src/main/resources/data/open_blocks/recipes/legacy (185 converted crafting recipes)
    • src/main/resources/data/open_blocks/tags/items/legacy_ore_dict (35 compatibility item-tag files for former ore-dict names)
    • Converted types:
      • forge:ore_shaped -> minecraft:crafting_shaped
      • forge:ore_shapeless -> minecraft:crafting_shapeless
    • Conversion baseline details:
      • legacy openblocks:* IDs remapped to open_blocks:*
      • legacy metadata (data) collapsed to modern single-ID forms for breadth coverage
      • ore dictionary entries translated to open_blocks:legacy_ore_dict/* tags (now populated with broader forge/minecraft group tags plus vanilla fallback items)
    • Legacy openmods:enchanting replacements:
      • open_blocks:flim_flam_book custom crafting recipe implemented in:
        • src/main/java/art/arcane/openblocks/recipe/OBFlimFlamBookRecipe.java
        • src/main/resources/data/open_blocks/recipes/flim_flam_book.json
  • Known conversion blockers (breadth-pass):
    • Ore dictionary ingredient conversion (forge:ore_dict -> modern tags).
    • Metadata-based result variants (data field) for color/state/meta-item fidelity.
    • Metadata/meta-item fidelity for converted legacy recipes still needs a depth pass.

Blocks (OpenBlocks.Blocks)

Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java

ID Block Class Field Tile Entity ItemBlock / Item Wrapper Legacy IDs / Notes
ladder BlockLadder Blocks.ladder - default -
guide BlockGuide Blocks.guide TileEntityGuide ItemGuide -
builder_guide BlockBuilderGuide Blocks.builderGuide TileEntityBuilderGuide ItemGuide -
elevator BlockElevator Blocks.elevator - ItemElevator registerDefaultItemModel = false
elevator_rotating BlockElevatorRotating Blocks.elevatorRotating TileEntityElevatorRotating ItemElevator registerDefaultItemModel = false
heal BlockHeal Blocks.heal TileEntityHealBlock default -
target BlockTarget Blocks.target TileEntityTarget default -
grave BlockGrave Blocks.grave TileEntityGrave default -
flag BlockFlag Blocks.flag TileEntityFlag ItemFlagBlock -
tank BlockTank Blocks.tank TileEntityTank ItemTankBlock -
trophy BlockTrophy Blocks.trophy TileEntityTrophy ItemTrophyBlock -
beartrap BlockBearTrap Blocks.bearTrap TileEntityBearTrap default -
sprinkler BlockSprinkler Blocks.sprinkler TileEntitySprinkler default -
cannon BlockCannon Blocks.cannon TileEntityCannon default OpenBlock TESR path
vacuum_hopper BlockVacuumHopper Blocks.vacuumHopper TileEntityVacuumHopper default vacuumhopper
sponge BlockSponge Blocks.sponge - default -
big_button BlockBigButton Blocks.bigButton TileEntityBigButton default bigbutton
big_button_wood BlockBigButtonWood Blocks.bigButtonWood TileEntityBigButtonWood default -
imaginary BlockImaginary Blocks.imaginary TileEntityImaginary ItemImaginary custom item models; no default model
fan BlockFan Blocks.fan TileEntityFan default -
xp_bottler BlockXPBottler Blocks.xpBottler TileEntityXPBottler default xpbottler
village_highlighter BlockVillageHighlighter Blocks.villageHighlighter TileEntityVillageHighlighter default -
path BlockPath Blocks.path - default -
auto_anvil BlockAutoAnvil Blocks.autoAnvil TileEntityAutoAnvil default autoanvil
auto_enchantment_table BlockAutoEnchantmentTable Blocks.autoEnchantmentTable TileEntityAutoEnchantmentTable default autoenchantmenttable
xp_drain BlockXPDrain Blocks.xpDrain TileEntityXPDrain default xpdrain
block_breaker BlockBlockBreaker Blocks.blockBreaker TileEntityBlockBreaker default blockbreaker
block_placer BlockBlockPlacer Blocks.blockPlacer TileEntityBlockPlacer default blockPlacer
item_dropper BlockItemDropper Blocks.itemDropper TileEntityItemDropper default itemDropper
rope_ladder BlockRopeLadder Blocks.ropeLadder - default ropeladder
donation_station BlockDonationStation Blocks.donationStation TileEntityDonationStation default donationStation
paint_mixer BlockPaintMixer Blocks.paintMixer TileEntityPaintMixer default paintmixer
canvas BlockCanvas Blocks.canvas TileEntityCanvas default -
paint_can BlockPaintCan Blocks.paintCan TileEntityPaintCan ItemPaintCan paintcan
canvas_glass BlockCanvasGlass Blocks.canvasGlass TileEntityCanvasGlass default canvasglass
projector BlockProjector Blocks.projector TileEntityProjector default -
drawing_table BlockDrawingTable Blocks.drawingTable TileEntityDrawingTable default drawingtable
sky BlockSky Blocks.sky TileEntitySky ItemSkyBlock unlocalized sky.normal
xp_shower BlockXPShower Blocks.xpShower TileEntityXPShower default xpshower
golden_egg BlockGoldenEgg Blocks.goldenEgg TileEntityGoldenEgg default goldenegg
scaffolding BlockScaffolding Blocks.scaffolding - BlockScaffolding.Item -

Items (OpenBlocks.Items)

Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java

ID Item Class Field Legacy IDs / Notes
hang_glider ItemHangGlider Items.hangGlider hangglider
generic ItemOBGeneric Items.generic no default model; meta item holder
luggage ItemLuggage Items.luggage -
sonic_glasses ItemSonicGlasses Items.sonicGlasses sonicglasses
pencil_glasses ItemImaginationGlasses Items.pencilGlasses pencilGlasses, unlocalized glasses.pencil
crayon_glasses ItemCrayonGlasses Items.crayonGlasses crayonGlasses, unlocalized glasses.crayon
technicolor_glasses ItemImaginationGlasses Items.technicolorGlasses technicolorGlasses, unlocalized glasses.technicolor
serious_glasses ItemImaginationGlasses Items.seriousGlasses seriousGlasses, unlocalized glasses.admin
crane_control ItemCraneControl Items.craneControl craneControl
crane_backpack ItemCraneBackpack Items.craneBackpack craneBackpack
slimalyzer ItemSlimalyzer Items.slimalyzer -
xp_bucket ItemXpBucket Items.xpBucket filledbucket
sleeping_bag ItemSleepingBag Items.sleepingBag sleepingBag
paintbrush ItemPaintBrush Items.paintBrush paintBrush
stencil ItemStencil Items.stencil no default model
squeegee ItemSqueegee Items.squeegee -
height_map ItemHeightMap Items.heightMap heightMap
empty_map ItemEmptyMap Items.emptyMap emptyMap
cartographer ItemCartographer Items.cartographer -
tasty_clay ItemTastyClay Items.tastyClay tastyClay
golden_eye ItemGoldenEye Items.goldenEye goldenEye
generic_unstackable ItemOBGenericUnstackable Items.genericUnstackable no default model; genericUnstackable
cursor ItemCursor Items.cursor -
info_book ItemInfoBook Items.infoBook infoBook
dev_null ItemDevNull Items.devNull devnull
sponge_on_a_stick ItemSpongeOnAStick Items.spongeonastick spongeonastick
pedometer ItemPedometer Items.pedometer -
epic_eraser ItemEpicEraser Items.epicEraser epicEraser
wrench ItemWrench Items.wrench -
glyph ItemGlyph Items.glyph -

Meta Item Registries

Source:

  • old-1.12.2/src/main/java/openblocks/common/item/MetasGeneric.java

  • old-1.12.2/src/main/java/openblocks/common/item/MetasGenericUnstackable.java

  • Items.generic (ItemOBGeneric) variants:

    • glider_wing
    • beam
    • crane_engine
    • crane_magnet
    • miracle_magnet (conditional: OpenPeripheralCore + config)
    • line
    • map_controller
    • map_memory
    • cursor (deprecated placeholder, disabled)
    • assistant_base
    • unprepared_stencil
    • sketching_pencil

  • Items.genericUnstackable (ItemOBGenericUnstackable) variants:

    • pointer

Legacy Creative Tab Behavior (Model/Lang Parity Critical)

Primary sources:

  • old-1.12.2/src/main/java/openblocks/OpenBlocks.java (createTabOpenBlocks, setupConfigPre)
  • Item/block classes with getSubItems overrides under old-1.12.2/src/main/java/openblocks/common/item

Core behavior:

  • setupConfigPre sets one shared creative tab for registered OpenBlocks content: gameConfig.setCreativeTab(OpenBlocks::createTabOpenBlocks).
  • Tab icon is Blocks.flag with default color, fallback minecraft:sponge if flag is disabled/unavailable.
  • Tab appends enchanted books for explosive, last_stand, and flim_flam when those enchantments are registered.

Important item variant behavior in legacy tab:

  • ItemElevator: exposes 16 color metadata variants.
  • ItemPaintCan: exposes one full can per color.
  • ItemSkyBlock: exposes normal + inverted variants.
  • ItemTrophyBlock: exposes one stack per trophy/entity type.
  • ItemImaginary: exposes pencil + all crayon colors.
  • ItemPaintBrush: exposes blank + colored variants.
  • ItemStencil: exposes all stencil patterns.
  • ItemEmptyMap: exposes scale variants (0..3).
  • ItemGoldenEye: exposes charged and depleted states.
  • ItemGlyph: exposes display character set in OpenBlocks tab; optionally full charset in Search tab (config-controlled).
  • ItemImaginationGlasses.ItemCrayonGlasses: exposes one pair per color.
  • ItemCartographer: exposes all assistant type variants (currently one enum value).
  • ItemXpBucket: only appears when Config.showXpBucketInCreative is true.
  • ItemHeightMap: intentionally hidden from creative tab (getSubItems is empty).

Port implication:

  • Current 1.20.1 breadth scaffold intentionally shows one stack per registry ID in the creative tab.
  • Metadata/NBT creative-variant parity is a later depth pass item.

Fluids

Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java

  • Registered fluid object:
    • ID: xpjuice
    • Field: OpenBlocks.Fluids.xpJuice
    • Texture RLs: openblocks:blocks/xp_juice_still, openblocks:blocks/xp_juice_flowing
  • Registration occurs in OpenBlocks.preInit:
    • FluidRegistry.registerFluid(Fluids.xpJuice)
    • optional FluidRegistry.addBucketForFluid(Fluids.xpJuice) when enabled
  • XP conversion system:
    • old-1.12.2/src/main/java/openblocks/common/FluidXpUtils.java
    • supports additional fluid mappings from config (Config.additionalXpFluids)
  • Note: assets/openblocks/blockstates/xp_bucket.json references liquidxp string.

Enchantments

Source: old-1.12.2/src/main/java/openblocks/Config.java

  • Registered enchantments:
    • openblocks:explosive (EnchantmentExplosive)
    • openblocks:last_stand (EnchantmentLastStand)
    • openblocks:flim_flam (EnchantmentFlimFlam)
  • Object holders:
    • OpenBlocks.Enchantments in OpenBlocks.java

Sounds

Source:

  • Registration code: old-1.12.2/src/main/java/openblocks/OpenBlocks.java
  • Definitions: old-1.12.2/src/main/resources/assets/openblocks/sounds.json

Registered in code (19):

  • elevator.activate
  • grave.rob
  • crayon.place
  • luggage.walk
  • luggage.eat.food
  • luggage.eat.item
  • pedometer.use
  • slimalyzer.signal
  • squeegee.use
  • best.feature.ever.fart
  • annoying.mosquito
  • annoying.alarmclock
  • annoying.vibrate
  • beartrap.open
  • beartrap.close
  • cannon.activate
  • target.open
  • target.close
  • bottler.signal

Additional keys present in sounds.json but not registered in code:

  • radio.activate
  • unused.mortar

Entities

Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java

Registered mod entities:

  • openblocks:luggage -> EntityLuggage (legacy numeric ID constant 702)
  • openblocks:xp_orb_no_fly -> EntityXPOrbNoFly (709)
  • openblocks:hang_glider -> EntityHangGlider (701)
  • openblocks:magnet -> EntityMagnet (703)
  • openblocks:mounted_block -> EntityMountedBlock (704)
  • openblocks:player_magnet -> EntityMagnet.PlayerBound (708)
  • openblocks:cartographer -> EntityCartographer (705)
  • openblocks:item_projectile -> EntityItemProjectile (706)
  • openblocks:golden_eye -> EntityGoldenEye (707)
  • openblocks:mini_me -> EntityMiniMe (710)
  • openblocks:glyph -> EntityGlyph (711)

Entity package inventory:

  • old-1.12.2/src/main/java/openblocks/common/entity
  • Not directly registered as mod entities but present as helpers/base classes:
    • EntityAssistant
    • EntityMount
    • EntitySmoothMove

Block Entities (Tile Entities)

Source package:

  • old-1.12.2/src/main/java/openblocks/common/tileentity

Registered through block annotations (35 references):

  • TileEntityGuide
  • TileEntityBuilderGuide
  • TileEntityElevatorRotating
  • TileEntityHealBlock
  • TileEntityTarget
  • TileEntityGrave
  • TileEntityFlag
  • TileEntityTank
  • TileEntityTrophy
  • TileEntityBearTrap
  • TileEntitySprinkler
  • TileEntityCannon
  • TileEntityVacuumHopper
  • TileEntityBigButton
  • TileEntityBigButtonWood
  • TileEntityImaginary
  • TileEntityFan
  • TileEntityXPBottler
  • TileEntityVillageHighlighter
  • TileEntityAutoAnvil
  • TileEntityAutoEnchantmentTable
  • TileEntityXPDrain
  • TileEntityBlockBreaker
  • TileEntityBlockPlacer
  • TileEntityItemDropper
  • TileEntityDonationStation
  • TileEntityPaintMixer
  • TileEntityCanvas
  • TileEntityPaintCan
  • TileEntityCanvasGlass
  • TileEntityProjector
  • TileEntityDrawingTable
  • TileEntitySky
  • TileEntityXPShower
  • TileEntityGoldenEgg

Helper/base tile entity class in package (not directly registered from block annotations):

  • TileEntityBlockManipulator

Containers and GUIs

Primary GUI source files:

  • old-1.12.2/src/main/java/openblocks/OpenBlocksGuiHandler.java
  • old-1.12.2/src/main/java/openblocks/common/container/*
  • old-1.12.2/src/main/java/openblocks/client/gui/*

Non-tile GUI IDs via OpenBlocksGuiHandler.GuiId:

  • luggage -> ContainerLuggage / GuiLuggage
  • devNull -> ContainerDevNull / GuiDevNull

Tile-based container/gui providers (via IHasGui in tile entities):

  • TileEntityAutoEnchantmentTable -> ContainerAutoEnchantmentTable / GuiAutoEnchantmentTable
  • TileEntityDonationStation -> ContainerDonationStation / GuiDonationStation
  • TileEntityProjector -> ContainerProjector / GuiProjector
  • TileEntityDrawingTable -> ContainerDrawingTable / GuiDrawingTable
  • TileEntityBigButton -> ContainerBigButton / GuiBigButton
  • TileEntityItemDropper -> ContainerItemDropper / GuiItemDropper
  • TileEntitySprinkler -> ContainerSprinkler / GuiSprinkler
  • TileEntityVacuumHopper -> ContainerVacuumHopper / GuiVacuumHopper
  • TileEntityBlockPlacer -> ContainerBlockPlacer / GuiBlockPlacer
  • TileEntityAutoAnvil -> ContainerAutoAnvil / GuiAutoAnvil
  • TileEntityXPBottler -> ContainerXPBottler / GuiXPBottler
  • TileEntityPaintMixer -> ContainerPaintMixer / GuiPaintMixer

Recipes

Custom code-registered recipes:

  • Source: old-1.12.2/src/main/java/openblocks/CustomRecipesSetup.java
  • IDs:
    • openblocks:crayon_merge
    • openblocks:crayon_mix
    • openblocks:crayon_glasses
    • openblocks:map_clone
    • openblocks:map_resize
    • openblocks:golden_eye_recharge
    • openblocks:epic_eraser_action

Data recipes:

  • Folder: old-1.12.2/src/main/resources/assets/openblocks/recipes
  • File count: 189 JSON recipes

Networking, RPC, Sync Registries

Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java

Custom sync type registry (RegistryEvent.Register<SyncableObjectType>):

  • EntityCartographer.MapJobs
  • SyncableBlockLayers

RPC method registry (RegistryEvent.Register<MethodEntry>):

  • IRotatable
  • IStencilCrafter
  • IColorChanger
  • ILevelChanger
  • ITriggerable
  • IGuideAnimationTrigger
  • IItemDropper

Network event registry (RegistryEvent.Register<NetworkEventEntry>):

  • MapDataManager.MapDataRequestEvent
  • MapDataManager.MapDataResponseEvent
  • MapDataManager.MapUpdatesEvent
  • ElevatorActionEvent
  • PlayerActionEvent
  • GuideActionEvent
  • EntityMiniMe.OwnerChangeEvent

Capabilities

Sources:

  • old-1.12.2/src/main/java/openblocks/rubbish/BrickManager.java
  • old-1.12.2/src/main/java/openblocks/common/PedometerHandler.java
  • old-1.12.2/src/main/java/openblocks/enchantments/FlimFlamEnchantmentsHandler.java

Registered capability sets:

  • openblocks:bowels -> BrickManager.BowelContents
  • openblocks:pedometer_state -> PedometerHandler.PedometerState
  • openblocks:luck -> FlimFlamEnchantmentsHandler.Luck

Advancements and Triggers

Sources:

  • Trigger registration: old-1.12.2/src/main/java/openblocks/advancements/Criterions.java
  • Trigger classes:
    • TriggerDevNullStack -> trigger ID openblocks:dev_null_stacked
    • TriggerBrickDropped -> trigger ID openblocks:brick_dropped
  • Advancement JSON files:
    • old-1.12.2/src/main/resources/assets/openblocks/advancements/oops.json
    • old-1.12.2/src/main/resources/assets/openblocks/advancements/tma2.json

Loot Injection

Source:

  • Code: old-1.12.2/src/main/java/openblocks/common/LootHandler.java
  • Data: old-1.12.2/src/main/resources/assets/openblocks/loot_tables/inject/technicolor_glasses.json

Injection behavior:

  • Registers loot table openblocks:inject/technicolor_glasses
  • Injects into:
    • minecraft:chests/abandoned_mineshaft
    • minecraft:chests/simple_dungeon

Other Registries and Global Hooks

  • Villager profession registry:
    • Source: old-1.12.2/src/main/java/openblocks/common/RadioVillagerTrades.java
    • Registers profession openblocks:radio, career audiophile
  • Ore dictionary:
    • Source: old-1.12.2/src/main/java/openblocks/OpenBlocks.java
    • craftingTableWood
    • chestWood
  • Game rule registration:
    • Source: old-1.12.2/src/main/java/openblocks/common/GameRuleManager.java
    • Adds openblocks:spawn_graves
  • Commands (server start):
    • flimflam (CommandFlimFlam)
    • luck (CommandLuck)
    • ob_inventory (CommandInventory)

Client-Side Registration Hotspots

  • Main client proxy:
    • old-1.12.2/src/main/java/openblocks/client/ClientProxy.java
  • Block/item color handlers:
    • old-1.12.2/src/main/java/openblocks/client/BlockColorHandlerRegistration.java
  • TESR bindings, entity renderers, custom model loader IDs (magic-devnull, magic-path, magic-stencil, magic-canvas, magic-glyph) in ClientProxy.

Assets Structure Snapshot

  • assets/openblocks/blockstates -> 48 JSON
  • assets/openblocks/models/item -> 59 JSON
  • assets/openblocks/recipes -> 189 JSON
  • assets/openblocks/sounds.json + sound OGG files in assets/openblocks/sounds
  • assets/openblocks/loot_tables/inject -> loot injection data
  • assets/openblocks/advancements -> advancement JSONs

Notable Unused/Inactive or Special Cases

  • old-1.12.2/src/main/resources/assets/openblocks/blockstates/temp.json exists and appears unused.
  • Integration modules are present but registration calls are commented out in OpenBlocks.preInit:
    • ModuleAdapters
    • ModuleTurtles
  • old-1.12.2/OpenModsLib submodule contents are absent in this snapshot (folder is empty).