# Hyperfy Discord - 2026-01-27

## Overall Discussion Highlights

### Data Migration (v1 to v2)
- Jin is leading development on a converter tool for migrating data from Hyperfy v1 to v2
- The converter exports v1 data in a format compatible with v2, including both original archives and converted files
- Output structure includes v2 folders with db.sqlite, collections, and assets directories
- The converter adds approximately 270kb per world, which is minimal compared to overall zip sizes

### Technical Infrastructure
- Discussion about handling .hyp files (Hyperfy's binary format) through Discord and GitHub
- Ash suggested git LFS as a solution for binary file management
- Jin expressed concerns about GitHub's payment requirements and security implications for git LFS
- Jin mentioned work on porting Hyperfy sky presets to the new version

### Avatar System Development
- Jin is working on hyperfy-vrm for in-world avatar changing functionality
- Technical assistance may be required for implementation

## Key Questions & Answers

**Q: What does the converter output?** (asked by ash)  
**A:** V2 world folders with db.sqlite, collections, and assets directories, alongside the original v1 data and converter script (answered by jin)

**Q: How to handle hyp files in git repositories?** (asked by jin)  
**A:** Hyp files are binary and require git LFS for proper handling in repositories (answered by ash)

## Community Help & Collaboration

**Helper:** ash  
**Helpee:** jin  
**Context:** How to handle binary hyp files in git repositories  
**Resolution:** Ash suggested using git LFS, though Jin noted payment requirements and security concerns

## Action Items

### Technical
- Complete the v1 data exporter per owner (Mentioned by: jin)
- Coordinate website implementation of the data exporter (Mentioned by: jin)
- Port hyperfy-vrm for in-world avatar changing (Mentioned by: jin)
- Consider creating a scraper for non-Hyperfy hosted assets (Mentioned by: jin)

### Documentation
- Update documentation based on Discord analysis of hyp files (Mentioned by: jin)