Overview
The CollectibleData class represents collectible artifacts that users can discover while exploring the wonders. These collectibles are hidden items that users can find, adding a gamification element to the app experience.
Location: lib/logic/data/collectible_data.dart:10
CollectibleState Class
Defines the three states a collectible can be in:
class CollectibleState {
static const int lost = 0; // Not yet discovered
static const int discovered = 1; // Found but not fully explored
static const int explored = 2; // Fully explored
}
Class Definition
class CollectibleData {
CollectibleData({
required this.title,
required this.iconName,
required this.artifactId,
required this.wonder,
}) {
icon = AssetImage('\${ImagePaths.collectibles}/\$iconName.png');
}
}
Properties
The display name of the collectible artifact
Name of the icon file (without extension) used to represent the collectible type
Auto-generated ImageProvider based on iconName, loaded from the collectibles assets folder
References
Metropolitan Museum of Art artifact ID associated with this collectible
The wonder this collectible is associated with (e.g., WonderType.chichenItza)
Computed Properties
String get id => artifactId;
artifactId, used as the unique identifier for the collectible.
subtitle
String get subtitle => wondersLogic.getData(wonder).artifactCulture;
imageUrl
String get imageUrl => ArtifactData.getSelfHostedImageUrl(id);
imageUrlSmall
String get imageUrlSmall => ArtifactData.getSelfHostedImageUrlSmall(id);
Icon Types
Collectibles use different icon types to represent their category:
| Icon Name | Description | Example Collectibles |
|---|
jewelry | Jewelry and ornamental items | Pendant, Bird Ornament, Fixed fan |
picture | Paintings and photographs | La Prison, à Chichen-Itza |
statue | Sculptures and figurines | Engraved Horn, Camelid figurine |
vase | Pottery and vessels | Glass hexagonal amphoriskos, Jar with Dragon |
scroll | Documents and calligraphy | Biographies, Panel of Calligraphy |
textile | Fabrics and woven items | Handkerchiefs, Eight-Pointed Star Tunic |
Collectibles Data
The app includes a predefined list of 24 collectibles (3 per wonder) in collectiblesData:
Location: lib/logic/data/collectible_data.dart:38
Example Collectibles
Chichen Itza
CollectibleData(
title: 'Pendant',
wonder: WonderType.chichenItza,
artifactId: '701645',
iconName: 'jewelry',
),
CollectibleData(
title: 'Bird Ornament',
wonder: WonderType.chichenItza,
artifactId: '310555',
iconName: 'jewelry',
),
CollectibleData(
title: 'La Prison, à Chichen-Itza',
wonder: WonderType.chichenItza,
artifactId: '286467',
iconName: 'picture',
),
Taj Mahal
CollectibleData(
title: 'Dagger with Scabbard',
wonder: WonderType.tajMahal,
artifactId: '24907',
iconName: 'jewelry',
),
CollectibleData(
title: 'The House of Bijapur',
wonder: WonderType.tajMahal,
artifactId: '453183',
iconName: 'picture',
),
CollectibleData(
title: 'Panel of Nasta\'liq Calligraphy',
wonder: WonderType.tajMahal,
artifactId: '453983',
iconName: 'scroll',
),
Usage Example
import 'package:wonders/logic/data/collectible_data.dart';
// Access the global collectibles list
final allCollectibles = collectiblesData;
// Filter collectibles by wonder
final chichenCollectibles = collectiblesData
.where((c) => c.wonder == WonderType.chichenItza)
.toList();
// Get a specific collectible
final collectible = collectiblesData[0];
// Access properties
print(collectible.title); // "Pendant"
print(collectible.id); // "701645"
print(collectible.subtitle); // "Maya" (from wonder's artifactCulture)
// Get image URLs
final fullImage = collectible.imageUrl;
// Returns: 'https://www.wonderous.info/met/701645.jpg'
final thumbnail = collectible.imageUrlSmall;
// Returns: 'https://www.wonderous.info/met/701645_600.jpg'
// Access the icon asset
final icon = collectible.icon;
// ImageProvider for 'assets/images/collectibles/jewelry.png'
// Check collectible state (managed elsewhere in the app)
int state = CollectibleState.lost; // User hasn't found it yet
if (state == CollectibleState.discovered) {
print('Collectible discovered!');
}
Collectible States
While CollectibleData defines the static properties of collectibles, their state (lost/discovered/explored) is typically managed separately in the app’s state management system:
// Tracking collectible progress
Map<String, int> collectibleStates = {
'701645': CollectibleState.discovered,
'310555': CollectibleState.explored,
'286467': CollectibleState.lost,
};
// Check if a collectible has been found
final isDiscovered = collectibleStates[collectible.id] != CollectibleState.lost;
// Update state when user finds a collectible
collectibleStates[collectible.id] = CollectibleState.discovered;
Integration with WonderData
Collectibles are referenced in WonderData through the hiddenArtifacts property:
// In ChichenItzaData
hiddenArtifacts: const [
'701645', // Pendant
'310555', // Bird Ornament
'286467', // La Prison
],
artifactId values in the collectiblesData list.
MET Museum Links
Each collectible can be viewed on the Metropolitan Museum of Art website:
https://www.metmuseum.org/art/collection/search/{artifactId}
701645:
https://www.metmuseum.org/art/collection/search/701645
All Collectibles by Wonder
- Chichen Itza: 3 collectibles (2 jewelry, 1 picture)
- Christ the Redeemer: 3 collectibles (1 statue, 1 jewelry, 1 textile)
- Colosseum: 3 collectibles (2 vases, 1 statue, 1 picture)
- Great Wall: 3 collectibles (1 scroll, 1 vase, 1 textile)
- Machu Picchu: 3 collectibles (1 textile, 2 statues, 1 vase)
- Petra: 3 collectibles (1 statue, 2 vases)
- Pyramids of Giza: 3 collectibles (1 scroll, 1 statue, 1 jewelry)
- Taj Mahal: 3 collectibles (1 jewelry, 1 picture, 1 scroll)
- ArtifactData - Used for generating image URLs
- WonderData - References collectibles through
hiddenArtifacts
- HighlightData - Similar structure for featured (non-hidden) artifacts