In this article we will look python code and logic to design a 2048 game you have played very often in your smartphone. If you are not familiar with the game, it is highly recommended to first play the game so that you can understand the basic functioning of it.
How to play 2048 :
1. There is a 4*4 grid which can be filled with any number. Initially two random cells are filled with 2 in it. Rest cells are empty.

2. We have to press any one of four keys to move up, down, left, or right. When we press any key, the elements of the cell move in that direction such that if any two identical numbers are contained in that particular row (in case of moving left or right) or column (in case of moving up and down) they get add up and extreme cell in that direction fill itself with that number and rest cells goes empty again.

3. After this grid compression any random empty cell gets itself filled with 2.

4. Following the above process we have to double the elements by adding up and make 2048 in any of the cell. If we are able to do that we wins.

5. But if during the game there is no empty cell left to be filled with a new 2, then the game goes over.

In above process you can see the snapshots from graphical user interface of 2048 game. But all the logic lies in the main code. So to solely understand the logic behind it we can assume the above grid to be a 4*4 matrix ( a list with four rows and four columns). Below is the way to take input and output without GUI for the above game.
Example :
Commands are as follows :
'W' or 'w' : Move Up
'S' or 's' : Move Down
'A' or 'a' : Move Left
'D' or 'd' : Move Right
[0, 0, 0, 0]
[0, 0, 0, 0]
[0, 0, 0, 0]
[0, 0, 2, 0]
Press the command : a
GAME NOT OVER
[0, 0, 0, 2]
[0, 0, 0, 0]
[0, 0, 0, 0]
[2, 0, 0, 0]
Press the command : s
GAME NOT OVER
[0, 0, 0, 0]
[0, 0, 0, 0]
[0, 0, 2, 0]
[2, 0, 0, 2]
Press the command : d
GAME NOT OVER
[0, 0, 0, 0]
[0, 0, 0, 0]
[2, 0, 0, 2]
[0, 0, 0, 4]
Press the command : a
GAME NOT OVER
[0, 2, 0, 0]
[0, 0, 0, 0]
[4, 0, 0, 0]
[4, 0, 0, 0]
Press the command : s
GAME NOT OVER
[0, 0, 0, 0]
[0, 0, 0, 0]
[0, 0, 0, 0]
[8, 2, 0, 2]
.
.
.
And the series of input output will go on till we lose or win!
Programming Approach :
- We will design each logic function such as we are performing a left swipe then we will use it for right swipe by reversing matrix and performing left swipe.
- Moving up can be done by taking transpose then moving left.
- Moving down can be done by taking transpose the moving right.
- All the logic in the program are explained in detail in the comments. Highly recommended to go through all the comments.
We have two python files below:
- 2048.py: contains main driver code.
- logic.py: contains all functions used.
logic.py should be imported in 2048.py to use these functions. just place both the files in the same folder then run 2048.py file.
logic.py code
Pythonimportrandomdefstart_game():# declaring an empty list then# appending 4 list each with four# elements as 0.mat=[]foriinrange(4):mat.append([0]*4)# printing controls for userprint("Commands are as follows : ")print("'W' or 'w' : Move Up")print("'S' or 's' : Move Down")print("'A' or 'a' : Move Left")print("'D' or 'd' : Move Right")# calling the function to add# a new 2 in grid after every stepadd_new_2(mat)returnmatdeffindEmpty(mat):"""Finds the first empty (0) cell in the grid."""foriinrange(4):forjinrange(4):ifmat[i][j]==0:returni,j# Return the first found empty cellreturnNone,None# No empty cells left# function to add a new 2 in# grid at any random empty celldefadd_new_2(mat):"""Adds a new '2' in a random empty cell in the grid."""ifall(all(cell!=0forcellinrow)forrowinmat):return# No empty space left, avoid infinite looptries=0whiletries<30:r=random.randint(0,3)c=random.randint(0,3)ifmat[r][c]==0:mat[r][c]=2return# Successfully placed a '2'tries+=1# If random placement fails too many times, find an empty cell manuallyr,c=findEmpty(mat)ifrisnotNoneandcisnotNone:mat[r][c]=2# function to get the current# state of gamedefget_current_state(mat):# if any cell contains# 2048 we have wonforiinrange(4):forjinrange(4):if(mat[i][j]==2048):return'WON'# if we are still left with# atleast one empty cell# game is not yet overforiinrange(4):forjinrange(4):if(mat[i][j]==0):return'GAME NOT OVER'# or if no cell is empty now# but if after any move left, right,# up or down, if any two cells# gets merged and create an empty# cell then also game is not yet overforiinrange(3):forjinrange(3):if(mat[i][j]==mat[i+1][j]ormat[i][j]==mat[i][j+1]):return'GAME NOT OVER'forjinrange(3):if(mat[3][j]==mat[3][j+1]):return'GAME NOT OVER'foriinrange(3):if(mat[i][3]==mat[i+1][3]):return'GAME NOT OVER'# else we have lost the gamereturn'LOST'# all the functions defined below# are for left swap initially.# function to compress the grid# after every step before and# after merging cells.defcompress(mat):# bool variable to determine# any change happened or notchanged=False# empty gridnew_mat=[]# with all cells emptyforiinrange(4):new_mat.append([0]*4)# here we will shift entries# of each cell to it's extreme# left row by row# loop to traverse rowsforiinrange(4):pos=0# loop to traverse each column# in respective rowforjinrange(4):if(mat[i][j]!=0):# if cell is non empty then# we will shift it's number to# previous empty cell in that row# denoted by pos variablenew_mat[i][pos]=mat[i][j]if(j!=pos):changed=Truepos+=1# returning new compressed matrix# and the flag variable.returnnew_mat,changed# function to merge the cells# in matrix after compressingdefmerge(mat):changed=Falseforiinrange(4):forjinrange(3):# if current cell has same value as# next cell in the row and they# are non empty thenif(mat[i][j]==mat[i][j+1]andmat[i][j]!=0):# double current cell value and# empty the next cellmat[i][j]=mat[i][j]*2mat[i][j+1]=0# make bool variable True indicating# the new grid after merging is# different.changed=Truereturnmat,changed# function to reverse the matrix# means reversing the content of# each row (reversing the sequence)defreverse(mat):new_mat=[]foriinrange(4):new_mat.append([])forjinrange(4):new_mat[i].append(mat[i][3-j])returnnew_mat# function to get the transpose# of matrix means interchanging# rows and columndeftranspose(mat):new_mat=[]foriinrange(4):new_mat.append([])forjinrange(4):new_mat[i].append(mat[j][i])returnnew_mat# function to update the matrix# if we move / swipe leftdefmove_left(grid):# first compress the gridnew_grid,changed1=compress(grid)# then merge the cells.new_grid,changed2=merge(new_grid)changed=changed1orchanged2# again compress after merging.new_grid,temp=compress(new_grid)# return new matrix and bool changed# telling whether the grid is same# or differentreturnnew_grid,changed# function to update the matrix# if we move / swipe rightdefmove_right(grid):# to move right we just reverse# the matrixnew_grid=reverse(grid)# then move leftnew_grid,changed=move_left(new_grid)# then again reverse matrix will# give us desired resultnew_grid=reverse(new_grid)returnnew_grid,changed# function to update the matrix# if we move / swipe updefmove_up(grid):# to move up we just take# transpose of matrixnew_grid=transpose(grid)# then move left (calling all# included functions) thennew_grid,changed=move_left(new_grid)# again take transpose will give# desired resultsnew_grid=transpose(new_grid)returnnew_grid,changed# function to update the matrix# if we move / swipe downdefmove_down(grid):# to move down we take transposenew_grid=transpose(grid)# move right and then againnew_grid,changed=move_right(new_grid)# take transpose will give desired# results.new_grid=transpose(new_grid)returnnew_grid,changed# this file only contains all the logic# functions to be called in main function# present in the other file
Code Breakdown:
1. Game Initialization
- start_game(): Creates a 4×4 grid filled with zeros and places an initial 2 in a random cell.
- Prints controls (WASD for movement).
2. Random Number Placement
- add_new_2(mat): Places a 2 in a random empty cell.
- Uses a loop to retry placement if the first attempt fails.
3. Game State Check
- get_current_state(mat): Determines if the game is:
- Won (2048 tile present).
- Ongoing (empty cells or possible merges).
- Lost (no moves left).
4. Movement Mechanics
- move_left(grid): Moves tiles left:
- Compression (compress()): Pushes numbers to the left.
- Merge (merge()): Merges identical numbers.
- Re-compression: Removes gaps after merging.
- move_right(grid): Reverses the matrix, moves left, then reverses back.
- move_up(grid): Transposes the grid, moves left, and transposes back.
- move_down(grid): Transposes the grid, moves right, and transposes back.
5. Helper Functions
- reverse(mat): Reverses each row.
- transpose(mat): Swaps rows and columns.
2048.py code
Pythonimportlogic# Driver codeif__name__=='__main__':# calling start_game function# to initialize the matrixmat=logic.start_game()while(True):# taking the user input# for next stepx=input("Press the command : ")# we have to move upif(x=='W'orx=='w'):# call the move_up functionmat,flag=logic.move_up(mat)# get the current state and print itstatus=logic.get_current_state(mat)print(status)# if game not over then continue# and add a new twoif(status=='GAME NOT OVER'):logic.add_new_2(mat)# else break the loopelse:break# the above process will be followed# in case of each type of move# below# to move downelif(x=='S'orx=='s'):mat,flag=logic.move_down(mat)status=logic.get_current_state(mat)print(status)if(status=='GAME NOT OVER'):logic.add_new_2(mat)else:break# to move leftelif(x=='A'orx=='a'):mat,flag=logic.move_left(mat)status=logic.get_current_state(mat)print(status)if(status=='GAME NOT OVER'):logic.add_new_2(mat)else:break# to move rightelif(x=='D'orx=='d'):mat,flag=logic.move_right(mat)status=logic.get_current_state(mat)print(status)if(status=='GAME NOT OVER'):logic.add_new_2(mat)else:breakelse:print("Invalid Key Pressed")# print the matrix after each# move.print(mat)
Output :
Code Breakdown:
1. Game Initialization:mat = logic.start_game(): Calls start_game() from logic.py to create a 4×4 grid with an initial 2 placed randomly.
2. Game Loop (User Input)
- A continuous loop (while True) keeps the game running until it is won or lost.
- x = input("Press the command : "): Takes user input (WASD for movement).
3. Handling Moves
- Depending on user input, the respective movement function is called:
- W (Up): logic.move_up(mat)
- S (Down): logic.move_down(mat)
- A (Left): logic.move_left(mat)
- D (Right): logic.move_right(mat)
4. Each move:
- Updates mat (grid) using the respective movement function.
- Calls logic.get_current_state(mat):
- "WON" - Game ends.
- "GAME NOT OVER" - A new 2 is added using logic.add_new_2(mat).
- "LOST" - Game ends.
- Prints the updated grid.
4. Invalid Input Handling:If an invalid key is pressed, it prints "Invalid Key Pressed" without changing the game state.