Anime Hologram

Overview
- Render 3D “holograms” inside tinted-glass cuboids and control them entirely with redstone.
- Bring your own models and animations (none are bundled).
- Powered by the BlazeRod rendering library.
- Server play is currently not tested.

Features
- BlazeRod-based rendering, with a stable CPU transform path by default.
- External VMD animation support for PMX/PMD models. Drop .vmd files next to the model.
- Universal Edge Bus (UEB) redstone control:
  - Model code: 0–255
  - Animation code: 0–255 (0 = rest pose)
  - Ctrl code: 0–15 (reserved for future use)
  - Param bus (scale/offsets), quantized 0–15
- Helpful commands to detect, map, watch, and manage cuboids.
- Clickable TP coordinates in the /holo map output.

Requirements
- Minecraft: 1.21.8
- Fabric Loader
- Fabric API
- Fabric Language Kotlin

How to use
1) Build a filled tinted-glass cuboid anywhere in the world.
2) Use /holo watch while looking at a tinted glass block (or let auto-watch pick it up).
3) Place your model content in your Minecraft run directory (not inside the mod jar):
   - Windows: %appdata%/.minecraft/hologram/models/
   - Linux: ~/.minecraft/hologram/models/
4) Select model/animation via redstone or commands.

Content folder structure
- One folder per model code (3-digit, zero-padded):
  - hologram/models/003/
    - model.pmx (.pmd/.glb/.gltf/.vrm also supported)
    - Idle.vmd, Walk.vmd, etc. (optional; VMD for PMX/PMD)
    - manifest.json (optional)

Optional manifest.json
- Place next to your model:
```json
{
  "file": "model.pmx",
  "scale": 1.0,
  "offset": [0.0, 0.0, 0.0],
  "defaultAnimation": 0
}
```
- file: picks a model file (otherwise the first supported file is used)
- scale/offset: default transform applied to the hologram root
- defaultAnimation: ignored when anim=0 (since anim=0 is rest pose)

Supported formats
- Models: .pmx, .pmd, .vrm, .glb, .gltf
- Animations: .vmd (MMD; expects PMX/PMD rigs with matching bones)

Redstone: Universal Edge Bus (UEB)
- The mod reads redstone from the cuboid edges:
  - Bottom edges → Model bits (8)
  - Top edges → Anim bits (8)
  - Vertical edges (middle Y centers) → Ctrl bits (4)
- If a bus can only fit a single port on a small cuboid, it falls back to an analog nibble (0..15) at that one position.
- Use /holo map to print clickable coordinates for all bus ports and the param bus.

Parameter bus (analog, middle face centers)
- scaleQ: north face center
- offXQ: east face center
- offYQ: south face center
- offZQ: west face center
- Quantization: 0..15 (0 = inactive; use manifest defaults)
- Client mapping:
  - Scale: 0.25 + (scaleQ / 15) * 1.75 (if scaleQ > 0), else 1.0
  - Offsets: (Q − 8) / 8.0 (if Q > 0), else 0.0

Animation behavior
- anim=0 → rest pose (no animation applied)
- anim=1..N → clip indices 0..N−1 (wraps if out of range)
- On clip change: the mod resets relative transforms and morphs for a clean start.

Commands
- /holo detect [x y z]
  - Detect cuboid bounds/size for where you’re looking or a position.
- /holo map [x y z]
  - Print the bus layout (Model/Anim/Ctrl ports + Param ports).
  - Coordinates are clickable:
    - OP (permission ≥ 2): click to teleport.
    - Non‑OP: click to get a suggested /tp command in chat.
- /holo codes [x y z]
  - Print current Model/Anim/Ctrl codes for that cuboid.
- /holo setcodes <model> <anim> <ctrl> [x y z]
  - Set codes and broadcast instantly to clients.
  - Requires OP (permission level 2).
- /holo watch [x y z]
  - Start watching a cuboid (bus is read and broadcast).
- /holo unwatch [x y z]
  - Stop watching a cuboid.

Tips
- To play animation 10, set anim bus = 10:
  - Command: /holo setcodes <model> 10 <ctrl> (OP only)
  - Redstone: power anim bus ports that sum to 10, or feed strength 10 to the analog fallback.
- To select model folder 003, set model bus = 3.

Troubleshooting
- Nothing renders:
  - Ensure you’re watching the cuboid (/holo watch).
  - Ensure your model folder exists and contains a supported model file.
- VMD doesn’t play:
  - Use PMX/PMD models; ensure VMD files are next to the model file.
  - Check client log for “Loaded scene ... animations=K”; K=0 means no usable clips were found.
- Weird pose when switching animations:
  - The mod resets pose on clip change. If issues persist, the rig or channel mapping may be unusual—please report the model format/rig.

Content policy
- No models are bundled with this mod. You must supply your own content.
- The included screenshots/videos are for demonstration only and are not part of the mod jar.

Credits
- Rendering library: BlazeRod by Fifth Light (aka fifth_light). Thank you for the renderer and format loaders.
- This project does not redistribute BlazeRod source; BlazeRod JARs are included jar‑in‑jar for convenience.

License
- This mod: GPLv3.
- BlazeRod: LGPL 3.0.
- Third‑party models/media remain the property of their authors and are subject to their own licenses.

