Memorie Core: Developer Framework - V1.1.0

Memorie Core is a high-performance, modular infrastructure designed for Minecraft Bedrock Addon Creators. It provides a suite of data-driven APIs that allow developers to implement complex features — like real-time lighting — without touching player.json, ensuring maximum compatibility with other addons.

🚀 Built to Expand

This framework is designed to simplify addon development. While it starts with a Dynamic Lighting Engine and a Backpack API, Memorie Core is evolving to handle more complex tasks. Instead of writing hundreds of lines of code, you just tag your item, and the core handles the rest.

✅ Module: Dynamic Light API

Integrate real-time lighting into your items using a Tag-Based System. No scripting required — add the tags to your item's JSON and the Core handles placement, cleanup, and multiplayer sync automatically.

Main & Off-hand Support: Items emit light when held in either hand.
Wearable Light: Armor and headgear can emit light when equipped.
Dropped Item Emission: Items on the ground illuminate their surroundings.
Underwater Logic: Dedicated tags let you control which items work submerged. Water detection uses separate Y offsets for dropped items and players, ensuring accurate behavior in both cases.
Multiplayer Optimized: A shared registry prevents flickering and ensures lights are only removed when no players need them.

Implementation example — add any combination of these tags to your item:

{
    "format_version": "1.26.0",
    "minecraft:item": {
        "description": {
            "identifier": "yournamespace:your_item"
        },
        "components": {
            "minecraft:max_stack_size": 1,
            "minecraft:allow_off_hand": true,
            // This item can be equipped in the head slot.
            // When combined with armor_light, it illuminates while worn.
            "minecraft:wearable": {
                "slot": "slot.armor.head",
                "protection": 1
            },
            "minecraft:tags": {
                "tags": [
                    // Light 15 when holding it in the main hand.
                    "memorie:hand_light_15",
                    // Light 15 when holding it in the off-hand.
                    "memorie:offhand_light_15",
                    // Light 15 when worn in any armor slot.
                    "memorie:armor_light_15",
                    // Light 15 when dropped on the ground.
                    "memorie:drop_light_15",
                    // Light 15 ONLY when the player is underwater.
                    // Replaces hand/offhand/armor/drop while submerged.
                    "memorie:water_light_15",
                    // Light 15 when this item is stored inside
                    // a Memorie Core backpack in the player's inventory.
                    // Does not require the player to hold the item.
                    "memorie:content_light_15"
                ]
            }
        }
    }
}

Valid light range: 1 (barely visible) to 15 (equivalent to a torch). Tags can be freely combined on the same item.

✅ Module: Backpack API

A fully data-driven inventory system that lets players carry persistent, independent storage. The Core handles the entity, inventory, lock, lore, and persistence automatically — you only define the tags.

Persistent Storage: Each backpack has its own inventory, saved and restored across sessions.
Tier Support: Define different backpack sizes and display names through item tags alone.
Backpack Light: Items inside a backpack can passively illuminate the player — no need to hold it. Use memorie:content_light_<1-15> on any item.
Portal Safe: Backpack state is preserved when traveling through Nether and End portals.

⚠️ UI files are not included. Memorie Core does not ship inventory UI definitions. Without custom UI JSON files, the backpack screen will always render as a 27-slot grid regardless of the slot count defined in your tags. You are responsible for creating the UI layout that matches your backpack's size.

Implementation example — this is all you need to define a backpack item:

{
    "format_version": "1.26.0",
    "minecraft:item": {
        "description": {
            "identifier": "yournamespace:your_backpack",
            // "none" hides the item from the creative inventory.
            // Change to "items" or "equipment" to make it obtainable.
            "menu_category": {
                "category": "none"
            }
        },
        "components": {
            "minecraft:display_name": {
                "value": "My Backpack"
            },
            // Backpacks must always have a stack size of 1.
            "minecraft:max_stack_size": 1,
            "minecraft:allow_off_hand": true,
            "minecraft:tags": {
                "tags": [
                    // REQUIRED: Marks this item as a backpack and sets
                    // its inventory size. Valid range: 1 – 256 slots.
                    "memorie:backpack_27",
                    // OPTIONAL: Label shown in the item lore as "Type: ...".
                    // If omitted, the lore will display the slot count instead.
                    "memorie:type_My Backpack"
                ]
            }
        }
    }
}

The lore (ID, Owner, Type) is written automatically by the Core — do not define it yourself.

🧠 Technical Specifications

Zero Conflict: 100% compatible with addons modifying player.json.
Smart Scanning: Optimized 24-block entity scan to maintain server performance.
Ghost Light Prevention: Built-in cleanup system for bugged light blocks.
Requirement: Minecraft Bedrock 1.26+.

⚖️ License & Mandatory Credits

This library is free to use in any project (including commercial ones) under the CC BY 4.0 License, provided you follow these rules:

Credit: You must mention Memorie Studio in your addon's description.
Link: You must provide a link back to this Memorie Core page.

💙 Support

Memorie Core is a free resource for the community.

👉 Support us on Ko-fi (Click Here) 👈

Memorie Core Framework — Memorie Studio

Memorie Core V1.1.0 - Backpacks!!! [DISCONTINUED]