Artifact identity and migration

Artifact identity

Every protection_region_artifact and global_protection_region_artifact receives an artifactId generated by Typewriter as a UUID. It is an internal identity, not a region name.

• Create the artifact from the Typewriter page editor and keep the generated UUID unchanged.
• Use the entry id and name for readable labels.
• Do not use a semantic value such as spawn, shops, or player_data as an artifactId.
• Do not move or edit artifact files manually. Protection always accesses them through Typewriter's artifact storage.

Changing an existing UUID disconnects its geometry from the region definition. If an identifier must change, copy the data through an explicit migration and retain a backup of the original artifact before changing the page reference.

WorldGuard migration

/protection migrate-from-worldguard is an administrative import tool. Run it only after backing up the Typewriter pages and artifact storage.

1. Verify every source world and its WorldGuard regions.
2. Run the command once and inspect its migration report.
3. Create or link the resulting Protection region definitions in the Typewriter editor.
4. Validate shape, owners, members, priority, flags, and parent hierarchy on a staging server.
5. Keep the backup until the migrated pages have been validated after a restart.

The public extension keeps its migration path compatible with official Typewriter. The BTC-CORE build may add server-side integrations, but it uses the same artifact-identity rules.