Add data import from ElbaphFactions

[derrickmehaffy]

Feature Description

Add an import command to migrate faction data from ElbaphFactions to HyperFactions, allowing server owners to switch faction plugins without losing player progress.

Proposed Solution

Add a new admin command:

/f admin import elbaphfactions [--dry-run]

Import mappings:

• Factions (name, tag, description, creation date)
• Members with roles (leader, officer, member)
• Territory claims (chunk coordinates)
• Power values (if compatible system)
• Relations (ally, enemy, truce, neutral)
• Faction homes/warps

Process:

1. Detect ElbaphFactions data directory location
2. Parse their data format (JSON/YAML/SQLite)
3. Validate data integrity before import
4. Map data to HyperFactions structures
5. Handle conflicts (duplicate names, overlapping claims)
6. Generate import report

Dry-run mode:

• --dry-run flag shows what would be imported without making changes
• Lists factions, members, claims that would be migrated
• Reports any data that cannot be imported

Alternatives Considered

1. Generic import format - Define a standard faction data JSON schema that any plugin could export to
2. Manual migration guide - Documentation for manual data conversion
3. Bidirectional sync - Keep both plugins running during transition (complex)

Additional Context

• Requires research into ElbaphFactions data storage format
• Should backup existing HyperFactions data before import
• Permission: hyperfactions.admin.import
• May need to handle version differences in ElbaphFactions data formats
• Consider adding import support for other popular faction plugins in the future