en Data Migration

Data Migration

DecentHolograms Config Compatibility

WooHolograms can read DecentHolograms config file format for easy migration from DH:

• On first startup, automatically detects .yml files in plugins/DecentHolograms/holograms/ directory
• Automatically migrates DH-format data to plugins/WooHolograms/holograms/ directory
• After migration, uses WooHolograms native format for storage; subsequent edits auto-save in the new format
• Supports reading DH's kebab-case keys (e.g., facing-direction) and WH's camelCase keys (e.g., facingDirection)

DecentHolograms API Compatibility

WooHolograms has a built-in DecentHolograms API compatibility layer, implemented via the provides: DecentHolograms declaration and same-package same-class name delegation pattern.

When DecentHolograms is not installed on the server, plugins depending on the DH API will automatically use WooHolograms as the backend, without any code modification.

Covered DHAPI methods:

• Create/delete holograms
• Page operations (add/insert/delete/get)
• Line operations (add/insert/set/delete/get)
• Teleport holograms
• Show/hide holograms

HolographicDisplays Import

Use /wh convert holographicdisplays (alias hd) to import:

• Scans .yml files in plugins/HolographicDisplays/ directory
• Automatically parses HD-format hologram locations and text content
• Automatically skips and prompts on name conflicts
• Does not support HD 3.x database files (will prompt)

CMI Import

Use /wh convert cmi to import:

• Reads plugins/CMI/Saves/holograms.yml (falls back to plugins/CMI/holograms.yml)
• Automatically skips page-button holograms generated by CMI (ending with #> / #<)
• !nextpage! separators are automatically split into multiple pages, with page-turn actions added to each page
• ICON: lines are automatically converted to #ICON: format