Back to all Developer Hub
This guide demonstrates how to integrate the Cere Games SDK into your game, enabling you to store user data, such as game scores and leaderboards, on Dragon 1 - the first data cluster in Cere's Decentralized Data Cloud (DDC). By following this tutorial, you'll learn how to upgrade your existing game with web3 features, including decentralized leaderboards and score tracking.
Before you begin, make sure you have:
Install the SDK using npm by running the following command in your project directory:
npm install @cere/games-sdkCreate a new file called games-sdk.js in your project root and add the following code:
const { GamesSDK } = require("@cere/games-sdk");
window.CereGamesSdk = new GamesSDK({
gameId: '0xTowerGame', // Replace with your unique Game ID
gameInfo: {
name: '0xTowerGame',
tags: ['towergame', 'web3', 'gamer'],
url: window.location.href,
logoUrl: "http://..." // Add your game's logo URL
},
onReady: (sdk) => {
window.gamesSdkPreloader = sdk.showPreloader({
onStart:() => {
document.getElementById('start')?.click();
}
});
},
});
window.CereGamesSdk.init();
Make sure to replace '0xTowerGame' with your unique Game ID and update the gameInfo object with your game's details.
In your main game file (e.g., index.html), add the following code to launch the pre-loader modal when the game assets are loaded:
function hideLoading() {
if (domReady && canvasReady) {
// Your existing code here
window.gamesSdkPreloader.setReady();
}
}
This will display the Cere Games pre-loader modal once your game is ready to start.
Integrate score saving and leaderboard display in your game logic. For example, when a player's game ends:
setGameFailed: function (f) {
// Your existing game over logic
window.CereGamesSdk.saveScore(score).then(() => {
window.CereGamesSdk.showLeaderboard({
onPlayAgain: () => {
// Restart the game
window.location.href = window.location.href + '?s=' + (+new Date());
}
});
});
}
This code saves the player's score to Dragon 1 and then displays the leaderboard.
To upload your game to DDC and leverage decentralized storage for user data:
npm run buildzip -r yourgame-v1.zip ./your-game-directory/
After uploading your game to Dragon 1, you gain the ability to create and manage tournaments for your players. This feature allows you to organize competitive events and engage your player base.
You can create a tournament in two ways:
1. During the game upload process:
2. From the game list page:
After selecting either option, you'll be directed to the tournament creation page:
.png)
After successfully creating a tournament:
Tournaments have two status types:
For tournaments with the "Past" status, you have the option to upload the results.
To download the results of all tournaments:
This feature allows you to analyze player performance across multiple tournaments and track long-term player engagement.
After uploading your game and configuring properties in Freeport, you can test your game locally:
npm start
This will start a local server, and your game should open in a new browser window. You'll be able to test the Cere Games SDK integration, including the pre-loader modal, score saving, and leaderboard display.
Stay tuned for upcoming features that will enhance your game's capabilities:
By integrating the Cere Games SDK, you've successfully enabled your game to store user data (scores and leaderboards) on Dragon 1, leveraging the power of decentralized storage. This integration provides a seamless way to add web3 features to your existing games, enhancing the user experience with decentralized leaderboards and score tracking.
The tournament feature allows you to create engaging competitive events for your players, further increasing player retention and providing valuable user data that is securely stored on Dragon 1.
Remember to regularly check for updates and new features in the Cere Games SDK to continually improve your game's web3 capabilities and player experience.
Meet the Cere Community!
For further assistance or to connect with other developers, join the Cere Network community on Telegram or Discord.
If you have any feedback or encounter any bugs, please let us know at https://cere.network/feedback.
Remember, DDC is continually evolving, so always refer to the official documentation for the most up-to-date information and best practices.
The game developer has the ability to arrange tournaments for their players.
After uploading your game, it becomes possible to add tournaments, this can be done in several ways:
Next, you get to the page with the creation of tournaments, where you need to fill in all the required fields and click the Create tournament button.
After successfully creating a tournament, you will be able to view all created tournaments and edit them if necessary.
You can edit the tournament by clicking on the edit button in the line. A pre-filled tournament form will open, where you can change the values of the required fields. You can save the changes by clicking on the Save changes button.
If the tournament has’t passed yet it will have the Active status. If the tournament has already passed, then it will be with the Past status.
For tournaments with the Past status, it is possible to upload the results
You can download the results of all tournaments on the page with the list of games by clicking on the Download all tournament results button