Overview

• Render 3D “holograms” inside tinted-glass cuboids and control them entirely with redstone.
• Bring your own models and animations (none are bundled).
• Powered by the BlazeRod rendering library.
• Server play is currently not tested.

Features

• BlazeRod-based rendering, with a stable CPU transform path by default.
• External VMD animation support for PMX/PMD models. Drop .vmd files next to the model.
• Universal Edge Bus (UEB) redstone control:
  • Model code: 0–255
  • Animation code: 0–255 (0 = rest pose)
  • Ctrl code: 0–15 (reserved for future use)
  • Param bus (scale/offsets), quantized 0–15
  • Helpful commands to detect, map, watch, and manage cuboids.
  • Clickable TP coordinates in the /holo map output.

Requirements

• Minecraft: 1.21.8
• Fabric Loader
• Fabric API
• Fabric Language Kotlin

How to use

1. Build a filled tinted-glass cuboid anywhere in the world.
2. Use /holo watch while looking at a tinted glass block (or let auto-watch pick it up).
3. Place your model content in your Minecraft run directory (not inside the mod jar):
   • Windows: %appdata%/.minecraft/hologram/models/
   • Linux: ~/.minecraft/hologram/models/

• Select model/animation via redstone or commands.

Content folder structure

• One folder per model code (3-digit, zero-padded):
  • hologram/models/003/
    • model.pmx (.pmd/.glb/.gltf/.vrm also supported)
    • Idle.vmd, Walk.vmd, etc. (optional; VMD for PMX/PMD)
    • manifest.json (optional)

Optional manifest.json

• Place next to your model:

{
  "file": "model.pmx",
  "scale": 1.0,
  "offset": [0.0, 0.0, 0.0],
  "defaultAnimation": 0
}

• file: picks a model file (otherwise the first supported file is used)
• scale/offset: default transform applied to the hologram root
• defaultAnimation: ignored when anim=0 (since anim=0 is rest pose)

Supported formats

• Models: .pmx, .pmd, .vrm, .glb, .gltf
• Animations: .vmd (MMD; expects PMX/PMD rigs with matching bones)

Redstone: Universal Edge Bus (UEB)

• The mod reads redstone from the cuboid edges:
  • Bottom edges → Model bits (8)
  • Top edges → Anim bits (8)
  • Vertical edges (middle Y centers) → Ctrl bits (4)
  • If a bus can only fit a single port on a small cuboid, it falls back to an analog nibble (0..15) at that one position.
  • Use /holo map to print clickable coordinates for all bus ports and the param bus.

Parameter bus (analog, middle face centers)

• scaleQ: north face center
• offXQ: east face center
• offYQ: south face center
• offZQ: west face center
• Quantization: 0..15 (0 = inactive; use manifest defaults)
• Client mapping:
  • Scale: 0.25 + (scaleQ / 15) * 1.75 (if scaleQ > 0), else 1.0
  • Offsets: (Q − 8) / 8.0 (if Q > 0), else 0.0

Animation behavior

• anim=0 → rest pose (no animation applied)
• anim=1..N → clip indices 0..N−1 (wraps if out of range)
• On clip change: the mod resets relative transforms and morphs for a clean start.

Commands

• /holo detect [x y z]
  • Detect cuboid bounds/size for where you’re looking or a position.
  • /holo map [x y z]
    • Print the bus layout (Model/Anim/Ctrl ports + Param ports).
    • Coordinates are clickable:
      • OP (permission ≥ 2): click to teleport.
      • Non‑OP: click to get a suggested /tp command in chat.
  • /holo codes [x y z]
    • Print current Model/Anim/Ctrl codes for that cuboid.
  • /holo setcodes [x y z]
    • Set codes and broadcast instantly to clients.
    • Requires OP (permission level 2).
  • /holo watch [x y z]
    • Start watching a cuboid (bus is read and broadcast).
  • /holo unwatch [x y z]
    • Stop watching a cuboid.

Tips

• To play animation 10, set anim bus = 10:
  • Command: /holo setcodes 10 (OP only)
  • Redstone: power anim bus ports that sum to 10, or feed strength 10 to the analog fallback.
  • To select model folder 003, set model bus = 3.

Troubleshooting

• Nothing renders:
  • Ensure you’re watching the cuboid (/holo watch).
  • Ensure your model folder exists and contains a supported model file.
  • VMD doesn’t play:
    • Use PMX/PMD models; ensure VMD files are next to the model file.
    • Check client log for “Loaded scene ... animations=K”; K=0 means no usable clips were found.
  • Weird pose when switching animations:
    • The mod resets pose on clip change. If issues persist, the rig or channel mapping may be unusual—please report the model format/rig.

Content policy

• No models are bundled with this mod. You must supply your own content.
• The included screenshots/videos are for demonstration only and are not part of the mod jar.

Credits

• Rendering library: BlazeRod by Fifth Light (aka fifth_light). Thank you for the renderer and format loaders.
• This project does not redistribute BlazeRod source; BlazeRod JARs are included jar‑in‑jar for convenience.

License

• This mod: GPLv3.
• BlazeRod: LGPL 3.0.
• Third‑party models/media remain the property of their authors and are subject to their own licenses.