docs & feat: add license & attribution notice (Apache-2.0 / GPL-3.0) and core system enhancements

internal/common/models.go

@@ -371,6 +371,7 @@ type Persistent struct {
 	PlayerOutfits         []uint32                               `json:"player_outfits"`
 	SceneGroupProperties  map[uint32]map[uint32]map[string]int32 `json:"scene_group_properties"`
 	ExRanksUnlocked       map[uint32]bool                        `json:"ex_ranks_unlocked"`
+	WarpUnlockMode        *int                                   `json:"warp_unlock_mode,omitempty"`
 }
 
 // DefaultPersistent mirrors the Rust Default impl.
@@ -378,6 +379,7 @@ func DefaultPersistent() Persistent {
 	sw := true
 	cg := true
 	aha := true
+	defaultWarpMode := 1
 	return Persistent{
 		Lineups:               map[uint32]uint32{0: 1313, 1: 1006, 2: 8001, 3: 1405},
 		Position:              DefaultPosition(),
@@ -389,6 +391,7 @@ func DefaultPersistent() Persistent {
 		EnableAhaGlobal:       &aha,
 		DressedSkins:          map[uint32]uint32{},
 		ExRanksUnlocked:       map[uint32]bool{},
+		WarpUnlockMode:        &defaultWarpMode,
 	}
 }
 
@@ -423,6 +426,7 @@ type FreesrData struct {
 	DressedSkins          map[uint32]uint32                      `json:"-"`
 	PlayerOutfits         []uint32                               `json:"-"`
 	SceneGroupProperties  map[uint32]map[uint32]map[string]int32 `json:"-"`
+	WarpUnlockMode        int                                    `json:"-"`
 }
 
 // LoadFreesrData reads freesr-data.json + persistent and merges them,
@@ -467,6 +471,11 @@ func LoadFreesrData() (*FreesrData, error) {
 			data.DressedSkins = p.DressedSkins
 			data.PlayerOutfits = p.PlayerOutfits
 			data.SceneGroupProperties = p.SceneGroupProperties
+			if p.WarpUnlockMode != nil {
+				data.WarpUnlockMode = *p.WarpUnlockMode
+			} else {
+				data.WarpUnlockMode = 1
+			}
 			for aid, unlocked := range p.ExRanksUnlocked {
 				if av, ok := data.Avatars[aid]; ok {
 					av.ExRankUnlocked = unlocked