{"id":40,"date":"2025-09-20T19:34:10","date_gmt":"2025-09-20T23:34:10","guid":{"rendered":"https:\/\/wp.stgeorges.bc.ca\/trisonc\/?p=40"},"modified":"2025-09-20T19:40:35","modified_gmt":"2025-09-20T23:40:35","slug":"fusion-coding-2048","status":"publish","type":"post","link":"https:\/\/wp.stgeorges.bc.ca\/trisonc\/2025\/09\/20\/fusion-coding-2048\/","title":{"rendered":"Fusion Coding\u2014 2048"},"content":{"rendered":"\n

This blog is dedicated to a small project I built for this coding assignment. I decided to go with coding a text-based 2048 game since I\u2019ve played the game a lot from a long time ago, and I think it would be really interesting to try to bring my own flair into it. <\/p>\n\n\n\n

\n

So what is 2048?<\/h2>\n<\/div>
\"\"<\/figure><\/div>\n\n\n\n

2048 by Gabriele Cirulli commonly starts with a 4×4 <\/strong>grid of blank tiles, with 2 tiles filled with either a 2 or a 4. With every move, you move the board in your preferred direction, combining adjacent tiles as you go, and another random tile appears. The goal of the game is to reach the number 2048, in any way that you please. <\/p>\n\n\n\n

\n

\u201cFailing to plan is planning to fail”\u2014 Benjamin Franklin<\/p>\n<\/blockquote>\n\n\n\n

Planning the Flow Chart<\/h2>\n\n\n\n

Flowcharts are a great way to map out your thinking, especially if you have a big project at hand. I decided to map out the main components of the game in the flowchart, asking Google Gemini for any gaps in my flowchart.<\/p>\n\n\n\n

\"\"
Flowchart of the 2048 game loop made in Freeform<\/figcaption><\/figure>\n\n\n\n

Functions in 2048<\/h2>\n\n\n\n

A function in code is a specific set of instructions that you map to a certain name in order to reference it easily throughout the code. In terms of 2048, I listed the functions I would need in 2048 on the right of the flowchart. I\u2019m guessing overall this saved me hundreds of lines of code throughout the whole game code. <\/p>\n\n\n\n

Translating the Flowchart into Python<\/h2>\n\n\n\n

Making a flowchart is one thing, but actually coding the game in Python is another thing entirely. I first have to import I\u2019ll go through each of the functions one by one and explain each of them:<\/p>\n\n\n\n

\n

This clear console<\/strong> function isn\u2019t really needed but it\u2019s easier to reference. I asked Gemini how I would clear the terminal in Google Colab so I did what it told me and imported the library along with the random <\/em>library for picking random tiles.<\/p>\n<\/div>

\"\"<\/figure><\/div>\n\n\n\n
\"\"<\/figure>
\n

This function creates a 2D array<\/strong> for the board based on its size. You can see it calls the add_new_tile<\/em> function which will make sense soon.<\/p>\n<\/div><\/div>\n\n\n\n

\n

This function first finds all the empty cells by looping through each cell and checking if it\u2019s 0. Next if there are any empty cells it chooses a random cell(this is where the random library becomes useful) and chooses a number randomly between 2 and 4.<\/p>\n<\/div>

\"\"<\/figure><\/div>\n\n\n\n
\n

This print_board<\/em> function was a bit annoying to figure out because I had to mess around a lot with the text. What it does is when the game is running, it prints the game title, score, and board. It then turns the board from just a simple grid of numbers into an actually nice looking text-based graphic. The comment on the bottom helps explain most of the function, or at least the hardest part.<\/p>\n<\/div>

\"\"<\/figure><\/div>\n\n\n\n
\"\"<\/figure>
\n

This function is part of what is responsible for what happens on the board after a move. Let\u2019s look into the logic of the function when it slides a row left. <\/strong>It starts with making a copy of the current row without<\/strong> 0s. I decided to go with the left direction because when the code iterates through most data structures<\/span> it goes from left to right in our case. The next few lines combine the duplicates and in the end it returns the row with 0s filled in on the right.<\/p>\n<\/div><\/div>\n\n\n\n

\"\"<\/figure>
\n

Obviously when you make a move it\u2019s not just one <\/em>row that slides left, it\u2019s the whole board, so this function just goes through each row, slides it left and returns the new board. Notice the merge_score <\/em>and total_score<\/em> variables in the two functions, these will be used to display scores in the main function.<\/p>\n<\/div><\/div>\n\n\n\n

\n

This function is a little deceiving to the eye because even though it\u2019s only one line it took a bit of thinking to get right. The comment explains everything.<\/p>\n<\/div>

\"\"<\/figure><\/div>\n\n\n\n
\n

This function, despite its size isn\u2019t that complicated. I did make a little bit of a mistake naming the variables because total_score<\/em> isn\u2019t actually the total score of the game, just the total score of the one move. score<\/em> is actually the total score, so the naming is a bit misleading. You can see the rotate_board<\/em> function be put to full use here. I could\u2019ve spent some more time maybe making a counterclockwise \u201crotate_board<\/em>\u201d function but I don\u2019t think it makes too<\/strong> much of a difference. I also don\u2019t use for loops<\/span> here because it won\u2019t really save much space compared to just repeating the line over a few times. The direction <\/em>variable is referring to the main function later on where we prompt the user for the move. <\/p>\n<\/div>

\"\"<\/figure><\/div>\n\n\n\n
\"\"<\/figure>
\n

The following 2 functions are going to decide when you lose or win the game. Most of the logic is explained in the comments. As a reminder you lose the game when the following 2 criteria are met:<\/p>\n\n\n\n

    \n
  1. There are no more blank cells on the board<\/li>\n\n\n\n
  2. There are no adjacent cells that you can merge<\/li>\n<\/ol>\n<\/div><\/div>\n\n\n\n
    \"\"<\/figure>
    \n

    This function is much more simple than the loss condition because there\u2019s only one condition that has to be met to win the game\u2014 if your biggest tile is 2048 or more. <\/p>\n<\/div><\/div>\n\n\n\n

    \n

    This main <\/em>function is so big I\u2019m going to split it into 2 images because my screen couldn\u2019t fit the whole function. This is Part 1<\/strong> where the functions handles the input responsible for the board size, printing the board, and the win and loss conditions. You might notice that the score<\/em> variable I mentioned earlier is defined here\u2014 where the actual score is saved. If you really <\/em>like the game and want to play past 2048, the asked_continue<\/em> variable is responsible for letting you do that. If I didn\u2019t make that variable, for every move<\/strong> you do after winning it will prompt you after every move<\/strong> to ask you if you want to continue, which is a hassle if you really want to keep playing. <\/p>\n<\/div>

    \"\"<\/figure><\/div>\n\n\n\n
    \n

    This second part of the main <\/em>function will handle what happens after a move<\/strong>. If you decide to quit it will print how many moves you made. This might be useful in future use cases if for some reason I have to work on this further. It also handles invalid inputs. After that it works on the score, adding a new tile, and increasing the move count. The if statement<\/span> at the end is something I learned a long time ago and don\u2019t really remember what its use is. It might <\/em>be used to only run if it\u2019s the main program in the file, but I\u2019m not sure.<\/p>\n<\/div>

    \"\"<\/figure><\/div>\n\n\n\n

    Links<\/h2>\n\n\n