
The Game Configuration.json file is a central data structure used in cricket management games and fantasy platforms to define the rules, scoring, and technical settings of a cricket league. Whether you are building a custom game or modding an existing one, this guide explains how to structure and edit this file. 1. File Structure Overview
A typical Game Configuration.json is organized into several key objects that dictate the "engine" of the league.
League Info: General details like the league name and version.
Scoring Rules: Point values for batting (runs, boundaries), bowling (wickets, economy), and fielding.
Match Settings: Constraints like the number of overs, powerplay duration, and innings rules.
Technical Config: Performance settings like graphics quality and language. 2. Sample JSON Configuration
Below is a standard template used in many cricket game development projects, such as the Fantasy Cricket League repository .
"league_settings": "league_name": "Pro Cricket League 2026", "version": "1.0.4", "allow_offline": true , "scoring_matrix": "batting": "run_scored": 1, "boundary_four": 1, "boundary_six": 2, "half_century_bonus": 5, "century_bonus": 10 , "bowling": "wicket": 10, "maiden_over": 4, "three_wicket_haul": 5, "five_wicket_haul": 10 , "fielding": "catch": 8, "stumping": 12, "run_out": 6 , "match_rules": "default_format": "T20", "max_overs": 20, "powerplay_overs": 6, "super_over_enabled": true Use code with caution. Copied to clipboard 3. Key Parameters to Edit
If you are modifying the file to rebalance your game, focus on these common fields:
Economy Rate Points: Many leagues award bonus points for an economy rate below 4.0 or penalize for rates above 9.0. Game Configuration.json Cricket League File
Strike Rate Bonuses: Use these to reward aggressive play (e.g., +4 points for a strike rate above 100).
Match IDs: For data-driven games, you may need to map specific match files using a dates array (e.g., ["2026-04-18"]). 4. How to Edit the File
Backup: Always create a copy of the original .json before making changes.
Use a Dedicated Editor: Use tools like VS Code or the PDK JSON Editor to ensure you don't break the syntax.
Validate: JSON is sensitive to commas and brackets. Use a validator like JSONLint to check for errors before launching the game.
Read-Only Mode: If your game keeps resetting your custom settings to default, right-click the file, go to Properties, and check Read-only. 5. Implementation for Developers
If you are implementing this in a project (e.g., Python or Unity):
Python: Use json.load() to read the file and json.dump() to save changes.
Unity/C#: Use the JsonUtility or Newtonsoft.Json library to parse the configuration at startup. Srushti-S/Fantasy-Cricket-League - GitHub The Game Configuration
Game Configuration.json file (or its variants like match_config.json
) is a foundational data structure used in cricket video games and sports management platforms to define the rules, settings, and metadata of a cricket match or league. By using the JSON format, developers can modify game behavior—such as match length, scoring systems, or team rosters—without needing to recompile the game's core source code. Core Purpose of Cricket JSON Configs
JSON (JavaScript Object Notation) is the industry-standard format for cricket data due to its readability and native support for complex, nested data like player statistics and delivery-by-delivery events. Decoupling Data from Code
: It allows designers to tweak variables like "overs per innings" or "points per wicket" in a simple text file. Cross-Platform Portability
: These files can be easily transferred between different game builds or regions to sync player settings. Standardized Match Data : Organizations like
use JSON as their primary format for distributing comprehensive match history and statistics. Common Key-Value Parameters
A typical cricket league configuration file includes several required objects to define a match: Parameter Category Common Keys Description Match Identity match_number
Defines the name of the match and its chronological place in a series.
Identifies where the game is played and the participating teams. JSON File Structure Here's a sample game configuration
Sets the format (e.g., T20, ODI, Test) and the maximum overs allowed. Player Rosters non_striker
Lists the specific players assigned to active roles for a delivery. Point Systems Defines how points (runs) are calculated and categorized. Structural Example
Data in these files is often nested. For example, a "summary" object might contain high-level results, while a "batting" array tracks individual performance: "matchinfo" "M Chinnaswamy Stadium" Use code with caution. Copied to clipboard Editing and Troubleshooting
Editing these files requires precision, as even a missing bracket can cause the game to crash or reset settings to default.
Based on the standard architecture of mobile cricket games (like Real Cricket, World Cricket Championship, or Stick Cricket), a Game Configuration.json file for a Cricket League mode serves as the central blueprint. It defines the rules, economy, difficulty, and structure of the league without requiring code changes to update the game.
Below is a detailed breakdown of the feature set typically found in this file, followed by an actual JSON structure example.
Here's a sample game configuration JSON file for a cricket league game:
"leagueSettings":
"name": "Cricket Premier League",
"seasonDates":
"start": "2023-03-01",
"end": "2023-09-30"
,
"teamCount": 8
,
"teams": [
"name": "Mumbai Indians",
"players": [
"name": "Rohit Sharma",
"role": "Captain",
"battingStats":
"matches": 100,
"runs": 5000,
"average": 40
,
"bowlingStats":
"matches": 50,
"wickets": 20,
"average": 30
,
"name": "Jasprit Bumrah",
"role": "Bowler",
"battingStats":
"matches": 50,
"runs": 100,
"average": 10
,
"bowlingStats":
"matches": 100,
"wickets": 150,
"average": 20
]
,
"name": "Chennai Super Kings",
"players": [
"name": "MS Dhoni",
"role": "Captain",
"battingStats":
"matches": 150,
"runs": 7000,
"average": 50
,
"bowlingStats":
"matches": 20,
"wickets": 5,
"average": 40
,
"name": "Dwayne Bravo",
"role": "All-Rounder",
"battingStats":
"matches": 100,
"runs": 3000,
"average": 30
,
"bowlingStats":
"matches": 80,
"wickets": 100,
"average": 25
]
],
"gameplaySettings":
"gameMode": "Simulation",
"difficultyLevel": "Medium"
$schema field. Add "$schema": "./cricketLeagueConfigSchema.json" to enable IDE validation and prevent corrupted patches.The game configuration JSON file is a crucial component of a cricket league game, providing a centralized repository for storing and managing game settings, team rosters, player statistics, and other essential data. In this post, we'll explore the structure and content of a sample game configuration JSON file for a cricket league game.
If you play Cricket League on an emulator:
Internal Storage/Android/data/com.cricketleague.game/files/