ComputerCraft Tetris

This project is meant to be used on Computercraft, a Minecraft mod that can be downloaded from curseforge, there is also a desktop adaptation available on computer and mobile, CraftOS-PC.

---

Installing

You can directly clone this repo into the computer's files or run wget run https://raw.githubusercontent.com/ChickChicky/CC_Tetris/main/update.lua (or pastebin run g26ueH22) to launch the installer.

---

Updating

When a new update comes out, when you launch CCTetris this message will be shown:
You can press a key and continue normally or hold Ctrl+T to exit and then type tetris update.
Alternatively, you can type wget run https://raw.githubusercontent.com/ChickChicky/CC_Tetris/main/update.lua which basically does the same thing.

---

Simple guide

Once installed, you can run the tetris command and you will see this:

You can input a name that will be associated with the scores you get, but you can leave it empty if you want.
After pressing Enter, you will see a quick tutorial that shows you the controls, and the tetromino just wraps around when touching the bottom line.

When you press Enter again, you now start playing the real game.

By pressing Return, a menu with 6 "buttons" opens.

• Return to game: just exits out of the menu, same thing as pressing Return again
• Scoreboard: displays all your local scores as well as the configured SS' (look at this for more info)
• Save and exit: saves your score and quits CCTetris, same thing as holding Ctrl+T
• Change session name: nothing really fancy, just asks you a new name
• Set scores server: more info here
• Clear: clears the board and resets your score BUT IT DOES NOT SAVE
• Toggle ghost: toggles the projection of where your piece will land
• Ghost color: allows you to change the color of the ghost

---

Scoring

Earninig points is pretty simple, it can be done by competing lines:

number of lines	points
1	40
2	100
3	300
4	1200

Soft dropping also rewards points, 1 every 20 placed pieces starting from 1
Hard dropping rewards one point per tile moved down

Advanced stuff

Scores Server

A score server allows to store players' scores on a server rather than locally.
Here's an example of a score server written in JS:

const http = require('http');
const fs = require('fs');

function load_db() {
    return JSON.parse(fs.readFileSync('./db.json','utf-8'));
}

const addr = {
    port: 80, // standard HTTP port
    host: 'YOUR-HOST-HERE'
}

let server = http.createServer(function(req,res){
    let url = new URL(req.url,`http://${addr.host}`);
    let pathName = url.pathname;
    
    if (pathName == '/sstetris') {

        let {action,payload} = req.headers;

        res.writeHead(200);

        if (action == 'ping') {
            // just responds to the ping
            res.end(JSON.stringify('pong'));
        }

        if (action == 'get') {
            // returns the scores stored in the DB
            res.end(JSON.stringify(load_db().sstetris??[]));
        }

        if (action == 'save') {
            let dat = JSON.parse(payload); // parses the score data
            let db = load_db(); // loads the DB

            db.sstetris = (db.sstetris??[]).concat(dat); // adds the score to the existing ones

            // writes the DB data back into the file
            fs.writeFileSync('./db.json',JSON.stringify(db));
            res.end(JSON.stringify('OK'));
        }

    }
});

server.listen(addr.port, addr.host, 1, function() {
    console.log('ready');
});

A CCTetris client will only use 3 request types: ping, get, save which are stored in the action header

• ping: this is sent when trying to set the SS in the menu, this is to ensure the server can be joined, it doesn't execpt any particular response, the server just has to respond
• get: this is sent when loading the scores from the scoreboard, it expects the server to respond with an array containing score-like objects
• save: this is sent when the clients wants to register a new score on the server, the score data can be found in the payload header, as a score-like object, no particular response is expected from the server

I hosted a SS on Pythonanywhere at https://chickbot.eu.pythonanywhere.com/sstetris
The name you use will be available to anyone

Score-Like Objects

A score-like object is a JSON object containing data about a score, here are its attributes:

name	type	optionnal ?	description
t	number	no	the timsestamp of when the score has been registered
s	number	no	the score value
n	string	yes	the name of the user who realized the score
u	string	yes	the URL of the server the score was registered at
p	string	yes	the list of all the pieces placed